diff --git a/docs/compute_v1/image_family_views.rst b/docs/compute_v1/image_family_views.rst new file mode 100644 index 000000000..40c73b6a1 --- /dev/null +++ b/docs/compute_v1/image_family_views.rst @@ -0,0 +1,6 @@ +ImageFamilyViews +---------------------------------- + +.. automodule:: google.cloud.compute_v1.services.image_family_views + :members: + :inherited-members: diff --git a/docs/compute_v1/service_attachments.rst b/docs/compute_v1/service_attachments.rst new file mode 100644 index 000000000..07c4e4699 --- /dev/null +++ b/docs/compute_v1/service_attachments.rst @@ -0,0 +1,10 @@ +ServiceAttachments +------------------------------------ + +.. automodule:: google.cloud.compute_v1.services.service_attachments + :members: + :inherited-members: + +.. automodule:: google.cloud.compute_v1.services.service_attachments.pagers + :members: + :inherited-members: diff --git a/docs/compute_v1/services.rst b/docs/compute_v1/services.rst index b3e273977..36161c200 100644 --- a/docs/compute_v1/services.rst +++ b/docs/compute_v1/services.rst @@ -21,6 +21,7 @@ Services for Google Cloud Compute v1 API global_organization_operations global_public_delegated_prefixes health_checks + image_family_views images instance_group_managers instance_groups @@ -64,6 +65,7 @@ Services for Google Cloud Compute v1 API routers routes security_policies + service_attachments snapshots ssl_certificates ssl_policies diff --git a/google/cloud/compute/__init__.py b/google/cloud/compute/__init__.py index 8ba011a2d..8a2948cbf 100644 --- a/google/cloud/compute/__init__.py +++ b/google/cloud/compute/__init__.py @@ -54,6 +54,9 @@ GlobalPublicDelegatedPrefixesClient, ) from google.cloud.compute_v1.services.health_checks.client import HealthChecksClient +from google.cloud.compute_v1.services.image_family_views.client import ( + ImageFamilyViewsClient, +) from google.cloud.compute_v1.services.images.client import ImagesClient from google.cloud.compute_v1.services.instance_group_managers.client import ( InstanceGroupManagersClient, @@ -147,6 +150,9 @@ from google.cloud.compute_v1.services.security_policies.client import ( SecurityPoliciesClient, ) +from google.cloud.compute_v1.services.service_attachments.client import ( + ServiceAttachmentsClient, +) from google.cloud.compute_v1.services.snapshots.client import SnapshotsClient from google.cloud.compute_v1.services.ssl_certificates.client import ( SslCertificatesClient, @@ -245,6 +251,9 @@ from google.cloud.compute_v1.types.compute import AggregatedListReservationsRequest from google.cloud.compute_v1.types.compute import AggregatedListResourcePoliciesRequest from google.cloud.compute_v1.types.compute import AggregatedListRoutersRequest +from google.cloud.compute_v1.types.compute import ( + AggregatedListServiceAttachmentsRequest, +) from google.cloud.compute_v1.types.compute import AggregatedListSslCertificatesRequest from google.cloud.compute_v1.types.compute import AggregatedListSubnetworksRequest from google.cloud.compute_v1.types.compute import AggregatedListTargetHttpProxiesRequest @@ -439,6 +448,7 @@ from google.cloud.compute_v1.types.compute import DeleteRouteRequest from google.cloud.compute_v1.types.compute import DeleteRouterRequest from google.cloud.compute_v1.types.compute import DeleteSecurityPolicyRequest +from google.cloud.compute_v1.types.compute import DeleteServiceAttachmentRequest from google.cloud.compute_v1.types.compute import DeleteSignedUrlKeyBackendBucketRequest from google.cloud.compute_v1.types.compute import ( DeleteSignedUrlKeyBackendServiceRequest, @@ -560,8 +570,10 @@ from google.cloud.compute_v1.types.compute import GetIamPolicyRegionDiskRequest from google.cloud.compute_v1.types.compute import GetIamPolicyReservationRequest from google.cloud.compute_v1.types.compute import GetIamPolicyResourcePolicyRequest +from google.cloud.compute_v1.types.compute import GetIamPolicyServiceAttachmentRequest from google.cloud.compute_v1.types.compute import GetIamPolicySnapshotRequest from google.cloud.compute_v1.types.compute import GetIamPolicySubnetworkRequest +from google.cloud.compute_v1.types.compute import GetImageFamilyViewRequest from google.cloud.compute_v1.types.compute import GetImageRequest from google.cloud.compute_v1.types.compute import GetInstanceGroupManagerRequest from google.cloud.compute_v1.types.compute import GetInstanceGroupRequest @@ -610,6 +622,7 @@ from google.cloud.compute_v1.types.compute import GetScreenshotInstanceRequest from google.cloud.compute_v1.types.compute import GetSecurityPolicyRequest from google.cloud.compute_v1.types.compute import GetSerialPortOutputInstanceRequest +from google.cloud.compute_v1.types.compute import GetServiceAttachmentRequest from google.cloud.compute_v1.types.compute import ( GetShieldedInstanceIdentityInstanceRequest, ) @@ -675,6 +688,7 @@ from google.cloud.compute_v1.types.compute import HttpRouteRuleMatch from google.cloud.compute_v1.types.compute import HTTPSHealthCheck from google.cloud.compute_v1.types.compute import Image +from google.cloud.compute_v1.types.compute import ImageFamilyView from google.cloud.compute_v1.types.compute import ImageList from google.cloud.compute_v1.types.compute import InitialStateConfig from google.cloud.compute_v1.types.compute import InsertAddressRequest @@ -734,6 +748,7 @@ from google.cloud.compute_v1.types.compute import InsertRouteRequest from google.cloud.compute_v1.types.compute import InsertRouterRequest from google.cloud.compute_v1.types.compute import InsertSecurityPolicyRequest +from google.cloud.compute_v1.types.compute import InsertServiceAttachmentRequest from google.cloud.compute_v1.types.compute import InsertSslCertificateRequest from google.cloud.compute_v1.types.compute import InsertSslPolicyRequest from google.cloud.compute_v1.types.compute import InsertSubnetworkRequest @@ -970,6 +985,7 @@ from google.cloud.compute_v1.types.compute import ListRoutersRequest from google.cloud.compute_v1.types.compute import ListRoutesRequest from google.cloud.compute_v1.types.compute import ListSecurityPoliciesRequest +from google.cloud.compute_v1.types.compute import ListServiceAttachmentsRequest from google.cloud.compute_v1.types.compute import ListSnapshotsRequest from google.cloud.compute_v1.types.compute import ListSslCertificatesRequest from google.cloud.compute_v1.types.compute import ListSslPoliciesRequest @@ -1123,6 +1139,7 @@ from google.cloud.compute_v1.types.compute import PatchRuleFirewallPolicyRequest from google.cloud.compute_v1.types.compute import PatchRuleSecurityPolicyRequest from google.cloud.compute_v1.types.compute import PatchSecurityPolicyRequest +from google.cloud.compute_v1.types.compute import PatchServiceAttachmentRequest from google.cloud.compute_v1.types.compute import PatchSslPolicyRequest from google.cloud.compute_v1.types.compute import PatchSubnetworkRequest from google.cloud.compute_v1.types.compute import PatchTargetGrpcProxyRequest @@ -1284,22 +1301,27 @@ from google.cloud.compute_v1.types.compute import ResourcePolicyWeeklyCycle from google.cloud.compute_v1.types.compute import ResourcePolicyWeeklyCycleDayOfWeek from google.cloud.compute_v1.types.compute import Route +from google.cloud.compute_v1.types.compute import RouteAsPath from google.cloud.compute_v1.types.compute import RouteList from google.cloud.compute_v1.types.compute import Router from google.cloud.compute_v1.types.compute import RouterAdvertisedIpRange from google.cloud.compute_v1.types.compute import RouterAggregatedList from google.cloud.compute_v1.types.compute import RouterBgp from google.cloud.compute_v1.types.compute import RouterBgpPeer +from google.cloud.compute_v1.types.compute import RouterBgpPeerBfd from google.cloud.compute_v1.types.compute import RouterInterface from google.cloud.compute_v1.types.compute import RouterList from google.cloud.compute_v1.types.compute import RouterNat from google.cloud.compute_v1.types.compute import RouterNatLogConfig +from google.cloud.compute_v1.types.compute import RouterNatRule +from google.cloud.compute_v1.types.compute import RouterNatRuleAction from google.cloud.compute_v1.types.compute import RouterNatSubnetworkToNat from google.cloud.compute_v1.types.compute import RoutersPreviewResponse from google.cloud.compute_v1.types.compute import RoutersScopedList from google.cloud.compute_v1.types.compute import RouterStatus from google.cloud.compute_v1.types.compute import RouterStatusBgpPeerStatus from google.cloud.compute_v1.types.compute import RouterStatusNatStatus +from google.cloud.compute_v1.types.compute import RouterStatusNatStatusNatRuleStatus from google.cloud.compute_v1.types.compute import RouterStatusResponse from google.cloud.compute_v1.types.compute import Rule from google.cloud.compute_v1.types.compute import ScalingScheduleStatus @@ -1312,15 +1334,30 @@ ) from google.cloud.compute_v1.types.compute import SecurityPoliciesWafConfig from google.cloud.compute_v1.types.compute import SecurityPolicy +from google.cloud.compute_v1.types.compute import SecurityPolicyAdaptiveProtectionConfig +from google.cloud.compute_v1.types.compute import ( + SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig, +) +from google.cloud.compute_v1.types.compute import SecurityPolicyAdvancedOptionsConfig from google.cloud.compute_v1.types.compute import SecurityPolicyList from google.cloud.compute_v1.types.compute import SecurityPolicyReference from google.cloud.compute_v1.types.compute import SecurityPolicyRule from google.cloud.compute_v1.types.compute import SecurityPolicyRuleMatcher from google.cloud.compute_v1.types.compute import SecurityPolicyRuleMatcherConfig from google.cloud.compute_v1.types.compute import SecuritySettings +from google.cloud.compute_v1.types.compute import SendDiagnosticInterruptInstanceRequest +from google.cloud.compute_v1.types.compute import ( + SendDiagnosticInterruptInstanceResponse, +) from google.cloud.compute_v1.types.compute import SerialPortOutput from google.cloud.compute_v1.types.compute import ServerBinding from google.cloud.compute_v1.types.compute import ServiceAccount +from google.cloud.compute_v1.types.compute import ServiceAttachment +from google.cloud.compute_v1.types.compute import ServiceAttachmentAggregatedList +from google.cloud.compute_v1.types.compute import ServiceAttachmentConnectedEndpoint +from google.cloud.compute_v1.types.compute import ServiceAttachmentConsumerProjectLimit +from google.cloud.compute_v1.types.compute import ServiceAttachmentList +from google.cloud.compute_v1.types.compute import ServiceAttachmentsScopedList from google.cloud.compute_v1.types.compute import SetBackendServiceTargetSslProxyRequest from google.cloud.compute_v1.types.compute import SetBackendServiceTargetTcpProxyRequest from google.cloud.compute_v1.types.compute import SetBackupTargetPoolRequest @@ -1341,6 +1378,7 @@ from google.cloud.compute_v1.types.compute import SetIamPolicyRegionDiskRequest from google.cloud.compute_v1.types.compute import SetIamPolicyReservationRequest from google.cloud.compute_v1.types.compute import SetIamPolicyResourcePolicyRequest +from google.cloud.compute_v1.types.compute import SetIamPolicyServiceAttachmentRequest from google.cloud.compute_v1.types.compute import SetIamPolicySnapshotRequest from google.cloud.compute_v1.types.compute import SetIamPolicySubnetworkRequest from google.cloud.compute_v1.types.compute import ( @@ -1446,6 +1484,7 @@ from google.cloud.compute_v1.types.compute import ( SubnetworksSetPrivateIpGoogleAccessRequest, ) +from google.cloud.compute_v1.types.compute import Subsetting from google.cloud.compute_v1.types.compute import SwitchToCustomModeNetworkRequest from google.cloud.compute_v1.types.compute import Tags from google.cloud.compute_v1.types.compute import TargetGrpcProxy @@ -1526,11 +1565,15 @@ from google.cloud.compute_v1.types.compute import ( TestIamPermissionsResourcePolicyRequest, ) +from google.cloud.compute_v1.types.compute import ( + TestIamPermissionsServiceAttachmentRequest, +) from google.cloud.compute_v1.types.compute import TestIamPermissionsSnapshotRequest from google.cloud.compute_v1.types.compute import TestIamPermissionsSubnetworkRequest from google.cloud.compute_v1.types.compute import TestIamPermissionsVpnGatewayRequest from google.cloud.compute_v1.types.compute import TestPermissionsRequest from google.cloud.compute_v1.types.compute import TestPermissionsResponse +from google.cloud.compute_v1.types.compute import Uint128 from google.cloud.compute_v1.types.compute import UpdateAccessConfigInstanceRequest from google.cloud.compute_v1.types.compute import UpdateAutoscalerRequest from google.cloud.compute_v1.types.compute import UpdateBackendBucketRequest @@ -1628,6 +1671,7 @@ "GlobalOrganizationOperationsClient", "GlobalPublicDelegatedPrefixesClient", "HealthChecksClient", + "ImageFamilyViewsClient", "ImagesClient", "InstanceGroupManagersClient", "InstanceGroupsClient", @@ -1671,6 +1715,7 @@ "RoutersClient", "RoutesClient", "SecurityPoliciesClient", + "ServiceAttachmentsClient", "SnapshotsClient", "SslCertificatesClient", "SslPoliciesClient", @@ -1740,6 +1785,7 @@ "AggregatedListReservationsRequest", "AggregatedListResourcePoliciesRequest", "AggregatedListRoutersRequest", + "AggregatedListServiceAttachmentsRequest", "AggregatedListSslCertificatesRequest", "AggregatedListSubnetworksRequest", "AggregatedListTargetHttpProxiesRequest", @@ -1878,6 +1924,7 @@ "DeleteRouteRequest", "DeleteRouterRequest", "DeleteSecurityPolicyRequest", + "DeleteServiceAttachmentRequest", "DeleteSignedUrlKeyBackendBucketRequest", "DeleteSignedUrlKeyBackendServiceRequest", "DeleteSnapshotRequest", @@ -1989,8 +2036,10 @@ "GetIamPolicyRegionDiskRequest", "GetIamPolicyReservationRequest", "GetIamPolicyResourcePolicyRequest", + "GetIamPolicyServiceAttachmentRequest", "GetIamPolicySnapshotRequest", "GetIamPolicySubnetworkRequest", + "GetImageFamilyViewRequest", "GetImageRequest", "GetInstanceGroupManagerRequest", "GetInstanceGroupRequest", @@ -2039,6 +2088,7 @@ "GetScreenshotInstanceRequest", "GetSecurityPolicyRequest", "GetSerialPortOutputInstanceRequest", + "GetServiceAttachmentRequest", "GetShieldedInstanceIdentityInstanceRequest", "GetSnapshotRequest", "GetSslCertificateRequest", @@ -2098,6 +2148,7 @@ "HttpRouteRuleMatch", "HTTPSHealthCheck", "Image", + "ImageFamilyView", "ImageList", "InitialStateConfig", "InsertAddressRequest", @@ -2147,6 +2198,7 @@ "InsertRouteRequest", "InsertRouterRequest", "InsertSecurityPolicyRequest", + "InsertServiceAttachmentRequest", "InsertSslCertificateRequest", "InsertSslPolicyRequest", "InsertSubnetworkRequest", @@ -2321,6 +2373,7 @@ "ListRoutersRequest", "ListRoutesRequest", "ListSecurityPoliciesRequest", + "ListServiceAttachmentsRequest", "ListSnapshotsRequest", "ListSslCertificatesRequest", "ListSslPoliciesRequest", @@ -2454,6 +2507,7 @@ "PatchRuleFirewallPolicyRequest", "PatchRuleSecurityPolicyRequest", "PatchSecurityPolicyRequest", + "PatchServiceAttachmentRequest", "PatchSslPolicyRequest", "PatchSubnetworkRequest", "PatchTargetGrpcProxyRequest", @@ -2559,22 +2613,27 @@ "ResourcePolicyWeeklyCycle", "ResourcePolicyWeeklyCycleDayOfWeek", "Route", + "RouteAsPath", "RouteList", "Router", "RouterAdvertisedIpRange", "RouterAggregatedList", "RouterBgp", "RouterBgpPeer", + "RouterBgpPeerBfd", "RouterInterface", "RouterList", "RouterNat", "RouterNatLogConfig", + "RouterNatRule", + "RouterNatRuleAction", "RouterNatSubnetworkToNat", "RoutersPreviewResponse", "RoutersScopedList", "RouterStatus", "RouterStatusBgpPeerStatus", "RouterStatusNatStatus", + "RouterStatusNatStatusNatRuleStatus", "RouterStatusResponse", "Rule", "ScalingScheduleStatus", @@ -2585,15 +2644,26 @@ "SecurityPoliciesListPreconfiguredExpressionSetsResponse", "SecurityPoliciesWafConfig", "SecurityPolicy", + "SecurityPolicyAdaptiveProtectionConfig", + "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig", + "SecurityPolicyAdvancedOptionsConfig", "SecurityPolicyList", "SecurityPolicyReference", "SecurityPolicyRule", "SecurityPolicyRuleMatcher", "SecurityPolicyRuleMatcherConfig", "SecuritySettings", + "SendDiagnosticInterruptInstanceRequest", + "SendDiagnosticInterruptInstanceResponse", "SerialPortOutput", "ServerBinding", "ServiceAccount", + "ServiceAttachment", + "ServiceAttachmentAggregatedList", + "ServiceAttachmentConnectedEndpoint", + "ServiceAttachmentConsumerProjectLimit", + "ServiceAttachmentList", + "ServiceAttachmentsScopedList", "SetBackendServiceTargetSslProxyRequest", "SetBackendServiceTargetTcpProxyRequest", "SetBackupTargetPoolRequest", @@ -2612,6 +2682,7 @@ "SetIamPolicyRegionDiskRequest", "SetIamPolicyReservationRequest", "SetIamPolicyResourcePolicyRequest", + "SetIamPolicyServiceAttachmentRequest", "SetIamPolicySnapshotRequest", "SetIamPolicySubnetworkRequest", "SetInstanceTemplateInstanceGroupManagerRequest", @@ -2689,6 +2760,7 @@ "SubnetworksExpandIpCidrRangeRequest", "SubnetworksScopedList", "SubnetworksSetPrivateIpGoogleAccessRequest", + "Subsetting", "SwitchToCustomModeNetworkRequest", "Tags", "TargetGrpcProxy", @@ -2747,11 +2819,13 @@ "TestIamPermissionsRegionDiskRequest", "TestIamPermissionsReservationRequest", "TestIamPermissionsResourcePolicyRequest", + "TestIamPermissionsServiceAttachmentRequest", "TestIamPermissionsSnapshotRequest", "TestIamPermissionsSubnetworkRequest", "TestIamPermissionsVpnGatewayRequest", "TestPermissionsRequest", "TestPermissionsResponse", + "Uint128", "UpdateAccessConfigInstanceRequest", "UpdateAutoscalerRequest", "UpdateBackendBucketRequest", diff --git a/google/cloud/compute_v1/__init__.py b/google/cloud/compute_v1/__init__.py index f1e24b94a..8018578fd 100644 --- a/google/cloud/compute_v1/__init__.py +++ b/google/cloud/compute_v1/__init__.py @@ -34,6 +34,7 @@ GlobalPublicDelegatedPrefixesClient, ) from .services.health_checks import HealthChecksClient +from .services.image_family_views import ImageFamilyViewsClient from .services.images import ImagesClient from .services.instance_group_managers import InstanceGroupManagersClient from .services.instance_groups import InstanceGroupsClient @@ -77,6 +78,7 @@ from .services.routers import RoutersClient from .services.routes import RoutesClient from .services.security_policies import SecurityPoliciesClient +from .services.service_attachments import ServiceAttachmentsClient from .services.snapshots import SnapshotsClient from .services.ssl_certificates import SslCertificatesClient from .services.ssl_policies import SslPoliciesClient @@ -147,6 +149,7 @@ from .types.compute import AggregatedListReservationsRequest from .types.compute import AggregatedListResourcePoliciesRequest from .types.compute import AggregatedListRoutersRequest +from .types.compute import AggregatedListServiceAttachmentsRequest from .types.compute import AggregatedListSslCertificatesRequest from .types.compute import AggregatedListSubnetworksRequest from .types.compute import AggregatedListTargetHttpProxiesRequest @@ -287,6 +290,7 @@ from .types.compute import DeleteRouteRequest from .types.compute import DeleteRouterRequest from .types.compute import DeleteSecurityPolicyRequest +from .types.compute import DeleteServiceAttachmentRequest from .types.compute import DeleteSignedUrlKeyBackendBucketRequest from .types.compute import DeleteSignedUrlKeyBackendServiceRequest from .types.compute import DeleteSnapshotRequest @@ -398,8 +402,10 @@ from .types.compute import GetIamPolicyRegionDiskRequest from .types.compute import GetIamPolicyReservationRequest from .types.compute import GetIamPolicyResourcePolicyRequest +from .types.compute import GetIamPolicyServiceAttachmentRequest from .types.compute import GetIamPolicySnapshotRequest from .types.compute import GetIamPolicySubnetworkRequest +from .types.compute import GetImageFamilyViewRequest from .types.compute import GetImageRequest from .types.compute import GetInstanceGroupManagerRequest from .types.compute import GetInstanceGroupRequest @@ -448,6 +454,7 @@ from .types.compute import GetScreenshotInstanceRequest from .types.compute import GetSecurityPolicyRequest from .types.compute import GetSerialPortOutputInstanceRequest +from .types.compute import GetServiceAttachmentRequest from .types.compute import GetShieldedInstanceIdentityInstanceRequest from .types.compute import GetSnapshotRequest from .types.compute import GetSslCertificateRequest @@ -507,6 +514,7 @@ from .types.compute import HttpRouteRuleMatch from .types.compute import HTTPSHealthCheck from .types.compute import Image +from .types.compute import ImageFamilyView from .types.compute import ImageList from .types.compute import InitialStateConfig from .types.compute import InsertAddressRequest @@ -556,6 +564,7 @@ from .types.compute import InsertRouteRequest from .types.compute import InsertRouterRequest from .types.compute import InsertSecurityPolicyRequest +from .types.compute import InsertServiceAttachmentRequest from .types.compute import InsertSslCertificateRequest from .types.compute import InsertSslPolicyRequest from .types.compute import InsertSubnetworkRequest @@ -730,6 +739,7 @@ from .types.compute import ListRoutersRequest from .types.compute import ListRoutesRequest from .types.compute import ListSecurityPoliciesRequest +from .types.compute import ListServiceAttachmentsRequest from .types.compute import ListSnapshotsRequest from .types.compute import ListSslCertificatesRequest from .types.compute import ListSslPoliciesRequest @@ -863,6 +873,7 @@ from .types.compute import PatchRuleFirewallPolicyRequest from .types.compute import PatchRuleSecurityPolicyRequest from .types.compute import PatchSecurityPolicyRequest +from .types.compute import PatchServiceAttachmentRequest from .types.compute import PatchSslPolicyRequest from .types.compute import PatchSubnetworkRequest from .types.compute import PatchTargetGrpcProxyRequest @@ -968,22 +979,27 @@ from .types.compute import ResourcePolicyWeeklyCycle from .types.compute import ResourcePolicyWeeklyCycleDayOfWeek from .types.compute import Route +from .types.compute import RouteAsPath from .types.compute import RouteList from .types.compute import Router from .types.compute import RouterAdvertisedIpRange from .types.compute import RouterAggregatedList from .types.compute import RouterBgp from .types.compute import RouterBgpPeer +from .types.compute import RouterBgpPeerBfd from .types.compute import RouterInterface from .types.compute import RouterList from .types.compute import RouterNat from .types.compute import RouterNatLogConfig +from .types.compute import RouterNatRule +from .types.compute import RouterNatRuleAction from .types.compute import RouterNatSubnetworkToNat from .types.compute import RoutersPreviewResponse from .types.compute import RoutersScopedList from .types.compute import RouterStatus from .types.compute import RouterStatusBgpPeerStatus from .types.compute import RouterStatusNatStatus +from .types.compute import RouterStatusNatStatusNatRuleStatus from .types.compute import RouterStatusResponse from .types.compute import Rule from .types.compute import ScalingScheduleStatus @@ -994,15 +1010,26 @@ from .types.compute import SecurityPoliciesListPreconfiguredExpressionSetsResponse from .types.compute import SecurityPoliciesWafConfig from .types.compute import SecurityPolicy +from .types.compute import SecurityPolicyAdaptiveProtectionConfig +from .types.compute import SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig +from .types.compute import SecurityPolicyAdvancedOptionsConfig from .types.compute import SecurityPolicyList from .types.compute import SecurityPolicyReference from .types.compute import SecurityPolicyRule from .types.compute import SecurityPolicyRuleMatcher from .types.compute import SecurityPolicyRuleMatcherConfig from .types.compute import SecuritySettings +from .types.compute import SendDiagnosticInterruptInstanceRequest +from .types.compute import SendDiagnosticInterruptInstanceResponse from .types.compute import SerialPortOutput from .types.compute import ServerBinding from .types.compute import ServiceAccount +from .types.compute import ServiceAttachment +from .types.compute import ServiceAttachmentAggregatedList +from .types.compute import ServiceAttachmentConnectedEndpoint +from .types.compute import ServiceAttachmentConsumerProjectLimit +from .types.compute import ServiceAttachmentList +from .types.compute import ServiceAttachmentsScopedList from .types.compute import SetBackendServiceTargetSslProxyRequest from .types.compute import SetBackendServiceTargetTcpProxyRequest from .types.compute import SetBackupTargetPoolRequest @@ -1021,6 +1048,7 @@ from .types.compute import SetIamPolicyRegionDiskRequest from .types.compute import SetIamPolicyReservationRequest from .types.compute import SetIamPolicyResourcePolicyRequest +from .types.compute import SetIamPolicyServiceAttachmentRequest from .types.compute import SetIamPolicySnapshotRequest from .types.compute import SetIamPolicySubnetworkRequest from .types.compute import SetInstanceTemplateInstanceGroupManagerRequest @@ -1098,6 +1126,7 @@ from .types.compute import SubnetworksExpandIpCidrRangeRequest from .types.compute import SubnetworksScopedList from .types.compute import SubnetworksSetPrivateIpGoogleAccessRequest +from .types.compute import Subsetting from .types.compute import SwitchToCustomModeNetworkRequest from .types.compute import Tags from .types.compute import TargetGrpcProxy @@ -1156,11 +1185,13 @@ from .types.compute import TestIamPermissionsRegionDiskRequest from .types.compute import TestIamPermissionsReservationRequest from .types.compute import TestIamPermissionsResourcePolicyRequest +from .types.compute import TestIamPermissionsServiceAttachmentRequest from .types.compute import TestIamPermissionsSnapshotRequest from .types.compute import TestIamPermissionsSubnetworkRequest from .types.compute import TestIamPermissionsVpnGatewayRequest from .types.compute import TestPermissionsRequest from .types.compute import TestPermissionsResponse +from .types.compute import Uint128 from .types.compute import UpdateAccessConfigInstanceRequest from .types.compute import UpdateAutoscalerRequest from .types.compute import UpdateBackendBucketRequest @@ -1284,6 +1315,7 @@ "AggregatedListReservationsRequest", "AggregatedListResourcePoliciesRequest", "AggregatedListRoutersRequest", + "AggregatedListServiceAttachmentsRequest", "AggregatedListSslCertificatesRequest", "AggregatedListSubnetworksRequest", "AggregatedListTargetHttpProxiesRequest", @@ -1425,6 +1457,7 @@ "DeleteRouteRequest", "DeleteRouterRequest", "DeleteSecurityPolicyRequest", + "DeleteServiceAttachmentRequest", "DeleteSignedUrlKeyBackendBucketRequest", "DeleteSignedUrlKeyBackendServiceRequest", "DeleteSnapshotRequest", @@ -1543,8 +1576,10 @@ "GetIamPolicyRegionDiskRequest", "GetIamPolicyReservationRequest", "GetIamPolicyResourcePolicyRequest", + "GetIamPolicyServiceAttachmentRequest", "GetIamPolicySnapshotRequest", "GetIamPolicySubnetworkRequest", + "GetImageFamilyViewRequest", "GetImageRequest", "GetInstanceGroupManagerRequest", "GetInstanceGroupRequest", @@ -1593,6 +1628,7 @@ "GetScreenshotInstanceRequest", "GetSecurityPolicyRequest", "GetSerialPortOutputInstanceRequest", + "GetServiceAttachmentRequest", "GetShieldedInstanceIdentityInstanceRequest", "GetSnapshotRequest", "GetSslCertificateRequest", @@ -1658,6 +1694,8 @@ "HttpRouteRule", "HttpRouteRuleMatch", "Image", + "ImageFamilyView", + "ImageFamilyViewsClient", "ImageList", "ImagesClient", "InitialStateConfig", @@ -1708,6 +1746,7 @@ "InsertRouteRequest", "InsertRouterRequest", "InsertSecurityPolicyRequest", + "InsertServiceAttachmentRequest", "InsertSslCertificateRequest", "InsertSslPolicyRequest", "InsertSubnetworkRequest", @@ -1891,6 +1930,7 @@ "ListRoutersRequest", "ListRoutesRequest", "ListSecurityPoliciesRequest", + "ListServiceAttachmentsRequest", "ListSnapshotsRequest", "ListSslCertificatesRequest", "ListSslPoliciesRequest", @@ -2031,6 +2071,7 @@ "PatchRuleFirewallPolicyRequest", "PatchRuleSecurityPolicyRequest", "PatchSecurityPolicyRequest", + "PatchServiceAttachmentRequest", "PatchSslPolicyRequest", "PatchSubnetworkRequest", "PatchTargetGrpcProxyRequest", @@ -2159,20 +2200,25 @@ "ResourcePolicyWeeklyCycle", "ResourcePolicyWeeklyCycleDayOfWeek", "Route", + "RouteAsPath", "RouteList", "Router", "RouterAdvertisedIpRange", "RouterAggregatedList", "RouterBgp", "RouterBgpPeer", + "RouterBgpPeerBfd", "RouterInterface", "RouterList", "RouterNat", "RouterNatLogConfig", + "RouterNatRule", + "RouterNatRuleAction", "RouterNatSubnetworkToNat", "RouterStatus", "RouterStatusBgpPeerStatus", "RouterStatusNatStatus", + "RouterStatusNatStatusNatRuleStatus", "RouterStatusResponse", "RoutersClient", "RoutersPreviewResponse", @@ -2189,15 +2235,27 @@ "SecurityPoliciesListPreconfiguredExpressionSetsResponse", "SecurityPoliciesWafConfig", "SecurityPolicy", + "SecurityPolicyAdaptiveProtectionConfig", + "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig", + "SecurityPolicyAdvancedOptionsConfig", "SecurityPolicyList", "SecurityPolicyReference", "SecurityPolicyRule", "SecurityPolicyRuleMatcher", "SecurityPolicyRuleMatcherConfig", "SecuritySettings", + "SendDiagnosticInterruptInstanceRequest", + "SendDiagnosticInterruptInstanceResponse", "SerialPortOutput", "ServerBinding", "ServiceAccount", + "ServiceAttachment", + "ServiceAttachmentAggregatedList", + "ServiceAttachmentConnectedEndpoint", + "ServiceAttachmentConsumerProjectLimit", + "ServiceAttachmentList", + "ServiceAttachmentsClient", + "ServiceAttachmentsScopedList", "SetBackendServiceTargetSslProxyRequest", "SetBackendServiceTargetTcpProxyRequest", "SetBackupTargetPoolRequest", @@ -2216,6 +2274,7 @@ "SetIamPolicyRegionDiskRequest", "SetIamPolicyReservationRequest", "SetIamPolicyResourcePolicyRequest", + "SetIamPolicyServiceAttachmentRequest", "SetIamPolicySnapshotRequest", "SetIamPolicySubnetworkRequest", "SetInstanceTemplateInstanceGroupManagerRequest", @@ -2296,6 +2355,7 @@ "SubnetworksExpandIpCidrRangeRequest", "SubnetworksScopedList", "SubnetworksSetPrivateIpGoogleAccessRequest", + "Subsetting", "SwitchToCustomModeNetworkRequest", "TCPHealthCheck", "Tags", @@ -2362,11 +2422,13 @@ "TestIamPermissionsRegionDiskRequest", "TestIamPermissionsReservationRequest", "TestIamPermissionsResourcePolicyRequest", + "TestIamPermissionsServiceAttachmentRequest", "TestIamPermissionsSnapshotRequest", "TestIamPermissionsSubnetworkRequest", "TestIamPermissionsVpnGatewayRequest", "TestPermissionsRequest", "TestPermissionsResponse", + "Uint128", "UpdateAccessConfigInstanceRequest", "UpdateAutoscalerRequest", "UpdateBackendBucketRequest", diff --git a/google/cloud/compute_v1/gapic_metadata.json b/google/cloud/compute_v1/gapic_metadata.json index 21f94ce14..f3a3c57c6 100644 --- a/google/cloud/compute_v1/gapic_metadata.json +++ b/google/cloud/compute_v1/gapic_metadata.json @@ -797,6 +797,20 @@ } } }, + "ImageFamilyViews": { + "clients": { + "rest": { + "libraryClient": "ImageFamilyViewsClient", + "rpcs": { + "Get": { + "methods": [ + "get" + ] + } + } + } + } + }, "Images": { "clients": { "rest": { @@ -1173,6 +1187,11 @@ "reset" ] }, + "SendDiagnosticInterrupt": { + "methods": [ + "send_diagnostic_interrupt" + ] + }, "SetDeletionProtection": { "methods": [ "set_deletion_protection" @@ -2849,6 +2868,60 @@ } } }, + "ServiceAttachments": { + "clients": { + "rest": { + "libraryClient": "ServiceAttachmentsClient", + "rpcs": { + "AggregatedList": { + "methods": [ + "aggregated_list" + ] + }, + "Delete": { + "methods": [ + "delete" + ] + }, + "Get": { + "methods": [ + "get" + ] + }, + "GetIamPolicy": { + "methods": [ + "get_iam_policy" + ] + }, + "Insert": { + "methods": [ + "insert" + ] + }, + "List": { + "methods": [ + "list" + ] + }, + "Patch": { + "methods": [ + "patch" + ] + }, + "SetIamPolicy": { + "methods": [ + "set_iam_policy" + ] + }, + "TestIamPermissions": { + "methods": [ + "test_iam_permissions" + ] + } + } + } + } + }, "Snapshots": { "clients": { "rest": { diff --git a/google/cloud/compute_v1/services/accelerator_types/client.py b/google/cloud/compute_v1/services/accelerator_types/client.py index 0ea76250b..fd4e6ecd5 100644 --- a/google/cloud/compute_v1/services/accelerator_types/client.py +++ b/google/cloud/compute_v1/services/accelerator_types/client.py @@ -446,14 +446,14 @@ def get( Returns: google.cloud.compute_v1.types.AcceleratorType: - Represents an Accelerator Type resource. - - Google Cloud Platform provides graphics processing - units (accelerators) that you can add to VM instances - to improve or accelerate performance when working - with intensive workloads. For more information, read - GPUs on Compute Engine. (== resource_for - {$api_version}.acceleratorTypes ==) + Represents an Accelerator Type + resource. Google Cloud Platform provides + graphics processing units (accelerators) + that you can add to VM instances to + improve or accelerate performance when + working with intensive workloads. For + more information, read GPUs on Compute + Engine. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/accelerator_types/transports/rest.py b/google/cloud/compute_v1/services/accelerator_types/transports/rest.py index 65478651d..55cad881c 100644 --- a/google/cloud/compute_v1/services/accelerator_types/transports/rest.py +++ b/google/cloud/compute_v1/services/accelerator_types/transports/rest.py @@ -180,14 +180,14 @@ def get( Returns: ~.compute.AcceleratorType: - Represents an Accelerator Type resource. - - Google Cloud Platform provides graphics processing units - (accelerators) that you can add to VM instances to - improve or accelerate performance when working with - intensive workloads. For more information, read GPUs on - Compute Engine. (== resource_for - {$api_version}.acceleratorTypes ==) + Represents an Accelerator Type + resource. Google Cloud Platform provides + graphics processing units (accelerators) + that you can add to VM instances to + improve or accelerate performance when + working with intensive workloads. For + more information, read GPUs on Compute + Engine. """ diff --git a/google/cloud/compute_v1/services/addresses/client.py b/google/cloud/compute_v1/services/addresses/client.py index efdedd095..90cb18e50 100644 --- a/google/cloud/compute_v1/services/addresses/client.py +++ b/google/cloud/compute_v1/services/addresses/client.py @@ -440,31 +440,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -544,35 +534,13 @@ def get( Returns: google.cloud.compute_v1.types.Address: - Use global external addresses for GFE-based external - HTTP(S) load balancers in Premium Tier. - - Use global internal addresses for reserved peering - network range. - - Use regional external addresses for the following - resources: - - - External IP addresses for VM instances - Regional - external forwarding rules - Cloud NAT external IP - addresses - GFE based LBs in Standard Tier - - Network LBs in Premium or Standard Tier - Cloud - VPN gateways (both Classic and HA) - - Use regional internal IP addresses for subnet IP - ranges (primary and secondary). This includes: - - - Internal IP addresses for VM instances - Alias IP - ranges of VM instances (/32 only) - Regional - internal forwarding rules - Internal TCP/UDP load - balancer addresses - Internal HTTP(S) load - balancer addresses - Cloud DNS inbound forwarding - IP addresses - - For more information, read reserved IP address. - - (== resource_for {$api_version}.addresses ==) (== - resource_for {$api_version}.globalAddresses ==) + Represents an IP Address resource. Google Compute Engine + has two IP Address resources: \* [Global (external and + internal)](\ https://cloud.google.com/compute/docs/reference/rest/v1/globalAddresses) + \* [Regional (external and + internal)](\ https://cloud.google.com/compute/docs/reference/rest/v1/addresses) + For more information, see Reserving a static external IP + address. """ # Create or coerce a protobuf request object. @@ -652,31 +620,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/addresses/transports/rest.py b/google/cloud/compute_v1/services/addresses/transports/rest.py index f059a5498..c6f087254 100644 --- a/google/cloud/compute_v1/services/addresses/transports/rest.py +++ b/google/cloud/compute_v1/services/addresses/transports/rest.py @@ -176,34 +176,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -253,34 +240,13 @@ def get( Returns: ~.compute.Address: - Use global external addresses for GFE-based external - HTTP(S) load balancers in Premium Tier. - - Use global internal addresses for reserved peering - network range. - - Use regional external addresses for the following - resources: - - - External IP addresses for VM instances - Regional - external forwarding rules - Cloud NAT external IP - addresses - GFE based LBs in Standard Tier - Network - LBs in Premium or Standard Tier - Cloud VPN gateways - (both Classic and HA) - - Use regional internal IP addresses for subnet IP ranges - (primary and secondary). This includes: - - - Internal IP addresses for VM instances - Alias IP - ranges of VM instances (/32 only) - Regional internal - forwarding rules - Internal TCP/UDP load balancer - addresses - Internal HTTP(S) load balancer addresses - - Cloud DNS inbound forwarding IP addresses - - For more information, read reserved IP address. - - (== resource_for {$api_version}.addresses ==) (== - resource_for {$api_version}.globalAddresses ==) + Represents an IP Address resource. Google Compute Engine + has two IP Address resources: \* `Global (external and + internal) `__ + \* `Regional (external and + internal) `__ + For more information, see Reserving a static external IP + address. """ @@ -329,34 +295,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/autoscalers/client.py b/google/cloud/compute_v1/services/autoscalers/client.py index 6345f503b..704af68ae 100644 --- a/google/cloud/compute_v1/services/autoscalers/client.py +++ b/google/cloud/compute_v1/services/autoscalers/client.py @@ -438,31 +438,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -542,26 +532,17 @@ def get( Returns: google.cloud.compute_v1.types.Autoscaler: - Represents an Autoscaler resource. - - Google Compute Engine has two Autoscaler resources: - - - [Zonal](/compute/docs/reference/rest/{$api_version}/autoscalers) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionAutoscalers) - - Use autoscalers to automatically add or delete - instances from a managed instance group according to - your defined autoscaling policy. For more - information, read Autoscaling Groups of Instances. - - For zonal managed instance groups resource, use the - autoscaler resource. - - For regional managed instance groups, use the - regionAutoscalers resource. (== resource_for - {$api_version}.autoscalers ==) (== resource_for - {$api_version}.regionAutoscalers ==) + Represents an Autoscaler resource. Google Compute Engine + has two Autoscaler resources: \* + [Zonal](/compute/docs/reference/rest/v1/autoscalers) \* + [Regional](/compute/docs/reference/rest/v1/regionAutoscalers) + Use autoscalers to automatically add or delete instances + from a managed instance group according to your defined + autoscaling policy. For more information, read + Autoscaling Groups of Instances. For zonal managed + instance groups resource, use the autoscaler resource. + For regional managed instance groups, use the + regionAutoscalers resource. """ # Create or coerce a protobuf request object. @@ -641,31 +622,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -829,31 +800,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -933,31 +894,21 @@ def update( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/autoscalers/transports/rest.py b/google/cloud/compute_v1/services/autoscalers/transports/rest.py index 2e6d2a61e..44eb6bf83 100644 --- a/google/cloud/compute_v1/services/autoscalers/transports/rest.py +++ b/google/cloud/compute_v1/services/autoscalers/transports/rest.py @@ -176,34 +176,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -254,26 +241,18 @@ def get( Returns: ~.compute.Autoscaler: - Represents an Autoscaler resource. - - Google Compute Engine has two Autoscaler resources: - - - `Zonal `__ - \* - `Regional `__ - + Represents an Autoscaler resource. Google Compute Engine + has two Autoscaler resources: \* + `Zonal `__ + \* + `Regional `__ Use autoscalers to automatically add or delete instances from a managed instance group according to your defined autoscaling policy. For more information, read - Autoscaling Groups of Instances. - - For zonal managed instance groups resource, use the - autoscaler resource. - + Autoscaling Groups of Instances. For zonal managed + instance groups resource, use the autoscaler resource. For regional managed instance groups, use the - regionAutoscalers resource. (== resource_for - {$api_version}.autoscalers ==) (== resource_for - {$api_version}.regionAutoscalers ==) + regionAutoscalers resource. """ @@ -324,34 +303,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -467,34 +433,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -553,34 +506,21 @@ def update( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/backend_buckets/client.py b/google/cloud/compute_v1/services/backend_buckets/client.py index 0128d553f..7c8cda7ae 100644 --- a/google/cloud/compute_v1/services/backend_buckets/client.py +++ b/google/cloud/compute_v1/services/backend_buckets/client.py @@ -374,31 +374,21 @@ def add_signed_url_key( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -473,31 +463,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -581,31 +561,21 @@ def delete_signed_url_key( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -683,11 +653,10 @@ def get( Returns: google.cloud.compute_v1.types.BackendBucket: Represents a Cloud Storage Bucket - resource. - This Cloud Storage bucket resource is - referenced by a URL map of a load - balancer. For more information, read - Backend Buckets. + resource. This Cloud Storage bucket + resource is referenced by a URL map of a + load balancer. For more information, + read Backend Buckets. """ # Create or coerce a protobuf request object. @@ -759,31 +728,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -939,31 +898,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1045,31 +994,21 @@ def update( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/backend_buckets/transports/rest.py b/google/cloud/compute_v1/services/backend_buckets/transports/rest.py index 0c4cc8179..2dc0343ca 100644 --- a/google/cloud/compute_v1/services/backend_buckets/transports/rest.py +++ b/google/cloud/compute_v1/services/backend_buckets/transports/rest.py @@ -117,34 +117,21 @@ def add_signed_url_key( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -203,34 +190,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -280,34 +254,21 @@ def delete_signed_url_key( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -359,11 +320,10 @@ def get( Returns: ~.compute.BackendBucket: Represents a Cloud Storage Bucket - resource. - This Cloud Storage bucket resource is - referenced by a URL map of a load - balancer. For more information, read - Backend Buckets. + resource. This Cloud Storage bucket + resource is referenced by a URL map of a + load balancer. For more information, + read Backend Buckets. """ @@ -413,34 +373,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -556,34 +503,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -642,34 +576,21 @@ def update( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/backend_services/client.py b/google/cloud/compute_v1/services/backend_services/client.py index 9728a93e7..dfa8b4528 100644 --- a/google/cloud/compute_v1/services/backend_services/client.py +++ b/google/cloud/compute_v1/services/backend_services/client.py @@ -374,31 +374,21 @@ def add_signed_url_key( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -549,31 +539,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -657,31 +637,21 @@ def delete_signed_url_key( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -757,28 +727,21 @@ def get( Returns: google.cloud.compute_v1.types.BackendService: - Represents a Backend Service resource. - - A backend service defines how Google Cloud load - balancers distribute traffic. The backend service - configuration contains a set of values, such as the - protocol used to connect to backends, various - distribution and session settings, health checks, and - timeouts. These settings provide fine-grained control - over how your load balancer behaves. Most of the - settings have default values that allow for easy - configuration if you need to get started quickly. - - Backend services in Google Compute Engine can be - either regionally or globally scoped. - - - [Global](/compute/docs/reference/rest/{$api_version}/backendServices) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionBackendServices) - - For more information, see Backend Services. - - (== resource_for {$api_version}.backendService ==) + Represents a Backend Service resource. A backend service + defines how Google Cloud load balancers distribute + traffic. The backend service configuration contains a + set of values, such as the protocol used to connect to + backends, various distribution and session settings, + health checks, and timeouts. These settings provide + fine-grained control over how your load balancer + behaves. Most of the settings have default values that + allow for easy configuration if you need to get started + quickly. Backend services in Google Compute Engine can + be either regionally or globally scoped. \* + [Global](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices) + \* + [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices) + For more information, see Backend Services. """ # Create or coerce a protobuf request object. @@ -826,11 +789,8 @@ def get_health( metadata: Sequence[Tuple[str, str]] = (), ) -> compute.BackendServiceGroupHealth: r"""Gets the most recent health check results for this - BackendService. - Example request body: - - { "group": "/zones/us-east1-b/instanceGroups/lb-backend- - example" } + BackendService. Example request body: { "group": + "/zones/us-east1-b/instanceGroups/lb-backend-example" } Args: request (google.cloud.compute_v1.types.GetHealthBackendServiceRequest): @@ -915,7 +875,7 @@ def insert( ) -> compute.Operation: r"""Creates a BackendService resource in the specified project using the data included in the request. For more - information, see Backend services overview. + information, see Backend services overview . Args: request (google.cloud.compute_v1.types.InsertBackendServiceRequest): @@ -940,31 +900,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1087,7 +1037,7 @@ def patch( ) -> compute.Operation: r"""Patches the specified BackendService resource with the data included in the request. For more information, - see Backend services overview. This method supports + see Backend services overview. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. @@ -1121,31 +1071,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1229,31 +1169,21 @@ def set_security_policy( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1340,31 +1270,21 @@ def update( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/backend_services/transports/rest.py b/google/cloud/compute_v1/services/backend_services/transports/rest.py index 842d610aa..816726809 100644 --- a/google/cloud/compute_v1/services/backend_services/transports/rest.py +++ b/google/cloud/compute_v1/services/backend_services/transports/rest.py @@ -117,34 +117,21 @@ def add_signed_url_key( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -267,34 +254,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -344,34 +318,21 @@ def delete_signed_url_key( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -422,29 +383,22 @@ def get( Returns: ~.compute.BackendService: - Represents a Backend Service resource. - - A backend service defines how Google Cloud load - balancers distribute traffic. The backend service - configuration contains a set of values, such as the - protocol used to connect to backends, various - distribution and session settings, health checks, and - timeouts. These settings provide fine-grained control - over how your load balancer behaves. Most of the - settings have default values that allow for easy - configuration if you need to get started quickly. - - Backend services in Google Compute Engine can be either - regionally or globally scoped. - - - `Global `__ - \* - `Regional `__ - + Represents a Backend Service resource. A backend service + defines how Google Cloud load balancers distribute + traffic. The backend service configuration contains a + set of values, such as the protocol used to connect to + backends, various distribution and session settings, + health checks, and timeouts. These settings provide + fine-grained control over how your load balancer + behaves. Most of the settings have default values that + allow for easy configuration if you need to get started + quickly. Backend services in Google Compute Engine can + be either regionally or globally scoped. \* + `Global `__ + \* + `Regional `__ For more information, see Backend Services. - (== resource_for {$api_version}.backendService ==) - """ # TODO(yon-mg): need to handle grpc transcoding and parse url correctly @@ -551,34 +505,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -694,34 +635,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -780,34 +708,21 @@ def set_security_policy( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -866,34 +781,21 @@ def update( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/disk_types/client.py b/google/cloud/compute_v1/services/disk_types/client.py index 8939f4ccb..5754aa468 100644 --- a/google/cloud/compute_v1/services/disk_types/client.py +++ b/google/cloud/compute_v1/services/disk_types/client.py @@ -440,27 +440,17 @@ def get( Returns: google.cloud.compute_v1.types.DiskType: - Represents a Disk Type resource. - - Google Compute Engine has two Disk Type resources: - - - [Regional](/compute/docs/reference/rest/{$api_version}/regionDiskTypes) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/diskTypes) - - You can choose from a variety of disk types based on - your needs. For more information, read Storage - options. - - The diskTypes resource represents disk types for a - zonal persistent disk. For more information, read - Zonal persistent disks. - - The regionDiskTypes resource represents disk types - for a regional persistent disk. For more information, - read Regional persistent disks. (== resource_for - {$api_version}.diskTypes ==) (== resource_for - {$api_version}.regionDiskTypes ==) + Represents a Disk Type resource. Google Compute Engine + has two Disk Type resources: \* + [Regional](/compute/docs/reference/rest/v1/regionDiskTypes) + \* [Zonal](/compute/docs/reference/rest/v1/diskTypes) + You can choose from a variety of disk types based on + your needs. For more information, read Storage options. + The diskTypes resource represents disk types for a zonal + persistent disk. For more information, read Zonal + persistent disks. The regionDiskTypes resource + represents disk types for a regional persistent disk. + For more information, read Regional persistent disks. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/disk_types/transports/rest.py b/google/cloud/compute_v1/services/disk_types/transports/rest.py index 5a874146a..80b1c3be7 100644 --- a/google/cloud/compute_v1/services/disk_types/transports/rest.py +++ b/google/cloud/compute_v1/services/disk_types/transports/rest.py @@ -175,26 +175,17 @@ def get( Returns: ~.compute.DiskType: - Represents a Disk Type resource. - - Google Compute Engine has two Disk Type resources: - - - `Regional `__ - \* - `Zonal `__ - + Represents a Disk Type resource. Google Compute Engine + has two Disk Type resources: \* + `Regional `__ + \* `Zonal `__ You can choose from a variety of disk types based on your needs. For more information, read Storage options. - The diskTypes resource represents disk types for a zonal persistent disk. For more information, read Zonal - persistent disks. - - The regionDiskTypes resource represents disk types for a - regional persistent disk. For more information, read - Regional persistent disks. (== resource_for - {$api_version}.diskTypes ==) (== resource_for - {$api_version}.regionDiskTypes ==) + persistent disks. The regionDiskTypes resource + represents disk types for a regional persistent disk. + For more information, read Regional persistent disks. """ diff --git a/google/cloud/compute_v1/services/disks/client.py b/google/cloud/compute_v1/services/disks/client.py index 89cc7550e..b7def10ab 100644 --- a/google/cloud/compute_v1/services/disks/client.py +++ b/google/cloud/compute_v1/services/disks/client.py @@ -377,31 +377,21 @@ def add_resource_policies( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -567,31 +557,21 @@ def create_snapshot( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -679,31 +659,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -786,28 +756,18 @@ def get( Returns: google.cloud.compute_v1.types.Disk: - Represents a Persistent Disk resource. - - Google Compute Engine has two Disk resources: - - - [Zonal](/compute/docs/reference/rest/{$api_version}/disks) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionDisks) - - Persistent disks are required for running your VM - instances. Create both boot and non-boot (data) - persistent disks. For more information, read - Persistent Disks. For more storage options, read - Storage options. - - The disks resource represents a zonal persistent - disk. For more information, read Zonal persistent - disks. - - The regionDisks resource represents a regional - persistent disk. For more information, read Regional - resources. (== resource_for {$api_version}.disks ==) - (== resource_for {$api_version}.regionDisks ==) + Represents a Persistent Disk resource. Google Compute + Engine has two Disk resources: \* + [Zonal](/compute/docs/reference/rest/v1/disks) \* + [Regional](/compute/docs/reference/rest/v1/regionDisks) + Persistent disks are required for running your VM + instances. Create both boot and non-boot (data) + persistent disks. For more information, read Persistent + Disks. For more storage options, read Storage options. + The disks resource represents a zonal persistent disk. + For more information, read Zonal persistent disks. The + regionDisks resource represents a regional persistent + disk. For more information, read Regional resources. """ # Create or coerce a protobuf request object. @@ -892,56 +852,44 @@ def get_iam_policy( Returns: google.cloud.compute_v1.types.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A Policy is a collection of bindings. A binding binds - one or more members to a single role. Members can be - user accounts, service accounts, Google groups, and - domains (such as G Suite). A role is a named list of - permissions; each role can be an IAM predefined role - or a user-created custom role. - - For some types of Google Cloud resources, a binding - can also specify a condition, which is a logical - expression that allows access to a resource only if - the expression evaluates to true. A condition can add - constraints based on attributes of the request, the - resource, or both. To learn which resources support - conditions in their IAM policies, see the [IAM - documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). - - **JSON example:** - - { "bindings": [ { "role": - "roles/resourcemanager.organizationAdmin", "members": - [ "user:mike@example.com", - "group:admins@example.com", "domain:google.com", - "serviceAccount:my-project-id@appspot.gserviceaccount.com" - ] }, { "role": - "roles/resourcemanager.organizationViewer", - "members": [ "user:eve@example.com" ], "condition": { - "title": "expirable access", "description": "Does not - grant access after Sep 2020", "expression": - "request.time < - timestamp('2020-10-01T00:00:00.000Z')", } } ], - "etag": "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - - bindings: - members: - user:\ mike@example.com - - group:\ admins@example.com - domain:google.com - - serviceAccount:\ my-project-id@appspot.gserviceaccount.com - role: roles/resourcemanager.organizationAdmin - - members: - user:\ eve@example.com role: - roles/resourcemanager.organizationViewer condition: - title: expirable access description: Does not grant - access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the - [IAM - documentation](\ https://cloud.google.com/iam/docs/). + specifies access controls for Google Cloud resources. A + Policy is a collection of bindings. A binding binds one + or more members to a single role. Members can be user + accounts, service accounts, Google groups, and domains + (such as G Suite). A role is a named list of + permissions; each role can be an IAM predefined role or + a user-created custom role. For some types of Google + Cloud resources, a binding can also specify a condition, + which is a logical expression that allows access to a + resource only if the expression evaluates to true. A + condition can add constraints based on attributes of the + request, the resource, or both. To learn which resources + support conditions in their IAM policies, see the [IAM + documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:\ mike@example.com - + group:\ admins@example.com - domain:google.com - + serviceAccount:\ my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:\ eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the [IAM + documentation](\ https://cloud.google.com/iam/docs/). """ # Create or coerce a protobuf request object. @@ -1027,31 +975,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1220,31 +1158,21 @@ def remove_resource_policies( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1337,31 +1265,21 @@ def resize( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1454,56 +1372,44 @@ def set_iam_policy( Returns: google.cloud.compute_v1.types.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A Policy is a collection of bindings. A binding binds - one or more members to a single role. Members can be - user accounts, service accounts, Google groups, and - domains (such as G Suite). A role is a named list of - permissions; each role can be an IAM predefined role - or a user-created custom role. - - For some types of Google Cloud resources, a binding - can also specify a condition, which is a logical - expression that allows access to a resource only if - the expression evaluates to true. A condition can add - constraints based on attributes of the request, the - resource, or both. To learn which resources support - conditions in their IAM policies, see the [IAM - documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). - - **JSON example:** - - { "bindings": [ { "role": - "roles/resourcemanager.organizationAdmin", "members": - [ "user:mike@example.com", - "group:admins@example.com", "domain:google.com", - "serviceAccount:my-project-id@appspot.gserviceaccount.com" - ] }, { "role": - "roles/resourcemanager.organizationViewer", - "members": [ "user:eve@example.com" ], "condition": { - "title": "expirable access", "description": "Does not - grant access after Sep 2020", "expression": - "request.time < - timestamp('2020-10-01T00:00:00.000Z')", } } ], - "etag": "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - - bindings: - members: - user:\ mike@example.com - - group:\ admins@example.com - domain:google.com - - serviceAccount:\ my-project-id@appspot.gserviceaccount.com - role: roles/resourcemanager.organizationAdmin - - members: - user:\ eve@example.com role: - roles/resourcemanager.organizationViewer condition: - title: expirable access description: Does not grant - access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the - [IAM - documentation](\ https://cloud.google.com/iam/docs/). + specifies access controls for Google Cloud resources. A + Policy is a collection of bindings. A binding binds one + or more members to a single role. Members can be user + accounts, service accounts, Google groups, and domains + (such as G Suite). A role is a named list of + permissions; each role can be an IAM predefined role or + a user-created custom role. For some types of Google + Cloud resources, a binding can also specify a condition, + which is a logical expression that allows access to a + resource only if the expression evaluates to true. A + condition can add constraints based on attributes of the + request, the resource, or both. To learn which resources + support conditions in their IAM policies, see the [IAM + documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:\ mike@example.com - + group:\ admins@example.com - domain:google.com - + serviceAccount:\ my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:\ eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the [IAM + documentation](\ https://cloud.google.com/iam/docs/). """ # Create or coerce a protobuf request object. @@ -1598,31 +1504,21 @@ def set_labels( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/disks/transports/rest.py b/google/cloud/compute_v1/services/disks/transports/rest.py index 36145f2f7..93dac1f99 100644 --- a/google/cloud/compute_v1/services/disks/transports/rest.py +++ b/google/cloud/compute_v1/services/disks/transports/rest.py @@ -117,34 +117,21 @@ def add_resource_policies( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -263,34 +250,21 @@ def create_snapshot( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -351,34 +325,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -428,26 +389,18 @@ def get( Returns: ~.compute.Disk: - Represents a Persistent Disk resource. - - Google Compute Engine has two Disk resources: - - - `Zonal `__ - \* - `Regional `__ - + Represents a Persistent Disk resource. Google Compute + Engine has two Disk resources: \* + `Zonal `__ \* + `Regional `__ Persistent disks are required for running your VM instances. Create both boot and non-boot (data) persistent disks. For more information, read Persistent Disks. For more storage options, read Storage options. - The disks resource represents a zonal persistent disk. - For more information, read Zonal persistent disks. - - The regionDisks resource represents a regional - persistent disk. For more information, read Regional - resources. (== resource_for {$api_version}.disks ==) (== - resource_for {$api_version}.regionDisks ==) + For more information, read Zonal persistent disks. The + regionDisks resource represents a regional persistent + disk. For more information, read Regional resources. """ @@ -497,28 +450,22 @@ def get_iam_policy( Returns: ~.compute.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A ``Policy`` is a collection of ``bindings``. A + specifies access controls for Google Cloud resources. A + ``Policy`` is a collection of ``bindings``. A ``binding`` binds one or more ``members`` to a single ``role``. Members can be user accounts, service accounts, Google groups, and domains (such as G Suite). A ``role`` is a named list of permissions; each ``role`` can be an IAM predefined role or a user-created custom - role. - - For some types of Google Cloud resources, a ``binding`` - can also specify a ``condition``, which is a logical - expression that allows access to a resource only if the - expression evaluates to ``true``. A condition can add - constraints based on attributes of the request, the + role. For some types of Google Cloud resources, a + ``binding`` can also specify a ``condition``, which is a + logical expression that allows access to a resource only + if the expression evaluates to ``true``. A condition can + add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the `IAM documentation `__. - - **JSON example:** - - { "bindings": [ { "role": + **JSON example:** { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", @@ -529,10 +476,7 @@ def get_iam_policy( "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": - "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - + "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com @@ -541,10 +485,9 @@ def get_iam_policy( roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the `IAM + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the `IAM documentation `__. """ @@ -597,34 +540,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -737,34 +667,21 @@ def remove_resource_policies( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -823,34 +740,21 @@ def resize( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -911,28 +815,22 @@ def set_iam_policy( Returns: ~.compute.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A ``Policy`` is a collection of ``bindings``. A + specifies access controls for Google Cloud resources. A + ``Policy`` is a collection of ``bindings``. A ``binding`` binds one or more ``members`` to a single ``role``. Members can be user accounts, service accounts, Google groups, and domains (such as G Suite). A ``role`` is a named list of permissions; each ``role`` can be an IAM predefined role or a user-created custom - role. - - For some types of Google Cloud resources, a ``binding`` - can also specify a ``condition``, which is a logical - expression that allows access to a resource only if the - expression evaluates to ``true``. A condition can add - constraints based on attributes of the request, the + role. For some types of Google Cloud resources, a + ``binding`` can also specify a ``condition``, which is a + logical expression that allows access to a resource only + if the expression evaluates to ``true``. A condition can + add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the `IAM documentation `__. - - **JSON example:** - - { "bindings": [ { "role": + **JSON example:** { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", @@ -943,10 +841,7 @@ def set_iam_policy( "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": - "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - + "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com @@ -955,10 +850,9 @@ def set_iam_policy( roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the `IAM + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the `IAM documentation `__. """ @@ -1017,34 +911,21 @@ def set_labels( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/external_vpn_gateways/client.py b/google/cloud/compute_v1/services/external_vpn_gateways/client.py index 5c84b80c8..a7f7d1ecc 100644 --- a/google/cloud/compute_v1/services/external_vpn_gateways/client.py +++ b/google/cloud/compute_v1/services/external_vpn_gateways/client.py @@ -367,31 +367,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -467,21 +457,19 @@ def get( Returns: google.cloud.compute_v1.types.ExternalVpnGateway: Represents an external VPN gateway. - - External VPN gateway is the on-premises VPN - gateway(s) or another cloud provider's VPN gateway - that connects to your Google Cloud VPN gateway. - - To create a highly available VPN from Google Cloud - Platform to your VPN gateway or another cloud - provider's VPN gateway, you must create a external - VPN gateway resource with information about the other - gateway. - - For more information about using external VPN - gateways, see Creating an HA VPN gateway and tunnel - pair to a peer VPN. (== resource_for - {$api_version}.externalVpnGateways ==) + External VPN gateway is the on-premises + VPN gateway(s) or another cloud + provider's VPN gateway that connects to + your Google Cloud VPN gateway. To create + a highly available VPN from Google Cloud + Platform to your VPN gateway or another + cloud provider's VPN gateway, you must + create a external VPN gateway resource + with information about the other + gateway. For more information about + using external VPN gateways, see + Creating an HA VPN gateway and tunnel + pair to a peer VPN. """ # Create or coerce a protobuf request object. @@ -553,31 +541,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -732,31 +710,21 @@ def set_labels( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/external_vpn_gateways/transports/rest.py b/google/cloud/compute_v1/services/external_vpn_gateways/transports/rest.py index c7465948b..d937a889a 100644 --- a/google/cloud/compute_v1/services/external_vpn_gateways/transports/rest.py +++ b/google/cloud/compute_v1/services/external_vpn_gateways/transports/rest.py @@ -117,34 +117,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -195,20 +182,19 @@ def get( Returns: ~.compute.ExternalVpnGateway: Represents an external VPN gateway. - - External VPN gateway is the on-premises VPN gateway(s) - or another cloud provider's VPN gateway that connects to - your Google Cloud VPN gateway. - - To create a highly available VPN from Google Cloud - Platform to your VPN gateway or another cloud provider's - VPN gateway, you must create a external VPN gateway - resource with information about the other gateway. - - For more information about using external VPN gateways, - see Creating an HA VPN gateway and tunnel pair to a peer - VPN. (== resource_for {$api_version}.externalVpnGateways - ==) + External VPN gateway is the on-premises + VPN gateway(s) or another cloud + provider's VPN gateway that connects to + your Google Cloud VPN gateway. To create + a highly available VPN from Google Cloud + Platform to your VPN gateway or another + cloud provider's VPN gateway, you must + create a external VPN gateway resource + with information about the other + gateway. For more information about + using external VPN gateways, see + Creating an HA VPN gateway and tunnel + pair to a peer VPN. """ @@ -258,34 +244,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -401,34 +374,21 @@ def set_labels( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/firewall_policies/client.py b/google/cloud/compute_v1/services/firewall_policies/client.py index edaf4279a..84f8b2394 100644 --- a/google/cloud/compute_v1/services/firewall_policies/client.py +++ b/google/cloud/compute_v1/services/firewall_policies/client.py @@ -366,31 +366,21 @@ def add_association( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -467,31 +457,21 @@ def add_rule( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -558,31 +538,21 @@ def clone_rules( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -647,31 +617,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -734,8 +694,8 @@ def get( Returns: google.cloud.compute_v1.types.FirewallPolicy: - Represents a Firewall Policy resource. (== resource_for - {$api_version}.firewallPolicies ==) + Represents a Firewall Policy + resource. """ # Create or coerce a protobuf request object. @@ -866,56 +826,44 @@ def get_iam_policy( Returns: google.cloud.compute_v1.types.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A Policy is a collection of bindings. A binding binds - one or more members to a single role. Members can be - user accounts, service accounts, Google groups, and - domains (such as G Suite). A role is a named list of - permissions; each role can be an IAM predefined role - or a user-created custom role. - - For some types of Google Cloud resources, a binding - can also specify a condition, which is a logical - expression that allows access to a resource only if - the expression evaluates to true. A condition can add - constraints based on attributes of the request, the - resource, or both. To learn which resources support - conditions in their IAM policies, see the [IAM - documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). - - **JSON example:** - - { "bindings": [ { "role": - "roles/resourcemanager.organizationAdmin", "members": - [ "user:mike@example.com", - "group:admins@example.com", "domain:google.com", - "serviceAccount:my-project-id@appspot.gserviceaccount.com" - ] }, { "role": - "roles/resourcemanager.organizationViewer", - "members": [ "user:eve@example.com" ], "condition": { - "title": "expirable access", "description": "Does not - grant access after Sep 2020", "expression": - "request.time < - timestamp('2020-10-01T00:00:00.000Z')", } } ], - "etag": "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - - bindings: - members: - user:\ mike@example.com - - group:\ admins@example.com - domain:google.com - - serviceAccount:\ my-project-id@appspot.gserviceaccount.com - role: roles/resourcemanager.organizationAdmin - - members: - user:\ eve@example.com role: - roles/resourcemanager.organizationViewer condition: - title: expirable access description: Does not grant - access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the - [IAM - documentation](\ https://cloud.google.com/iam/docs/). + specifies access controls for Google Cloud resources. A + Policy is a collection of bindings. A binding binds one + or more members to a single role. Members can be user + accounts, service accounts, Google groups, and domains + (such as G Suite). A role is a named list of + permissions; each role can be an IAM predefined role or + a user-created custom role. For some types of Google + Cloud resources, a binding can also specify a condition, + which is a logical expression that allows access to a + resource only if the expression evaluates to true. A + condition can add constraints based on attributes of the + request, the resource, or both. To learn which resources + support conditions in their IAM policies, see the [IAM + documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:\ mike@example.com - + group:\ admins@example.com - domain:google.com - + serviceAccount:\ my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:\ eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the [IAM + documentation](\ https://cloud.google.com/iam/docs/). """ # Create or coerce a protobuf request object. @@ -1047,31 +995,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1114,7 +1052,7 @@ def list( metadata: Sequence[Tuple[str, str]] = (), ) -> pagers.ListPager: r"""Lists all the policies that have been configured for - the specified project. + the specified folder or organization. Args: request (google.cloud.compute_v1.types.ListFirewallPoliciesRequest): @@ -1233,31 +1171,21 @@ def move( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1329,31 +1257,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1426,31 +1344,21 @@ def patch_rule( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1518,31 +1426,21 @@ def remove_association( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1607,31 +1505,21 @@ def remove_rule( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1704,56 +1592,44 @@ def set_iam_policy( Returns: google.cloud.compute_v1.types.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A Policy is a collection of bindings. A binding binds - one or more members to a single role. Members can be - user accounts, service accounts, Google groups, and - domains (such as G Suite). A role is a named list of - permissions; each role can be an IAM predefined role - or a user-created custom role. - - For some types of Google Cloud resources, a binding - can also specify a condition, which is a logical - expression that allows access to a resource only if - the expression evaluates to true. A condition can add - constraints based on attributes of the request, the - resource, or both. To learn which resources support - conditions in their IAM policies, see the [IAM - documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). - - **JSON example:** - - { "bindings": [ { "role": - "roles/resourcemanager.organizationAdmin", "members": - [ "user:mike@example.com", - "group:admins@example.com", "domain:google.com", - "serviceAccount:my-project-id@appspot.gserviceaccount.com" - ] }, { "role": - "roles/resourcemanager.organizationViewer", - "members": [ "user:eve@example.com" ], "condition": { - "title": "expirable access", "description": "Does not - grant access after Sep 2020", "expression": - "request.time < - timestamp('2020-10-01T00:00:00.000Z')", } } ], - "etag": "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - - bindings: - members: - user:\ mike@example.com - - group:\ admins@example.com - domain:google.com - - serviceAccount:\ my-project-id@appspot.gserviceaccount.com - role: roles/resourcemanager.organizationAdmin - - members: - user:\ eve@example.com role: - roles/resourcemanager.organizationViewer condition: - title: expirable access description: Does not grant - access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the - [IAM - documentation](\ https://cloud.google.com/iam/docs/). + specifies access controls for Google Cloud resources. A + Policy is a collection of bindings. A binding binds one + or more members to a single role. Members can be user + accounts, service accounts, Google groups, and domains + (such as G Suite). A role is a named list of + permissions; each role can be an IAM predefined role or + a user-created custom role. For some types of Google + Cloud resources, a binding can also specify a condition, + which is a logical expression that allows access to a + resource only if the expression evaluates to true. A + condition can add constraints based on attributes of the + request, the resource, or both. To learn which resources + support conditions in their IAM policies, see the [IAM + documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:\ mike@example.com - + group:\ admins@example.com - domain:google.com - + serviceAccount:\ my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:\ eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the [IAM + documentation](\ https://cloud.google.com/iam/docs/). """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/firewall_policies/transports/rest.py b/google/cloud/compute_v1/services/firewall_policies/transports/rest.py index 54c6d9230..1e637baf1 100644 --- a/google/cloud/compute_v1/services/firewall_policies/transports/rest.py +++ b/google/cloud/compute_v1/services/firewall_policies/transports/rest.py @@ -117,34 +117,21 @@ def add_association( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -208,34 +195,21 @@ def add_rule( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -292,34 +266,21 @@ def clone_rules( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -369,34 +330,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -444,8 +392,8 @@ def get( Returns: ~.compute.FirewallPolicy: - Represents a Firewall Policy resource. (== resource_for - {$api_version}.firewallPolicies ==) + Represents a Firewall Policy + resource. """ @@ -543,28 +491,22 @@ def get_iam_policy( Returns: ~.compute.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A ``Policy`` is a collection of ``bindings``. A + specifies access controls for Google Cloud resources. A + ``Policy`` is a collection of ``bindings``. A ``binding`` binds one or more ``members`` to a single ``role``. Members can be user accounts, service accounts, Google groups, and domains (such as G Suite). A ``role`` is a named list of permissions; each ``role`` can be an IAM predefined role or a user-created custom - role. - - For some types of Google Cloud resources, a ``binding`` - can also specify a ``condition``, which is a logical - expression that allows access to a resource only if the - expression evaluates to ``true``. A condition can add - constraints based on attributes of the request, the + role. For some types of Google Cloud resources, a + ``binding`` can also specify a ``condition``, which is a + logical expression that allows access to a resource only + if the expression evaluates to ``true``. A condition can + add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the `IAM documentation `__. - - **JSON example:** - - { "bindings": [ { "role": + **JSON example:** { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", @@ -575,10 +517,7 @@ def get_iam_policy( "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": - "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - + "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com @@ -587,10 +526,9 @@ def get_iam_policy( roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the `IAM + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the `IAM documentation `__. """ @@ -697,34 +635,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -891,34 +816,21 @@ def move( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -968,34 +880,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -1052,34 +951,21 @@ def patch_rule( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -1138,34 +1024,21 @@ def remove_association( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -1215,34 +1088,21 @@ def remove_rule( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -1293,28 +1153,22 @@ def set_iam_policy( Returns: ~.compute.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A ``Policy`` is a collection of ``bindings``. A + specifies access controls for Google Cloud resources. A + ``Policy`` is a collection of ``bindings``. A ``binding`` binds one or more ``members`` to a single ``role``. Members can be user accounts, service accounts, Google groups, and domains (such as G Suite). A ``role`` is a named list of permissions; each ``role`` can be an IAM predefined role or a user-created custom - role. - - For some types of Google Cloud resources, a ``binding`` - can also specify a ``condition``, which is a logical - expression that allows access to a resource only if the - expression evaluates to ``true``. A condition can add - constraints based on attributes of the request, the + role. For some types of Google Cloud resources, a + ``binding`` can also specify a ``condition``, which is a + logical expression that allows access to a resource only + if the expression evaluates to ``true``. A condition can + add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the `IAM documentation `__. - - **JSON example:** - - { "bindings": [ { "role": + **JSON example:** { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", @@ -1325,10 +1179,7 @@ def set_iam_policy( "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": - "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - + "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com @@ -1337,10 +1188,9 @@ def set_iam_policy( roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the `IAM + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the `IAM documentation `__. """ diff --git a/google/cloud/compute_v1/services/firewalls/client.py b/google/cloud/compute_v1/services/firewalls/client.py index 0d0193609..03348650b 100644 --- a/google/cloud/compute_v1/services/firewalls/client.py +++ b/google/cloud/compute_v1/services/firewalls/client.py @@ -361,31 +361,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -531,31 +521,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -706,31 +686,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -813,31 +783,21 @@ def update( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/firewalls/transports/rest.py b/google/cloud/compute_v1/services/firewalls/transports/rest.py index f751902f3..db25c5c0a 100644 --- a/google/cloud/compute_v1/services/firewalls/transports/rest.py +++ b/google/cloud/compute_v1/services/firewalls/transports/rest.py @@ -117,34 +117,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -241,34 +228,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -381,34 +355,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -465,34 +426,21 @@ def update( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/forwarding_rules/client.py b/google/cloud/compute_v1/services/forwarding_rules/client.py index 13f863fa4..d2360addc 100644 --- a/google/cloud/compute_v1/services/forwarding_rules/client.py +++ b/google/cloud/compute_v1/services/forwarding_rules/client.py @@ -444,31 +444,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -551,28 +541,18 @@ def get( Returns: google.cloud.compute_v1.types.ForwardingRule: - Represents a Forwarding Rule resource. - - Forwarding rule resources in GCP can be either - regional or global in scope: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalForwardingRules) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/forwardingRules) - - A forwarding rule and its corresponding IP address - represent the frontend configuration of a Google - Cloud Platform load balancer. Forwarding rules can - also reference target instances and Cloud VPN Classic - gateways (targetVpnGateway). - - For more information, read Forwarding rule concepts - and Using protocol forwarding. - - (== resource_for {$api_version}.forwardingRules ==) - (== resource_for {$api_version}.globalForwardingRules - ==) (== resource_for - {$api_version}.regionForwardingRules ==) + Represents a Forwarding Rule resource. Forwarding rule + resources in Google Cloud can be either regional or + global in scope: \* + [Global](https://cloud.google.com/compute/docs/reference/rest/v1/globalForwardingRules) + \* + [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/forwardingRules) + A forwarding rule and its corresponding IP address + represent the frontend configuration of a Google Cloud + Platform load balancer. Forwarding rules can also + reference target instances and Cloud VPN Classic + gateways (targetVpnGateway). For more information, read + Forwarding rule concepts and Using protocol forwarding. """ # Create or coerce a protobuf request object. @@ -655,31 +635,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -855,31 +825,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -972,31 +932,21 @@ def set_labels( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1092,31 +1042,21 @@ def set_target( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/forwarding_rules/transports/rest.py b/google/cloud/compute_v1/services/forwarding_rules/transports/rest.py index 61938b0e9..0b20495b6 100644 --- a/google/cloud/compute_v1/services/forwarding_rules/transports/rest.py +++ b/google/cloud/compute_v1/services/forwarding_rules/transports/rest.py @@ -179,34 +179,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -257,28 +244,18 @@ def get( Returns: ~.compute.ForwardingRule: - Represents a Forwarding Rule resource. - - Forwarding rule resources in GCP can be either regional - or global in scope: - - - `Global `__ - \* - `Regional `__ - + Represents a Forwarding Rule resource. Forwarding rule + resources in Google Cloud can be either regional or + global in scope: \* + `Global `__ + \* + `Regional `__ A forwarding rule and its corresponding IP address represent the frontend configuration of a Google Cloud Platform load balancer. Forwarding rules can also reference target instances and Cloud VPN Classic - gateways (targetVpnGateway). - - For more information, read Forwarding rule concepts and - Using protocol forwarding. - - (== resource_for {$api_version}.forwardingRules ==) (== - resource_for {$api_version}.globalForwardingRules ==) - (== resource_for {$api_version}.regionForwardingRules - ==) + gateways (targetVpnGateway). For more information, read + Forwarding rule concepts and Using protocol forwarding. """ @@ -329,34 +306,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -472,34 +436,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -559,34 +510,21 @@ def set_labels( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -646,34 +584,21 @@ def set_target( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/global_addresses/client.py b/google/cloud/compute_v1/services/global_addresses/client.py index 1d3870262..fdd0d2831 100644 --- a/google/cloud/compute_v1/services/global_addresses/client.py +++ b/google/cloud/compute_v1/services/global_addresses/client.py @@ -365,31 +365,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -463,35 +453,13 @@ def get( Returns: google.cloud.compute_v1.types.Address: - Use global external addresses for GFE-based external - HTTP(S) load balancers in Premium Tier. - - Use global internal addresses for reserved peering - network range. - - Use regional external addresses for the following - resources: - - - External IP addresses for VM instances - Regional - external forwarding rules - Cloud NAT external IP - addresses - GFE based LBs in Standard Tier - - Network LBs in Premium or Standard Tier - Cloud - VPN gateways (both Classic and HA) - - Use regional internal IP addresses for subnet IP - ranges (primary and secondary). This includes: - - - Internal IP addresses for VM instances - Alias IP - ranges of VM instances (/32 only) - Regional - internal forwarding rules - Internal TCP/UDP load - balancer addresses - Internal HTTP(S) load - balancer addresses - Cloud DNS inbound forwarding - IP addresses - - For more information, read reserved IP address. - - (== resource_for {$api_version}.addresses ==) (== - resource_for {$api_version}.globalAddresses ==) + Represents an IP Address resource. Google Compute Engine + has two IP Address resources: \* [Global (external and + internal)](\ https://cloud.google.com/compute/docs/reference/rest/v1/globalAddresses) + \* [Regional (external and + internal)](\ https://cloud.google.com/compute/docs/reference/rest/v1/addresses) + For more information, see Reserving a static external IP + address. """ # Create or coerce a protobuf request object. @@ -563,31 +531,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/global_addresses/transports/rest.py b/google/cloud/compute_v1/services/global_addresses/transports/rest.py index c1e9e2748..4d4ee1fda 100644 --- a/google/cloud/compute_v1/services/global_addresses/transports/rest.py +++ b/google/cloud/compute_v1/services/global_addresses/transports/rest.py @@ -117,34 +117,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -192,34 +179,13 @@ def get( Returns: ~.compute.Address: - Use global external addresses for GFE-based external - HTTP(S) load balancers in Premium Tier. - - Use global internal addresses for reserved peering - network range. - - Use regional external addresses for the following - resources: - - - External IP addresses for VM instances - Regional - external forwarding rules - Cloud NAT external IP - addresses - GFE based LBs in Standard Tier - Network - LBs in Premium or Standard Tier - Cloud VPN gateways - (both Classic and HA) - - Use regional internal IP addresses for subnet IP ranges - (primary and secondary). This includes: - - - Internal IP addresses for VM instances - Alias IP - ranges of VM instances (/32 only) - Regional internal - forwarding rules - Internal TCP/UDP load balancer - addresses - Internal HTTP(S) load balancer addresses - - Cloud DNS inbound forwarding IP addresses - - For more information, read reserved IP address. - - (== resource_for {$api_version}.addresses ==) (== - resource_for {$api_version}.globalAddresses ==) + Represents an IP Address resource. Google Compute Engine + has two IP Address resources: \* `Global (external and + internal) `__ + \* `Regional (external and + internal) `__ + For more information, see Reserving a static external IP + address. """ @@ -265,34 +231,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/global_forwarding_rules/client.py b/google/cloud/compute_v1/services/global_forwarding_rules/client.py index 93d9a28b5..494823484 100644 --- a/google/cloud/compute_v1/services/global_forwarding_rules/client.py +++ b/google/cloud/compute_v1/services/global_forwarding_rules/client.py @@ -367,31 +367,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -466,28 +456,18 @@ def get( Returns: google.cloud.compute_v1.types.ForwardingRule: - Represents a Forwarding Rule resource. - - Forwarding rule resources in GCP can be either - regional or global in scope: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalForwardingRules) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/forwardingRules) - - A forwarding rule and its corresponding IP address - represent the frontend configuration of a Google - Cloud Platform load balancer. Forwarding rules can - also reference target instances and Cloud VPN Classic - gateways (targetVpnGateway). - - For more information, read Forwarding rule concepts - and Using protocol forwarding. - - (== resource_for {$api_version}.forwardingRules ==) - (== resource_for {$api_version}.globalForwardingRules - ==) (== resource_for - {$api_version}.regionForwardingRules ==) + Represents a Forwarding Rule resource. Forwarding rule + resources in Google Cloud can be either regional or + global in scope: \* + [Global](https://cloud.google.com/compute/docs/reference/rest/v1/globalForwardingRules) + \* + [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/forwardingRules) + A forwarding rule and its corresponding IP address + represent the frontend configuration of a Google Cloud + Platform load balancer. Forwarding rules can also + reference target instances and Cloud VPN Classic + gateways (targetVpnGateway). For more information, read + Forwarding rule concepts and Using protocol forwarding. """ # Create or coerce a protobuf request object. @@ -560,31 +540,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -740,31 +710,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -814,7 +774,7 @@ def set_labels( metadata: Sequence[Tuple[str, str]] = (), ) -> compute.Operation: r"""Sets the labels on the specified resource. To learn - more about labels, read the Labeling Resources + more about labels, read the Labeling resources documentation. Args: @@ -847,31 +807,21 @@ def set_labels( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -958,31 +908,21 @@ def set_target( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/global_forwarding_rules/transports/rest.py b/google/cloud/compute_v1/services/global_forwarding_rules/transports/rest.py index ad44a5280..37b741d9f 100644 --- a/google/cloud/compute_v1/services/global_forwarding_rules/transports/rest.py +++ b/google/cloud/compute_v1/services/global_forwarding_rules/transports/rest.py @@ -117,34 +117,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -194,28 +181,18 @@ def get( Returns: ~.compute.ForwardingRule: - Represents a Forwarding Rule resource. - - Forwarding rule resources in GCP can be either regional - or global in scope: - - - `Global `__ - \* - `Regional `__ - + Represents a Forwarding Rule resource. Forwarding rule + resources in Google Cloud can be either regional or + global in scope: \* + `Global `__ + \* + `Regional `__ A forwarding rule and its corresponding IP address represent the frontend configuration of a Google Cloud Platform load balancer. Forwarding rules can also reference target instances and Cloud VPN Classic - gateways (targetVpnGateway). - - For more information, read Forwarding rule concepts and - Using protocol forwarding. - - (== resource_for {$api_version}.forwardingRules ==) (== - resource_for {$api_version}.globalForwardingRules ==) - (== resource_for {$api_version}.regionForwardingRules - ==) + gateways (targetVpnGateway). For more information, read + Forwarding rule concepts and Using protocol forwarding. """ @@ -265,34 +242,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -408,34 +372,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -494,34 +445,21 @@ def set_labels( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -576,34 +514,21 @@ def set_target( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/global_network_endpoint_groups/client.py b/google/cloud/compute_v1/services/global_network_endpoint_groups/client.py index ecec4662e..2670eb7fe 100644 --- a/google/cloud/compute_v1/services/global_network_endpoint_groups/client.py +++ b/google/cloud/compute_v1/services/global_network_endpoint_groups/client.py @@ -378,31 +378,21 @@ def attach_network_endpoints( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -495,31 +485,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -601,31 +581,21 @@ def detach_network_endpoints( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -717,20 +687,17 @@ def get( Returns: google.cloud.compute_v1.types.NetworkEndpointGroup: - Represents a collection of network endpoints. - - A network endpoint group (NEG) defines how a set of - endpoints should be reached, whether they are - reachable, and where they are located. For more - information about using NEGs, see Setting up external - HTTP(S) Load Balancing with internet NEGs, Setting up - zonal NEGs, or Setting up external HTTP(S) Load - Balancing with serverless NEGs. (== resource_for - {$api_version}.networkEndpointGroups ==) (== - resource_for - {$api_version}.globalNetworkEndpointGroups ==) (== - resource_for - {$api_version}.regionNetworkEndpointGroups ==) + Represents a collection of network + endpoints. A network endpoint group + (NEG) defines how a set of endpoints + should be reached, whether they are + reachable, and where they are located. + For more information about using NEGs, + see Setting up external HTTP(S) Load + Balancing with internet NEGs, Setting up + zonal NEGs, or Setting up external + HTTP(S) Load Balancing with serverless + NEGs. """ # Create or coerce a protobuf request object. @@ -803,31 +770,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/global_network_endpoint_groups/transports/rest.py b/google/cloud/compute_v1/services/global_network_endpoint_groups/transports/rest.py index 37a923eb1..696b006b4 100644 --- a/google/cloud/compute_v1/services/global_network_endpoint_groups/transports/rest.py +++ b/google/cloud/compute_v1/services/global_network_endpoint_groups/transports/rest.py @@ -117,34 +117,21 @@ def attach_network_endpoints( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -206,34 +193,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -283,34 +257,21 @@ def detach_network_endpoints( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -372,19 +333,17 @@ def get( Returns: ~.compute.NetworkEndpointGroup: - Represents a collection of network endpoints. - - A network endpoint group (NEG) defines how a set of - endpoints should be reached, whether they are reachable, - and where they are located. For more information about - using NEGs, see Setting up external HTTP(S) Load - Balancing with internet NEGs, Setting up zonal NEGs, or - Setting up external HTTP(S) Load Balancing with - serverless NEGs. (== resource_for - {$api_version}.networkEndpointGroups ==) (== - resource_for {$api_version}.globalNetworkEndpointGroups - ==) (== resource_for - {$api_version}.regionNetworkEndpointGroups ==) + Represents a collection of network + endpoints. A network endpoint group + (NEG) defines how a set of endpoints + should be reached, whether they are + reachable, and where they are located. + For more information about using NEGs, + see Setting up external HTTP(S) Load + Balancing with internet NEGs, Setting up + zonal NEGs, or Setting up external + HTTP(S) Load Balancing with serverless + NEGs. """ @@ -434,34 +393,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/global_operations/client.py b/google/cloud/compute_v1/services/global_operations/client.py index 6587dca21..379011f97 100644 --- a/google/cloud/compute_v1/services/global_operations/client.py +++ b/google/cloud/compute_v1/services/global_operations/client.py @@ -484,8 +484,7 @@ def get( timeout: float = None, metadata: Sequence[Tuple[str, str]] = (), ) -> compute.Operation: - r"""Retrieves the specified Operations resource. Gets a list of - operations by making a ``list()`` request. + r"""Retrieves the specified Operations resource. Args: request (google.cloud.compute_v1.types.GetGlobalOperationRequest): @@ -512,31 +511,21 @@ def get( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -662,15 +651,13 @@ def wait( from the ``GET`` method in that it waits for no more than the default deadline (2 minutes) and then returns the current state of the operation, which might be ``DONE`` or still in progress. - - This method is called on a best-effort basis. Specifically: - - - In uncommon cases, when the server is overloaded, the request - might return before the default deadline is reached, or might - return after zero seconds. - - If the default deadline is reached, there is no guarantee - that the operation is actually done when the method returns. - Be prepared to retry if the operation is not ``DONE``. + This method is called on a best-effort basis. Specifically: - In + uncommon cases, when the server is overloaded, the request might + return before the default deadline is reached, or might return + after zero seconds. - If the default deadline is reached, there + is no guarantee that the operation is actually done when the + method returns. Be prepared to retry if the operation is not + ``DONE``. Args: request (google.cloud.compute_v1.types.WaitGlobalOperationRequest): @@ -697,31 +684,21 @@ def wait( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/global_operations/transports/rest.py b/google/cloud/compute_v1/services/global_operations/transports/rest.py index 48656cd0d..f51fc90b6 100644 --- a/google/cloud/compute_v1/services/global_operations/transports/rest.py +++ b/google/cloud/compute_v1/services/global_operations/transports/rest.py @@ -229,34 +229,21 @@ def get( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -361,34 +348,21 @@ def wait( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/global_organization_operations/client.py b/google/cloud/compute_v1/services/global_organization_operations/client.py index e3b3bc6ea..6523acb35 100644 --- a/google/cloud/compute_v1/services/global_organization_operations/client.py +++ b/google/cloud/compute_v1/services/global_organization_operations/client.py @@ -431,31 +431,21 @@ def get( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/global_organization_operations/transports/rest.py b/google/cloud/compute_v1/services/global_organization_operations/transports/rest.py index 7c9719206..9b23fd401 100644 --- a/google/cloud/compute_v1/services/global_organization_operations/transports/rest.py +++ b/google/cloud/compute_v1/services/global_organization_operations/transports/rest.py @@ -169,34 +169,21 @@ def get( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/global_public_delegated_prefixes/client.py b/google/cloud/compute_v1/services/global_public_delegated_prefixes/client.py index bf7f0e814..87668b1ce 100644 --- a/google/cloud/compute_v1/services/global_public_delegated_prefixes/client.py +++ b/google/cloud/compute_v1/services/global_public_delegated_prefixes/client.py @@ -369,31 +369,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -548,31 +538,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -728,31 +708,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/global_public_delegated_prefixes/transports/rest.py b/google/cloud/compute_v1/services/global_public_delegated_prefixes/transports/rest.py index c82370155..bad5300ab 100644 --- a/google/cloud/compute_v1/services/global_public_delegated_prefixes/transports/rest.py +++ b/google/cloud/compute_v1/services/global_public_delegated_prefixes/transports/rest.py @@ -119,34 +119,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -254,34 +241,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -398,34 +372,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/health_checks/client.py b/google/cloud/compute_v1/services/health_checks/client.py index fc5835082..e55915857 100644 --- a/google/cloud/compute_v1/services/health_checks/client.py +++ b/google/cloud/compute_v1/services/health_checks/client.py @@ -437,31 +437,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -536,34 +526,25 @@ def get( Returns: google.cloud.compute_v1.types.HealthCheck: - Represents a Health Check resource. - - Google Compute Engine has two Health Check resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/healthChecks) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionHealthChecks) - - Internal HTTP(S) load balancers must use regional - health checks (compute.v1.regionHealthChecks). - - Traffic Director must use global health checks - (compute.v1.HealthChecks). - - Internal TCP/UDP load balancers can use either - regional or global health checks - (compute.v1.regionHealthChecks or - compute.v1.HealthChecks). - - External HTTP(S), TCP proxy, and SSL proxy load - balancers as well as managed instance group - auto-healing must use global health checks - (compute.v1.HealthChecks). - - Network load balancers must use legacy HTTP health - checks (httpHealthChecks). - - For more information, see Health checks overview. + Represents a Health Check resource. Google Compute + Engine has two Health Check resources: \* + [Global](/compute/docs/reference/rest/v1/healthChecks) + \* + [Regional](/compute/docs/reference/rest/v1/regionHealthChecks) + Internal HTTP(S) load balancers must use regional health + checks (compute.v1.regionHealthChecks). Traffic Director + must use global health checks (compute.v1.HealthChecks). + Internal TCP/UDP load balancers can use either regional + or global health checks (compute.v1.regionHealthChecks + or compute.v1.HealthChecks). External HTTP(S), TCP + proxy, and SSL proxy load balancers as well as managed + instance group auto-healing must use global health + checks (compute.v1.HealthChecks). Backend service-based + network load balancers must use regional health checks + (compute.v1.regionHealthChecks). Target pool-based + network load balancers must use legacy HTTP health + checks (compute.v1.httpHealthChecks). For more + information, see Health checks overview. """ # Create or coerce a protobuf request object. @@ -635,31 +616,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -815,31 +786,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -921,31 +882,21 @@ def update( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/health_checks/transports/rest.py b/google/cloud/compute_v1/services/health_checks/transports/rest.py index 63fa8e598..9e2645a4d 100644 --- a/google/cloud/compute_v1/services/health_checks/transports/rest.py +++ b/google/cloud/compute_v1/services/health_checks/transports/rest.py @@ -176,34 +176,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -251,33 +238,25 @@ def get( Returns: ~.compute.HealthCheck: - Represents a Health Check resource. - - Google Compute Engine has two Health Check resources: - - - `Global `__ - \* - `Regional `__ - + Represents a Health Check resource. Google Compute + Engine has two Health Check resources: \* + `Global `__ + \* + `Regional `__ Internal HTTP(S) load balancers must use regional health - checks (``compute.v1.regionHealthChecks``). - - Traffic Director must use global health checks - (``compute.v1.HealthChecks``). - - Internal TCP/UDP load balancers can use either regional - or global health checks - (``compute.v1.regionHealthChecks`` or - ``compute.v1.HealthChecks``). - - External HTTP(S), TCP proxy, and SSL proxy load - balancers as well as managed instance group auto-healing - must use global health checks - (``compute.v1.HealthChecks``). - - Network load balancers must use legacy HTTP health - checks (httpHealthChecks). - + checks (``compute.v1.regionHealthChecks``). Traffic + Director must use global health checks + (``compute.v1.HealthChecks``). Internal TCP/UDP load + balancers can use either regional or global health + checks (``compute.v1.regionHealthChecks`` or + ``compute.v1.HealthChecks``). External HTTP(S), TCP + proxy, and SSL proxy load balancers as well as managed + instance group auto-healing must use global health + checks (``compute.v1.HealthChecks``). Backend + service-based network load balancers must use regional + health checks (``compute.v1.regionHealthChecks``). + Target pool-based network load balancers must use legacy + HTTP health checks (``compute.v1.httpHealthChecks``). For more information, see Health checks overview. """ @@ -326,34 +305,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -469,34 +435,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -553,34 +506,21 @@ def update( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/image_family_views/__init__.py b/google/cloud/compute_v1/services/image_family_views/__init__.py new file mode 100644 index 000000000..a73071c31 --- /dev/null +++ b/google/cloud/compute_v1/services/image_family_views/__init__.py @@ -0,0 +1,18 @@ +# -*- coding: utf-8 -*- +# Copyright 2020 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +from .client import ImageFamilyViewsClient + +__all__ = ("ImageFamilyViewsClient",) diff --git a/google/cloud/compute_v1/services/image_family_views/client.py b/google/cloud/compute_v1/services/image_family_views/client.py new file mode 100644 index 000000000..ff13f17ae --- /dev/null +++ b/google/cloud/compute_v1/services/image_family_views/client.py @@ -0,0 +1,423 @@ +# -*- coding: utf-8 -*- +# Copyright 2020 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +from collections import OrderedDict +from distutils import util +import os +import re +from typing import Callable, Dict, Optional, Sequence, Tuple, Type, Union +import pkg_resources + +from google.api_core import client_options as client_options_lib # type: ignore +from google.api_core import exceptions as core_exceptions # type: ignore +from google.api_core import gapic_v1 # type: ignore +from google.api_core import retry as retries # type: ignore +from google.auth import credentials as ga_credentials # type: ignore +from google.auth.transport import mtls # type: ignore +from google.auth.transport.grpc import SslCredentials # type: ignore +from google.auth.exceptions import MutualTLSChannelError # type: ignore +from google.oauth2 import service_account # type: ignore + +from google.cloud.compute_v1.types import compute +from .transports.base import ImageFamilyViewsTransport, DEFAULT_CLIENT_INFO +from .transports.rest import ImageFamilyViewsRestTransport + + +class ImageFamilyViewsClientMeta(type): + """Metaclass for the ImageFamilyViews client. + + This provides class-level methods for building and retrieving + support objects (e.g. transport) without polluting the client instance + objects. + """ + + _transport_registry = ( + OrderedDict() + ) # type: Dict[str, Type[ImageFamilyViewsTransport]] + _transport_registry["rest"] = ImageFamilyViewsRestTransport + + def get_transport_class(cls, label: str = None,) -> Type[ImageFamilyViewsTransport]: + """Returns an appropriate transport class. + + Args: + label: The name of the desired transport. If none is + provided, then the first transport in the registry is used. + + Returns: + The transport class to use. + """ + # If a specific transport is requested, return that one. + if label: + return cls._transport_registry[label] + + # No transport is requested; return the default (that is, the first one + # in the dictionary). + return next(iter(cls._transport_registry.values())) + + +class ImageFamilyViewsClient(metaclass=ImageFamilyViewsClientMeta): + """The ImageFamilyViews API.""" + + @staticmethod + def _get_default_mtls_endpoint(api_endpoint): + """Converts api endpoint to mTLS endpoint. + + Convert "*.sandbox.googleapis.com" and "*.googleapis.com" to + "*.mtls.sandbox.googleapis.com" and "*.mtls.googleapis.com" respectively. + Args: + api_endpoint (Optional[str]): the api endpoint to convert. + Returns: + str: converted mTLS api endpoint. + """ + if not api_endpoint: + return api_endpoint + + mtls_endpoint_re = re.compile( + r"(?P[^.]+)(?P\.mtls)?(?P\.sandbox)?(?P\.googleapis\.com)?" + ) + + m = mtls_endpoint_re.match(api_endpoint) + name, mtls, sandbox, googledomain = m.groups() + if mtls or not googledomain: + return api_endpoint + + if sandbox: + return api_endpoint.replace( + "sandbox.googleapis.com", "mtls.sandbox.googleapis.com" + ) + + return api_endpoint.replace(".googleapis.com", ".mtls.googleapis.com") + + DEFAULT_ENDPOINT = "compute.googleapis.com" + DEFAULT_MTLS_ENDPOINT = _get_default_mtls_endpoint.__func__( # type: ignore + DEFAULT_ENDPOINT + ) + + @classmethod + def from_service_account_info(cls, info: dict, *args, **kwargs): + """Creates an instance of this client using the provided credentials + info. + + Args: + info (dict): The service account private key info. + args: Additional arguments to pass to the constructor. + kwargs: Additional arguments to pass to the constructor. + + Returns: + ImageFamilyViewsClient: The constructed client. + """ + credentials = service_account.Credentials.from_service_account_info(info) + kwargs["credentials"] = credentials + return cls(*args, **kwargs) + + @classmethod + def from_service_account_file(cls, filename: str, *args, **kwargs): + """Creates an instance of this client using the provided credentials + file. + + Args: + filename (str): The path to the service account private key json + file. + args: Additional arguments to pass to the constructor. + kwargs: Additional arguments to pass to the constructor. + + Returns: + ImageFamilyViewsClient: The constructed client. + """ + credentials = service_account.Credentials.from_service_account_file(filename) + kwargs["credentials"] = credentials + return cls(*args, **kwargs) + + from_service_account_json = from_service_account_file + + @property + def transport(self) -> ImageFamilyViewsTransport: + """Returns the transport used by the client instance. + + Returns: + ImageFamilyViewsTransport: The transport used by the client + instance. + """ + return self._transport + + @staticmethod + def common_billing_account_path(billing_account: str,) -> str: + """Returns a fully-qualified billing_account string.""" + return "billingAccounts/{billing_account}".format( + billing_account=billing_account, + ) + + @staticmethod + def parse_common_billing_account_path(path: str) -> Dict[str, str]: + """Parse a billing_account path into its component segments.""" + m = re.match(r"^billingAccounts/(?P.+?)$", path) + return m.groupdict() if m else {} + + @staticmethod + def common_folder_path(folder: str,) -> str: + """Returns a fully-qualified folder string.""" + return "folders/{folder}".format(folder=folder,) + + @staticmethod + def parse_common_folder_path(path: str) -> Dict[str, str]: + """Parse a folder path into its component segments.""" + m = re.match(r"^folders/(?P.+?)$", path) + return m.groupdict() if m else {} + + @staticmethod + def common_organization_path(organization: str,) -> str: + """Returns a fully-qualified organization string.""" + return "organizations/{organization}".format(organization=organization,) + + @staticmethod + def parse_common_organization_path(path: str) -> Dict[str, str]: + """Parse a organization path into its component segments.""" + m = re.match(r"^organizations/(?P.+?)$", path) + return m.groupdict() if m else {} + + @staticmethod + def common_project_path(project: str,) -> str: + """Returns a fully-qualified project string.""" + return "projects/{project}".format(project=project,) + + @staticmethod + def parse_common_project_path(path: str) -> Dict[str, str]: + """Parse a project path into its component segments.""" + m = re.match(r"^projects/(?P.+?)$", path) + return m.groupdict() if m else {} + + @staticmethod + def common_location_path(project: str, location: str,) -> str: + """Returns a fully-qualified location string.""" + return "projects/{project}/locations/{location}".format( + project=project, location=location, + ) + + @staticmethod + def parse_common_location_path(path: str) -> Dict[str, str]: + """Parse a location path into its component segments.""" + m = re.match(r"^projects/(?P.+?)/locations/(?P.+?)$", path) + return m.groupdict() if m else {} + + def __init__( + self, + *, + credentials: Optional[ga_credentials.Credentials] = None, + transport: Union[str, ImageFamilyViewsTransport, None] = None, + client_options: Optional[client_options_lib.ClientOptions] = None, + client_info: gapic_v1.client_info.ClientInfo = DEFAULT_CLIENT_INFO, + ) -> None: + """Instantiates the image family views client. + + Args: + credentials (Optional[google.auth.credentials.Credentials]): The + authorization credentials to attach to requests. These + credentials identify the application to the service; if none + are specified, the client will attempt to ascertain the + credentials from the environment. + transport (Union[str, ImageFamilyViewsTransport]): The + transport to use. If set to None, a transport is chosen + automatically. + client_options (google.api_core.client_options.ClientOptions): Custom options for the + client. It won't take effect if a ``transport`` instance is provided. + (1) The ``api_endpoint`` property can be used to override the + default endpoint provided by the client. GOOGLE_API_USE_MTLS_ENDPOINT + environment variable can also be used to override the endpoint: + "always" (always use the default mTLS endpoint), "never" (always + use the default regular endpoint) and "auto" (auto switch to the + default mTLS endpoint if client certificate is present, this is + the default value). However, the ``api_endpoint`` property takes + precedence if provided. + (2) If GOOGLE_API_USE_CLIENT_CERTIFICATE environment variable + is "true", then the ``client_cert_source`` property can be used + to provide client certificate for mutual TLS transport. If + not provided, the default SSL client certificate will be used if + present. If GOOGLE_API_USE_CLIENT_CERTIFICATE is "false" or not + set, no client certificate will be used. + client_info (google.api_core.gapic_v1.client_info.ClientInfo): + The client info used to send a user-agent string along with + API requests. If ``None``, then default info will be used. + Generally, you only need to set this if you're developing + your own client library. + + Raises: + google.auth.exceptions.MutualTLSChannelError: If mutual TLS transport + creation failed for any reason. + """ + if isinstance(client_options, dict): + client_options = client_options_lib.from_dict(client_options) + if client_options is None: + client_options = client_options_lib.ClientOptions() + + # Create SSL credentials for mutual TLS if needed. + use_client_cert = bool( + util.strtobool(os.getenv("GOOGLE_API_USE_CLIENT_CERTIFICATE", "false")) + ) + + client_cert_source_func = None + is_mtls = False + if use_client_cert: + if client_options.client_cert_source: + is_mtls = True + client_cert_source_func = client_options.client_cert_source + else: + is_mtls = mtls.has_default_client_cert_source() + if is_mtls: + client_cert_source_func = mtls.default_client_cert_source() + else: + client_cert_source_func = None + + # Figure out which api endpoint to use. + if client_options.api_endpoint is not None: + api_endpoint = client_options.api_endpoint + else: + use_mtls_env = os.getenv("GOOGLE_API_USE_MTLS_ENDPOINT", "auto") + if use_mtls_env == "never": + api_endpoint = self.DEFAULT_ENDPOINT + elif use_mtls_env == "always": + api_endpoint = self.DEFAULT_MTLS_ENDPOINT + elif use_mtls_env == "auto": + if is_mtls: + api_endpoint = self.DEFAULT_MTLS_ENDPOINT + else: + api_endpoint = self.DEFAULT_ENDPOINT + else: + raise MutualTLSChannelError( + "Unsupported GOOGLE_API_USE_MTLS_ENDPOINT value. Accepted " + "values: never, auto, always" + ) + + # Save or instantiate the transport. + # Ordinarily, we provide the transport, but allowing a custom transport + # instance provides an extensibility point for unusual situations. + if isinstance(transport, ImageFamilyViewsTransport): + # transport is a ImageFamilyViewsTransport instance. + if credentials or client_options.credentials_file: + raise ValueError( + "When providing a transport instance, " + "provide its credentials directly." + ) + if client_options.scopes: + raise ValueError( + "When providing a transport instance, provide its scopes " + "directly." + ) + self._transport = transport + else: + Transport = type(self).get_transport_class(transport) + self._transport = Transport( + credentials=credentials, + credentials_file=client_options.credentials_file, + host=api_endpoint, + scopes=client_options.scopes, + client_cert_source_for_mtls=client_cert_source_func, + quota_project_id=client_options.quota_project_id, + client_info=client_info, + ) + + def get( + self, + request: compute.GetImageFamilyViewRequest = None, + *, + project: str = None, + zone: str = None, + family: str = None, + retry: retries.Retry = gapic_v1.method.DEFAULT, + timeout: float = None, + metadata: Sequence[Tuple[str, str]] = (), + ) -> compute.ImageFamilyView: + r"""Returns the latest image that is part of an image + family, is not deprecated and is rolled out in the + specified zone. + + Args: + request (google.cloud.compute_v1.types.GetImageFamilyViewRequest): + The request object. A request message for + ImageFamilyViews.Get. See the method description for + details. + project (str): + Project ID for this request. + This corresponds to the ``project`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + zone (str): + The name of the zone for this + request. + + This corresponds to the ``zone`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + family (str): + Name of the image family to search + for. + + This corresponds to the ``family`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + google.cloud.compute_v1.types.ImageFamilyView: + + """ + # Create or coerce a protobuf request object. + # Sanity check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any([project, zone, family]) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + # Minor optimization to avoid making a copy if the user passes + # in a compute.GetImageFamilyViewRequest. + # There's no risk of modifying the input as we've already verified + # there are no flattened fields. + if not isinstance(request, compute.GetImageFamilyViewRequest): + request = compute.GetImageFamilyViewRequest(request) + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if project is not None: + request.project = project + if zone is not None: + request.zone = zone + if family is not None: + request.family = family + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = self._transport._wrapped_methods[self._transport.get] + + # Send the request. + response = rpc(request, retry=retry, timeout=timeout, metadata=metadata,) + + # Done; return the response. + return response + + +try: + DEFAULT_CLIENT_INFO = gapic_v1.client_info.ClientInfo( + gapic_version=pkg_resources.get_distribution("google-cloud-compute",).version, + ) +except pkg_resources.DistributionNotFound: + DEFAULT_CLIENT_INFO = gapic_v1.client_info.ClientInfo() + + +__all__ = ("ImageFamilyViewsClient",) diff --git a/google/cloud/compute_v1/services/image_family_views/transports/__init__.py b/google/cloud/compute_v1/services/image_family_views/transports/__init__.py new file mode 100644 index 000000000..f0040a02b --- /dev/null +++ b/google/cloud/compute_v1/services/image_family_views/transports/__init__.py @@ -0,0 +1,30 @@ +# -*- coding: utf-8 -*- +# Copyright 2020 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +from collections import OrderedDict +from typing import Dict, Type + +from .base import ImageFamilyViewsTransport +from .rest import ImageFamilyViewsRestTransport + + +# Compile a registry of transports. +_transport_registry = OrderedDict() # type: Dict[str, Type[ImageFamilyViewsTransport]] +_transport_registry["rest"] = ImageFamilyViewsRestTransport + +__all__ = ( + "ImageFamilyViewsTransport", + "ImageFamilyViewsRestTransport", +) diff --git a/google/cloud/compute_v1/services/image_family_views/transports/base.py b/google/cloud/compute_v1/services/image_family_views/transports/base.py new file mode 100644 index 000000000..a26aabde6 --- /dev/null +++ b/google/cloud/compute_v1/services/image_family_views/transports/base.py @@ -0,0 +1,177 @@ +# -*- coding: utf-8 -*- +# Copyright 2020 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +import abc +from typing import Awaitable, Callable, Dict, Optional, Sequence, Union +import packaging.version +import pkg_resources +from requests import __version__ as requests_version + +import google.auth # type: ignore +import google.api_core # type: ignore +from google.api_core import exceptions as core_exceptions # type: ignore +from google.api_core import gapic_v1 # type: ignore +from google.api_core import retry as retries # type: ignore +from google.auth import credentials as ga_credentials # type: ignore +from google.oauth2 import service_account # type: ignore + +from google.cloud.compute_v1.types import compute + +try: + DEFAULT_CLIENT_INFO = gapic_v1.client_info.ClientInfo( + gapic_version=pkg_resources.get_distribution("google-cloud-compute",).version, + grpc_version=None, + rest_version=requests_version, + ) +except pkg_resources.DistributionNotFound: + DEFAULT_CLIENT_INFO = gapic_v1.client_info.ClientInfo() + +try: + # google.auth.__version__ was added in 1.26.0 + _GOOGLE_AUTH_VERSION = google.auth.__version__ +except AttributeError: + try: # try pkg_resources if it is available + _GOOGLE_AUTH_VERSION = pkg_resources.get_distribution("google-auth").version + except pkg_resources.DistributionNotFound: # pragma: NO COVER + _GOOGLE_AUTH_VERSION = None + + +class ImageFamilyViewsTransport(abc.ABC): + """Abstract transport class for ImageFamilyViews.""" + + AUTH_SCOPES = ( + "https://www.googleapis.com/auth/compute.readonly", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/cloud-platform", + ) + + DEFAULT_HOST: str = "compute.googleapis.com" + + def __init__( + self, + *, + host: str = DEFAULT_HOST, + credentials: ga_credentials.Credentials = None, + credentials_file: Optional[str] = None, + scopes: Optional[Sequence[str]] = None, + quota_project_id: Optional[str] = None, + client_info: gapic_v1.client_info.ClientInfo = DEFAULT_CLIENT_INFO, + always_use_jwt_access: Optional[bool] = False, + **kwargs, + ) -> None: + """Instantiate the transport. + + Args: + host (Optional[str]): + The hostname to connect to. + credentials (Optional[google.auth.credentials.Credentials]): The + authorization credentials to attach to requests. These + credentials identify the application to the service; if none + are specified, the client will attempt to ascertain the + credentials from the environment. + credentials_file (Optional[str]): A file with credentials that can + be loaded with :func:`google.auth.load_credentials_from_file`. + This argument is mutually exclusive with credentials. + scopes (Optional[Sequence[str]]): A list of scopes. + quota_project_id (Optional[str]): An optional project to use for billing + and quota. + client_info (google.api_core.gapic_v1.client_info.ClientInfo): + The client info used to send a user-agent string along with + API requests. If ``None``, then default info will be used. + Generally, you only need to set this if you're developing + your own client library. + always_use_jwt_access (Optional[bool]): Whether self signed JWT should + be used for service account credentials. + """ + # Save the hostname. Default to port 443 (HTTPS) if none is specified. + if ":" not in host: + host += ":443" + self._host = host + + scopes_kwargs = self._get_scopes_kwargs(self._host, scopes) + + # Save the scopes. + self._scopes = scopes + + # If no credentials are provided, then determine the appropriate + # defaults. + if credentials and credentials_file: + raise core_exceptions.DuplicateCredentialArgs( + "'credentials_file' and 'credentials' are mutually exclusive" + ) + + if credentials_file is not None: + credentials, _ = google.auth.load_credentials_from_file( + credentials_file, **scopes_kwargs, quota_project_id=quota_project_id + ) + + elif credentials is None: + credentials, _ = google.auth.default( + **scopes_kwargs, quota_project_id=quota_project_id + ) + + # If the credentials is service account credentials, then always try to use self signed JWT. + if ( + always_use_jwt_access + and isinstance(credentials, service_account.Credentials) + and hasattr(service_account.Credentials, "with_always_use_jwt_access") + ): + credentials = credentials.with_always_use_jwt_access(True) + + # Save the credentials. + self._credentials = credentials + + # TODO(busunkim): This method is in the base transport + # to avoid duplicating code across the transport classes. These functions + # should be deleted once the minimum required versions of google-auth is increased. + + # TODO: Remove this function once google-auth >= 1.25.0 is required + @classmethod + def _get_scopes_kwargs( + cls, host: str, scopes: Optional[Sequence[str]] + ) -> Dict[str, Optional[Sequence[str]]]: + """Returns scopes kwargs to pass to google-auth methods depending on the google-auth version""" + + scopes_kwargs = {} + + if _GOOGLE_AUTH_VERSION and ( + packaging.version.parse(_GOOGLE_AUTH_VERSION) + >= packaging.version.parse("1.25.0") + ): + scopes_kwargs = {"scopes": scopes, "default_scopes": cls.AUTH_SCOPES} + else: + scopes_kwargs = {"scopes": scopes or cls.AUTH_SCOPES} + + return scopes_kwargs + + def _prep_wrapped_messages(self, client_info): + # Precompute the wrapped methods. + self._wrapped_methods = { + self.get: gapic_v1.method.wrap_method( + self.get, default_timeout=None, client_info=client_info, + ), + } + + @property + def get( + self, + ) -> Callable[ + [compute.GetImageFamilyViewRequest], + Union[compute.ImageFamilyView, Awaitable[compute.ImageFamilyView]], + ]: + raise NotImplementedError() + + +__all__ = ("ImageFamilyViewsTransport",) diff --git a/google/cloud/compute_v1/services/image_family_views/transports/rest.py b/google/cloud/compute_v1/services/image_family_views/transports/rest.py new file mode 100644 index 000000000..23c983cbb --- /dev/null +++ b/google/cloud/compute_v1/services/image_family_views/transports/rest.py @@ -0,0 +1,152 @@ +# -*- coding: utf-8 -*- +# Copyright 2020 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +import warnings +from typing import Callable, Dict, Optional, Sequence, Tuple + +from google.api_core import gapic_v1 # type: ignore +from google.api_core import exceptions as core_exceptions # type: ignore +from google.auth import credentials as ga_credentials # type: ignore +from google.auth.transport.grpc import SslCredentials # type: ignore + +import grpc # type: ignore + +from google.auth.transport.requests import AuthorizedSession + +from google.cloud.compute_v1.types import compute + +from .base import ImageFamilyViewsTransport, DEFAULT_CLIENT_INFO + + +class ImageFamilyViewsRestTransport(ImageFamilyViewsTransport): + """REST backend transport for ImageFamilyViews. + + The ImageFamilyViews API. + + This class defines the same methods as the primary client, so the + primary client can load the underlying transport implementation + and call it. + + It sends JSON representations of protocol buffers over HTTP/1.1 + """ + + def __init__( + self, + *, + host: str = "compute.googleapis.com", + credentials: ga_credentials.Credentials = None, + credentials_file: str = None, + scopes: Sequence[str] = None, + client_cert_source_for_mtls: Callable[[], Tuple[bytes, bytes]] = None, + quota_project_id: Optional[str] = None, + client_info: gapic_v1.client_info.ClientInfo = DEFAULT_CLIENT_INFO, + always_use_jwt_access: Optional[bool] = False, + ) -> None: + """Instantiate the transport. + + Args: + host (Optional[str]): + The hostname to connect to. + credentials (Optional[google.auth.credentials.Credentials]): The + authorization credentials to attach to requests. These + credentials identify the application to the service; if none + are specified, the client will attempt to ascertain the + credentials from the environment. + + credentials_file (Optional[str]): A file with credentials that can + be loaded with :func:`google.auth.load_credentials_from_file`. + This argument is ignored if ``channel`` is provided. + scopes (Optional(Sequence[str])): A list of scopes. This argument is + ignored if ``channel`` is provided. + client_cert_source_for_mtls (Callable[[], Tuple[bytes, bytes]]): Client + certificate to configure mutual TLS HTTP channel. It is ignored + if ``channel`` is provided. + quota_project_id (Optional[str]): An optional project to use for billing + and quota. + client_info (google.api_core.gapic_v1.client_info.ClientInfo): + The client info used to send a user-agent string along with + API requests. If ``None``, then default info will be used. + Generally, you only need to set this if you're developing + your own client library. + """ + # Run the base constructor + # TODO(yon-mg): resolve other ctor params i.e. scopes, quota, etc. + # TODO: When custom host (api_endpoint) is set, `scopes` must *also* be set on the + # credentials object + super().__init__( + host=host, + credentials=credentials, + client_info=client_info, + always_use_jwt_access=always_use_jwt_access, + ) + self._session = AuthorizedSession( + self._credentials, default_host=self.DEFAULT_HOST + ) + if client_cert_source_for_mtls: + self._session.configure_mtls_channel(client_cert_source_for_mtls) + self._prep_wrapped_messages(client_info) + + def get( + self, + request: compute.GetImageFamilyViewRequest, + *, + metadata: Sequence[Tuple[str, str]] = (), + ) -> compute.ImageFamilyView: + r"""Call the get method over HTTP. + + Args: + request (~.compute.GetImageFamilyViewRequest): + The request object. A request message for + ImageFamilyViews.Get. See the method + description for details. + + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + ~.compute.ImageFamilyView: + + """ + + # TODO(yon-mg): need to handle grpc transcoding and parse url correctly + # current impl assumes basic case of grpc transcoding + url = "https://{host}/compute/v1/projects/{project}/zones/{zone}/imageFamilyViews/{family}".format( + host=self._host, + project=request.project, + zone=request.zone, + family=request.family, + ) + + # TODO(yon-mg): handle nested fields corerctly rather than using only top level fields + # not required for GCE + query_params = {} + + # Send the request + headers = dict(metadata) + headers["Content-Type"] = "application/json" + response = self._session.get(url, headers=headers, params=query_params,) + + # In case of error, raise the appropriate core_exceptions.GoogleAPICallError exception + # subclass. + if response.status_code >= 400: + raise core_exceptions.from_http_response(response) + + # Return the response + return compute.ImageFamilyView.from_json( + response.content, ignore_unknown_fields=True + ) + + +__all__ = ("ImageFamilyViewsRestTransport",) diff --git a/google/cloud/compute_v1/services/images/client.py b/google/cloud/compute_v1/services/images/client.py index 916282573..1ace37730 100644 --- a/google/cloud/compute_v1/services/images/client.py +++ b/google/cloud/compute_v1/services/images/client.py @@ -360,31 +360,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -431,9 +421,9 @@ def deprecate( timeout: float = None, metadata: Sequence[Tuple[str, str]] = (), ) -> compute.Operation: - r"""Sets the deprecation status of an image. - If an empty request body is given, clears the - deprecation status instead. + r"""Sets the deprecation status of an image. If an empty + request body is given, clears the deprecation status + instead. Args: request (google.cloud.compute_v1.types.DeprecateImageRequest): @@ -463,31 +453,21 @@ def deprecate( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -560,11 +540,10 @@ def get( Returns: google.cloud.compute_v1.types.Image: - Represents an Image resource. - - You can use images to create boot disks for your VM - instances. For more information, read Images. (== - resource_for {$api_version}.images ==) + Represents an Image resource. You can + use images to create boot disks for your + VM instances. For more information, read + Images. """ # Create or coerce a protobuf request object. @@ -638,11 +617,10 @@ def get_from_family( Returns: google.cloud.compute_v1.types.Image: - Represents an Image resource. - - You can use images to create boot disks for your VM - instances. For more information, read Images. (== - resource_for {$api_version}.images ==) + Represents an Image resource. You can + use images to create boot disks for your + VM instances. For more information, read + Images. """ # Create or coerce a protobuf request object. @@ -717,56 +695,44 @@ def get_iam_policy( Returns: google.cloud.compute_v1.types.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A Policy is a collection of bindings. A binding binds - one or more members to a single role. Members can be - user accounts, service accounts, Google groups, and - domains (such as G Suite). A role is a named list of - permissions; each role can be an IAM predefined role - or a user-created custom role. - - For some types of Google Cloud resources, a binding - can also specify a condition, which is a logical - expression that allows access to a resource only if - the expression evaluates to true. A condition can add - constraints based on attributes of the request, the - resource, or both. To learn which resources support - conditions in their IAM policies, see the [IAM - documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). - - **JSON example:** - - { "bindings": [ { "role": - "roles/resourcemanager.organizationAdmin", "members": - [ "user:mike@example.com", - "group:admins@example.com", "domain:google.com", - "serviceAccount:my-project-id@appspot.gserviceaccount.com" - ] }, { "role": - "roles/resourcemanager.organizationViewer", - "members": [ "user:eve@example.com" ], "condition": { - "title": "expirable access", "description": "Does not - grant access after Sep 2020", "expression": - "request.time < - timestamp('2020-10-01T00:00:00.000Z')", } } ], - "etag": "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - - bindings: - members: - user:\ mike@example.com - - group:\ admins@example.com - domain:google.com - - serviceAccount:\ my-project-id@appspot.gserviceaccount.com - role: roles/resourcemanager.organizationAdmin - - members: - user:\ eve@example.com role: - roles/resourcemanager.organizationViewer condition: - title: expirable access description: Does not grant - access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the - [IAM - documentation](\ https://cloud.google.com/iam/docs/). + specifies access controls for Google Cloud resources. A + Policy is a collection of bindings. A binding binds one + or more members to a single role. Members can be user + accounts, service accounts, Google groups, and domains + (such as G Suite). A role is a named list of + permissions; each role can be an IAM predefined role or + a user-created custom role. For some types of Google + Cloud resources, a binding can also specify a condition, + which is a logical expression that allows access to a + resource only if the expression evaluates to true. A + condition can add constraints based on attributes of the + request, the resource, or both. To learn which resources + support conditions in their IAM policies, see the [IAM + documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:\ mike@example.com - + group:\ admins@example.com - domain:google.com - + serviceAccount:\ my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:\ eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the [IAM + documentation](\ https://cloud.google.com/iam/docs/). """ # Create or coerce a protobuf request object. @@ -837,31 +803,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1017,31 +973,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1124,56 +1070,44 @@ def set_iam_policy( Returns: google.cloud.compute_v1.types.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A Policy is a collection of bindings. A binding binds - one or more members to a single role. Members can be - user accounts, service accounts, Google groups, and - domains (such as G Suite). A role is a named list of - permissions; each role can be an IAM predefined role - or a user-created custom role. - - For some types of Google Cloud resources, a binding - can also specify a condition, which is a logical - expression that allows access to a resource only if - the expression evaluates to true. A condition can add - constraints based on attributes of the request, the - resource, or both. To learn which resources support - conditions in their IAM policies, see the [IAM - documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). - - **JSON example:** - - { "bindings": [ { "role": - "roles/resourcemanager.organizationAdmin", "members": - [ "user:mike@example.com", - "group:admins@example.com", "domain:google.com", - "serviceAccount:my-project-id@appspot.gserviceaccount.com" - ] }, { "role": - "roles/resourcemanager.organizationViewer", - "members": [ "user:eve@example.com" ], "condition": { - "title": "expirable access", "description": "Does not - grant access after Sep 2020", "expression": - "request.time < - timestamp('2020-10-01T00:00:00.000Z')", } } ], - "etag": "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - - bindings: - members: - user:\ mike@example.com - - group:\ admins@example.com - domain:google.com - - serviceAccount:\ my-project-id@appspot.gserviceaccount.com - role: roles/resourcemanager.organizationAdmin - - members: - user:\ eve@example.com role: - roles/resourcemanager.organizationViewer condition: - title: expirable access description: Does not grant - access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the - [IAM - documentation](\ https://cloud.google.com/iam/docs/). + specifies access controls for Google Cloud resources. A + Policy is a collection of bindings. A binding binds one + or more members to a single role. Members can be user + accounts, service accounts, Google groups, and domains + (such as G Suite). A role is a named list of + permissions; each role can be an IAM predefined role or + a user-created custom role. For some types of Google + Cloud resources, a binding can also specify a condition, + which is a logical expression that allows access to a + resource only if the expression evaluates to true. A + condition can add constraints based on attributes of the + request, the resource, or both. To learn which resources + support conditions in their IAM policies, see the [IAM + documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:\ mike@example.com - + group:\ admins@example.com - domain:google.com - + serviceAccount:\ my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:\ eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the [IAM + documentation](\ https://cloud.google.com/iam/docs/). """ # Create or coerce a protobuf request object. @@ -1259,31 +1193,21 @@ def set_labels( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/images/transports/rest.py b/google/cloud/compute_v1/services/images/transports/rest.py index 0995dd0a7..aaa1811cd 100644 --- a/google/cloud/compute_v1/services/images/transports/rest.py +++ b/google/cloud/compute_v1/services/images/transports/rest.py @@ -116,34 +116,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -191,34 +178,21 @@ def deprecate( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -274,11 +248,10 @@ def get( Returns: ~.compute.Image: - Represents an Image resource. - - You can use images to create boot disks for your VM - instances. For more information, read Images. (== - resource_for {$api_version}.images ==) + Represents an Image resource. You can + use images to create boot disks for your + VM instances. For more information, read + Images. """ @@ -324,11 +297,10 @@ def get_from_family( Returns: ~.compute.Image: - Represents an Image resource. - - You can use images to create boot disks for your VM - instances. For more information, read Images. (== - resource_for {$api_version}.images ==) + Represents an Image resource. You can + use images to create boot disks for your + VM instances. For more information, read + Images. """ @@ -375,28 +347,22 @@ def get_iam_policy( Returns: ~.compute.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A ``Policy`` is a collection of ``bindings``. A + specifies access controls for Google Cloud resources. A + ``Policy`` is a collection of ``bindings``. A ``binding`` binds one or more ``members`` to a single ``role``. Members can be user accounts, service accounts, Google groups, and domains (such as G Suite). A ``role`` is a named list of permissions; each ``role`` can be an IAM predefined role or a user-created custom - role. - - For some types of Google Cloud resources, a ``binding`` - can also specify a ``condition``, which is a logical - expression that allows access to a resource only if the - expression evaluates to ``true``. A condition can add - constraints based on attributes of the request, the + role. For some types of Google Cloud resources, a + ``binding`` can also specify a ``condition``, which is a + logical expression that allows access to a resource only + if the expression evaluates to ``true``. A condition can + add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the `IAM documentation `__. - - **JSON example:** - - { "bindings": [ { "role": + **JSON example:** { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", @@ -407,10 +373,7 @@ def get_iam_policy( "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": - "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - + "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com @@ -419,10 +382,9 @@ def get_iam_policy( roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the `IAM + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the `IAM documentation `__. """ @@ -472,34 +434,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -611,34 +560,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -696,28 +632,22 @@ def set_iam_policy( Returns: ~.compute.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A ``Policy`` is a collection of ``bindings``. A + specifies access controls for Google Cloud resources. A + ``Policy`` is a collection of ``bindings``. A ``binding`` binds one or more ``members`` to a single ``role``. Members can be user accounts, service accounts, Google groups, and domains (such as G Suite). A ``role`` is a named list of permissions; each ``role`` can be an IAM predefined role or a user-created custom - role. - - For some types of Google Cloud resources, a ``binding`` - can also specify a ``condition``, which is a logical - expression that allows access to a resource only if the - expression evaluates to ``true``. A condition can add - constraints based on attributes of the request, the + role. For some types of Google Cloud resources, a + ``binding`` can also specify a ``condition``, which is a + logical expression that allows access to a resource only + if the expression evaluates to ``true``. A condition can + add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the `IAM documentation `__. - - **JSON example:** - - { "bindings": [ { "role": + **JSON example:** { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", @@ -728,10 +658,7 @@ def set_iam_policy( "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": - "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - + "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com @@ -740,10 +667,9 @@ def set_iam_policy( roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the `IAM + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the `IAM documentation `__. """ @@ -799,34 +725,21 @@ def set_labels( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/instance_group_managers/client.py b/google/cloud/compute_v1/services/instance_group_managers/client.py index 0a66d5014..e54de72c2 100644 --- a/google/cloud/compute_v1/services/instance_group_managers/client.py +++ b/google/cloud/compute_v1/services/instance_group_managers/client.py @@ -352,17 +352,17 @@ def abandon_instances( the action is scheduled even if the instances have not yet been removed from the group. You must separately verify the status of the abandoning action with the - listmanagedinstances method. If the group is part of a + listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed - or deleted. - You can specify a maximum of 1000 instances with this - method per request. + or deleted. You can specify a maximum of 1000 instances + with this method per request. Args: request (google.cloud.compute_v1.types.AbandonInstancesInstanceGroupManagerRequest): - The request object. A request message for + The request object. Messages + A request message for InstanceGroupManagers.AbandonInstances. See the method description for details. project (str): @@ -397,31 +397,21 @@ def abandon_instances( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -596,31 +586,21 @@ def apply_updates_to_instances( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -734,31 +714,21 @@ def create_instances( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -855,31 +825,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -938,7 +898,7 @@ def delete_instances( action is scheduled even if the instances are still being deleted. You must separately verify the status of the deleting action with the listmanagedinstances - method. If the group is part of a backend service that + method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. @@ -982,31 +942,21 @@ def delete_instances( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1108,31 +1058,21 @@ def delete_per_instance_configs( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1237,20 +1177,15 @@ def get( Returns: google.cloud.compute_v1.types.InstanceGroupManager: - Represents a Managed Instance Group resource. - - An instance group is a collection of VM instances - that you can manage as a single entity. For more - information, read Instance groups. - - For zonal Managed Instance Group, use the - instanceGroupManagers resource. - - For regional Managed Instance Group, use the - regionInstanceGroupManagers resource. (== - resource_for {$api_version}.instanceGroupManagers ==) - (== resource_for - {$api_version}.regionInstanceGroupManagers ==) + Represents a Managed Instance Group + resource. An instance group is a + collection of VM instances that you can + manage as a single entity. For more + information, read Instance groups. For + zonal Managed Instance Group, use the + instanceGroupManagers resource. For + regional Managed Instance Group, use the + regionInstanceGroupManagers resource. """ # Create or coerce a protobuf request object. @@ -1306,7 +1241,7 @@ def insert( marked as DONE when the group is created even if the instances in the group have not yet been created. You must separately verify the status of the individual - instances with the listmanagedinstances method. A + instances with the listmanagedinstances method. A managed instance group can have up to 1000 VM instances per group. Please contact Cloud Support if you need an increase in this limit. @@ -1341,31 +1276,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1525,7 +1450,7 @@ def list_errors( The name of the managed instance group. It must be a string that meets the requirements in RFC1035, or an unsigned long integer: must match regexp pattern: - (?:`a-z `__?)|[1-9][0-9]{0,19}. + (?:`a-z `__?)|1-9{0,19}. This corresponds to the ``instance_group_manager`` field on the ``request`` instance; if ``request`` is provided, this @@ -1804,7 +1729,12 @@ def patch( status of the individual instances with the listManagedInstances method. This method supports PATCH semantics and uses the JSON merge patch format and - processing rules. + processing rules. If you update your group to specify a + new template or instance configuration, it's possible + that your intended specification for each VM in the + group is different from the current state of that VM. To + learn how to apply an updated configuration to the VMs + in a MIG, see Updating instances in a MIG. Args: request (google.cloud.compute_v1.types.PatchInstanceGroupManagerRequest): @@ -1843,31 +1773,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1966,31 +1886,21 @@ def patch_per_instance_configs( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -2068,7 +1978,7 @@ def recreate_instances( recreated. You must separately verify the status of each instance by checking its currentAction field; for more information, see Checking the status of managed - instances. If the group is part of a backend service + instances. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. @@ -2112,31 +2022,21 @@ def recreate_instances( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -2210,17 +2110,15 @@ def resize( When resizing down, the instance group arbitrarily chooses the order in which VMs are deleted. The group takes into account some VM attributes when making the - selection including: - + The status of the VM instance. + The health of the VM - instance. + The instance template version the VM is - based on. + For regional managed instance groups, the - location of the VM instance. - This list is subject to change. - - If the group is part of a backend service that has - enabled connection draining, it can take up to 60 - seconds after the connection draining duration has - elapsed before the VM instance is removed or deleted. + selection including: + The status of the VM instance. + + The health of the VM instance. + The instance template + version the VM is based on. + For regional managed + instance groups, the location of the VM instance. This + list is subject to change. If the group is part of a + backend service that has enabled connection draining, it + can take up to 60 seconds after the connection draining + duration has elapsed before the VM instance is removed + or deleted. Args: request (google.cloud.compute_v1.types.ResizeInstanceGroupManagerRequest): @@ -2265,31 +2163,21 @@ def resize( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -2384,31 +2272,21 @@ def set_instance_template( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -2520,31 +2398,21 @@ def set_target_pools( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -2648,31 +2516,21 @@ def update_per_instance_configs( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/instance_group_managers/transports/rest.py b/google/cloud/compute_v1/services/instance_group_managers/transports/rest.py index 723448416..714ff3f4a 100644 --- a/google/cloud/compute_v1/services/instance_group_managers/transports/rest.py +++ b/google/cloud/compute_v1/services/instance_group_managers/transports/rest.py @@ -108,7 +108,8 @@ def abandon_instances( Args: request (~.compute.AbandonInstancesInstanceGroupManagerRequest): - The request object. A request message for + The request object. Messages + A request message for InstanceGroupManagers.AbandonInstances. See the method description for details. @@ -117,34 +118,21 @@ def abandon_instances( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -270,34 +258,21 @@ def apply_updates_to_instances( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -355,34 +330,21 @@ def create_instances( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -442,34 +404,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -520,34 +469,21 @@ def delete_instances( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -608,34 +544,21 @@ def delete_per_instance_configs( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -693,20 +616,15 @@ def get( Returns: ~.compute.InstanceGroupManager: - Represents a Managed Instance Group resource. - - An instance group is a collection of VM instances that - you can manage as a single entity. For more information, - read Instance groups. - - For zonal Managed Instance Group, use the - instanceGroupManagers resource. - - For regional Managed Instance Group, use the - regionInstanceGroupManagers resource. (== resource_for - {$api_version}.instanceGroupManagers ==) (== - resource_for {$api_version}.regionInstanceGroupManagers - ==) + Represents a Managed Instance Group + resource. An instance group is a + collection of VM instances that you can + manage as a single entity. For more + information, read Instance groups. For + zonal Managed Instance Group, use the + instanceGroupManagers resource. For + regional Managed Instance Group, use the + regionInstanceGroupManagers resource. """ @@ -757,34 +675,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -1102,34 +1007,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -1190,34 +1082,21 @@ def patch_per_instance_configs( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -1280,34 +1159,21 @@ def recreate_instances( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -1367,34 +1233,21 @@ def resize( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -1446,34 +1299,21 @@ def set_instance_template( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -1533,34 +1373,21 @@ def set_target_pools( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -1621,34 +1448,21 @@ def update_per_instance_configs( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/instance_groups/client.py b/google/cloud/compute_v1/services/instance_groups/client.py index c861b2dc9..e57d98434 100644 --- a/google/cloud/compute_v1/services/instance_groups/client.py +++ b/google/cloud/compute_v1/services/instance_groups/client.py @@ -342,8 +342,8 @@ def add_instances( ) -> compute.Operation: r"""Adds a list of instances to the specified instance group. All of the instances in the instance group must - be in the same network/subnetwork. Read Adding - instances for more information. + be in the same network/subnetwork. Read Adding instances + for more information. Args: request (google.cloud.compute_v1.types.AddInstancesInstanceGroupRequest): @@ -382,31 +382,21 @@ def add_instances( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -540,7 +530,7 @@ def delete( ) -> compute.Operation: r"""Deletes the specified instance group. The instances in the group are not deleted. Note that instance group - must not belong to a backend service. Read Deleting an + must not belong to a backend service. Read Deleting an instance group for more information. Args: @@ -575,31 +565,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -650,7 +630,7 @@ def get( ) -> compute.InstanceGroup: r"""Returns the specified zonal instance group. Get a list of available zonal instance groups by making a - list() request. For managed instance groups, use the + list() request. For managed instance groups, use the instanceGroupManagers or regionInstanceGroupManagers methods instead. @@ -684,28 +664,20 @@ def get( Returns: google.cloud.compute_v1.types.InstanceGroup: - Represents an Instance Group resource. - - Instance Groups can be used to configure a target for - load balancing. - - Instance groups can either be managed or unmanaged. - - To create managed instance groups, use the - instanceGroupManager or regionInstanceGroupManager - resource instead. - - Use zonal unmanaged instance groups if you need to - apply load balancing to groups of heterogeneous - instances or if you need to manage the instances - yourself. You cannot create regional unmanaged - instance groups. - - For more information, read Instance groups. - - (== resource_for {$api_version}.instanceGroups ==) - (== resource_for {$api_version}.regionInstanceGroups - ==) + Represents an Instance Group + resource. Instance Groups can be used to + configure a target for load balancing. + Instance groups can either be managed or + unmanaged. To create managed instance + groups, use the instanceGroupManager or + regionInstanceGroupManager resource + instead. Use zonal unmanaged instance + groups if you need to apply load + balancing to groups of heterogeneous + instances or if you need to manage the + instances yourself. You cannot create + regional unmanaged instance groups. For + more information, read Instance groups. """ # Create or coerce a protobuf request object. @@ -787,31 +759,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -860,10 +822,9 @@ def list( metadata: Sequence[Tuple[str, str]] = (), ) -> pagers.ListPager: r"""Retrieves the list of zonal instance group resources - contained within the specified zone. - For managed instance groups, use the - instanceGroupManagers or regionInstanceGroupManagers - methods instead. + contained within the specified zone. For managed + instance groups, use the instanceGroupManagers or + regionInstanceGroupManagers methods instead. Args: request (google.cloud.compute_v1.types.ListInstanceGroupsRequest): @@ -1058,7 +1019,7 @@ def remove_instances( metadata: Sequence[Tuple[str, str]] = (), ) -> compute.Operation: r"""Removes one or more instances from the specified - instance group, but does not delete those instances. If + instance group, but does not delete those instances. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration before the VM instance @@ -1101,31 +1062,21 @@ def remove_instances( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1226,31 +1177,21 @@ def set_named_ports( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/instance_groups/transports/rest.py b/google/cloud/compute_v1/services/instance_groups/transports/rest.py index 2eb6550e6..23d9d33cc 100644 --- a/google/cloud/compute_v1/services/instance_groups/transports/rest.py +++ b/google/cloud/compute_v1/services/instance_groups/transports/rest.py @@ -117,34 +117,21 @@ def add_instances( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -266,34 +253,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -344,26 +318,20 @@ def get( Returns: ~.compute.InstanceGroup: - Represents an Instance Group resource. - - Instance Groups can be used to configure a target for - load balancing. - - Instance groups can either be managed or unmanaged. - - To create managed instance groups, use the - instanceGroupManager or regionInstanceGroupManager - resource instead. - - Use zonal unmanaged instance groups if you need to apply - load balancing to groups of heterogeneous instances or - if you need to manage the instances yourself. You cannot - create regional unmanaged instance groups. - - For more information, read Instance groups. - - (== resource_for {$api_version}.instanceGroups ==) (== - resource_for {$api_version}.regionInstanceGroups ==) + Represents an Instance Group + resource. Instance Groups can be used to + configure a target for load balancing. + Instance groups can either be managed or + unmanaged. To create managed instance + groups, use the instanceGroupManager or + regionInstanceGroupManager resource + instead. Use zonal unmanaged instance + groups if you need to apply load + balancing to groups of heterogeneous + instances or if you need to manage the + instances yourself. You cannot create + regional unmanaged instance groups. For + more information, read Instance groups. """ @@ -414,34 +382,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -624,34 +579,21 @@ def remove_instances( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -711,34 +653,21 @@ def set_named_ports( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/instance_templates/client.py b/google/cloud/compute_v1/services/instance_templates/client.py index f2e1ba721..d1f46e8f8 100644 --- a/google/cloud/compute_v1/services/instance_templates/client.py +++ b/google/cloud/compute_v1/services/instance_templates/client.py @@ -370,31 +370,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -467,12 +457,11 @@ def get( Returns: google.cloud.compute_v1.types.InstanceTemplate: - Represents an Instance Template resource. - - You can use instance templates to create VM instances - and managed instance groups. For more information, - read Instance Templates. (== resource_for - {$api_version}.instanceTemplates ==) + Represents an Instance Template + resource. You can use instance templates + to create VM instances and managed + instance groups. For more information, + read Instance Templates. """ # Create or coerce a protobuf request object. @@ -547,56 +536,44 @@ def get_iam_policy( Returns: google.cloud.compute_v1.types.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A Policy is a collection of bindings. A binding binds - one or more members to a single role. Members can be - user accounts, service accounts, Google groups, and - domains (such as G Suite). A role is a named list of - permissions; each role can be an IAM predefined role - or a user-created custom role. - - For some types of Google Cloud resources, a binding - can also specify a condition, which is a logical - expression that allows access to a resource only if - the expression evaluates to true. A condition can add - constraints based on attributes of the request, the - resource, or both. To learn which resources support - conditions in their IAM policies, see the [IAM - documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). - - **JSON example:** - - { "bindings": [ { "role": - "roles/resourcemanager.organizationAdmin", "members": - [ "user:mike@example.com", - "group:admins@example.com", "domain:google.com", - "serviceAccount:my-project-id@appspot.gserviceaccount.com" - ] }, { "role": - "roles/resourcemanager.organizationViewer", - "members": [ "user:eve@example.com" ], "condition": { - "title": "expirable access", "description": "Does not - grant access after Sep 2020", "expression": - "request.time < - timestamp('2020-10-01T00:00:00.000Z')", } } ], - "etag": "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - - bindings: - members: - user:\ mike@example.com - - group:\ admins@example.com - domain:google.com - - serviceAccount:\ my-project-id@appspot.gserviceaccount.com - role: roles/resourcemanager.organizationAdmin - - members: - user:\ eve@example.com role: - roles/resourcemanager.organizationViewer condition: - title: expirable access description: Does not grant - access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the - [IAM - documentation](\ https://cloud.google.com/iam/docs/). + specifies access controls for Google Cloud resources. A + Policy is a collection of bindings. A binding binds one + or more members to a single role. Members can be user + accounts, service accounts, Google groups, and domains + (such as G Suite). A role is a named list of + permissions; each role can be an IAM predefined role or + a user-created custom role. For some types of Google + Cloud resources, a binding can also specify a condition, + which is a logical expression that allows access to a + resource only if the expression evaluates to true. A + condition can add constraints based on attributes of the + request, the resource, or both. To learn which resources + support conditions in their IAM policies, see the [IAM + documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:\ mike@example.com - + group:\ admins@example.com - domain:google.com - + serviceAccount:\ my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:\ eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the [IAM + documentation](\ https://cloud.google.com/iam/docs/). """ # Create or coerce a protobuf request object. @@ -672,31 +649,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -850,56 +817,44 @@ def set_iam_policy( Returns: google.cloud.compute_v1.types.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A Policy is a collection of bindings. A binding binds - one or more members to a single role. Members can be - user accounts, service accounts, Google groups, and - domains (such as G Suite). A role is a named list of - permissions; each role can be an IAM predefined role - or a user-created custom role. - - For some types of Google Cloud resources, a binding - can also specify a condition, which is a logical - expression that allows access to a resource only if - the expression evaluates to true. A condition can add - constraints based on attributes of the request, the - resource, or both. To learn which resources support - conditions in their IAM policies, see the [IAM - documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). - - **JSON example:** - - { "bindings": [ { "role": - "roles/resourcemanager.organizationAdmin", "members": - [ "user:mike@example.com", - "group:admins@example.com", "domain:google.com", - "serviceAccount:my-project-id@appspot.gserviceaccount.com" - ] }, { "role": - "roles/resourcemanager.organizationViewer", - "members": [ "user:eve@example.com" ], "condition": { - "title": "expirable access", "description": "Does not - grant access after Sep 2020", "expression": - "request.time < - timestamp('2020-10-01T00:00:00.000Z')", } } ], - "etag": "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - - bindings: - members: - user:\ mike@example.com - - group:\ admins@example.com - domain:google.com - - serviceAccount:\ my-project-id@appspot.gserviceaccount.com - role: roles/resourcemanager.organizationAdmin - - members: - user:\ eve@example.com role: - roles/resourcemanager.organizationViewer condition: - title: expirable access description: Does not grant - access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the - [IAM - documentation](\ https://cloud.google.com/iam/docs/). + specifies access controls for Google Cloud resources. A + Policy is a collection of bindings. A binding binds one + or more members to a single role. Members can be user + accounts, service accounts, Google groups, and domains + (such as G Suite). A role is a named list of + permissions; each role can be an IAM predefined role or + a user-created custom role. For some types of Google + Cloud resources, a binding can also specify a condition, + which is a logical expression that allows access to a + resource only if the expression evaluates to true. A + condition can add constraints based on attributes of the + request, the resource, or both. To learn which resources + support conditions in their IAM policies, see the [IAM + documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:\ mike@example.com - + group:\ admins@example.com - domain:google.com - + serviceAccount:\ my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:\ eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the [IAM + documentation](\ https://cloud.google.com/iam/docs/). """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/instance_templates/transports/rest.py b/google/cloud/compute_v1/services/instance_templates/transports/rest.py index 494c31c75..3d255efaf 100644 --- a/google/cloud/compute_v1/services/instance_templates/transports/rest.py +++ b/google/cloud/compute_v1/services/instance_templates/transports/rest.py @@ -117,34 +117,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -194,12 +181,11 @@ def get( Returns: ~.compute.InstanceTemplate: - Represents an Instance Template resource. - - You can use instance templates to create VM instances - and managed instance groups. For more information, read - Instance Templates. (== resource_for - {$api_version}.instanceTemplates ==) + Represents an Instance Template + resource. You can use instance templates + to create VM instances and managed + instance groups. For more information, + read Instance Templates. """ @@ -250,28 +236,22 @@ def get_iam_policy( Returns: ~.compute.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A ``Policy`` is a collection of ``bindings``. A + specifies access controls for Google Cloud resources. A + ``Policy`` is a collection of ``bindings``. A ``binding`` binds one or more ``members`` to a single ``role``. Members can be user accounts, service accounts, Google groups, and domains (such as G Suite). A ``role`` is a named list of permissions; each ``role`` can be an IAM predefined role or a user-created custom - role. - - For some types of Google Cloud resources, a ``binding`` - can also specify a ``condition``, which is a logical - expression that allows access to a resource only if the - expression evaluates to ``true``. A condition can add - constraints based on attributes of the request, the + role. For some types of Google Cloud resources, a + ``binding`` can also specify a ``condition``, which is a + logical expression that allows access to a resource only + if the expression evaluates to ``true``. A condition can + add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the `IAM documentation `__. - - **JSON example:** - - { "bindings": [ { "role": + **JSON example:** { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", @@ -282,10 +262,7 @@ def get_iam_policy( "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": - "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - + "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com @@ -294,10 +271,9 @@ def get_iam_policy( roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the `IAM + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the `IAM documentation `__. """ @@ -351,34 +327,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -493,28 +456,22 @@ def set_iam_policy( Returns: ~.compute.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A ``Policy`` is a collection of ``bindings``. A + specifies access controls for Google Cloud resources. A + ``Policy`` is a collection of ``bindings``. A ``binding`` binds one or more ``members`` to a single ``role``. Members can be user accounts, service accounts, Google groups, and domains (such as G Suite). A ``role`` is a named list of permissions; each ``role`` can be an IAM predefined role or a user-created custom - role. - - For some types of Google Cloud resources, a ``binding`` - can also specify a ``condition``, which is a logical - expression that allows access to a resource only if the - expression evaluates to ``true``. A condition can add - constraints based on attributes of the request, the + role. For some types of Google Cloud resources, a + ``binding`` can also specify a ``condition``, which is a + logical expression that allows access to a resource only + if the expression evaluates to ``true``. A condition can + add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the `IAM documentation `__. - - **JSON example:** - - { "bindings": [ { "role": + **JSON example:** { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", @@ -525,10 +482,7 @@ def set_iam_policy( "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": - "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - + "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com @@ -537,10 +491,9 @@ def set_iam_policy( roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the `IAM + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the `IAM documentation `__. """ diff --git a/google/cloud/compute_v1/services/instances/client.py b/google/cloud/compute_v1/services/instances/client.py index 3f58a290d..1a7054c7f 100644 --- a/google/cloud/compute_v1/services/instances/client.py +++ b/google/cloud/compute_v1/services/instances/client.py @@ -384,31 +384,21 @@ def add_access_config( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -503,31 +493,21 @@ def add_resource_policies( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -580,8 +560,11 @@ def aggregated_list( timeout: float = None, metadata: Sequence[Tuple[str, str]] = (), ) -> pagers.AggregatedListPager: - r"""Retrieves aggregated list of all of the instances in - your project across all regions and zones. + r"""Retrieves an aggregated list of all of the instances + in your project across all regions and zones. The + performance of this method degrades when a filter is + specified on a project that has a very large number of + instances. Args: request (google.cloud.compute_v1.types.AggregatedListInstancesRequest): @@ -696,31 +679,21 @@ def attach_disk( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -804,31 +777,21 @@ def bulk_insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -916,31 +879,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1036,31 +989,21 @@ def delete_access_config( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1157,31 +1100,21 @@ def detach_disk( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1266,12 +1199,11 @@ def get( Returns: google.cloud.compute_v1.types.Instance: - Represents an Instance resource. - - An instance is a virtual machine that is hosted on - Google Cloud Platform. For more information, read - Virtual Machine Instances. (== resource_for - {$api_version}.instances ==) + Represents an Instance resource. An + instance is a virtual machine that is + hosted on Google Cloud Platform. For + more information, read Virtual Machine + Instances. """ # Create or coerce a protobuf request object. @@ -1531,56 +1463,44 @@ def get_iam_policy( Returns: google.cloud.compute_v1.types.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A Policy is a collection of bindings. A binding binds - one or more members to a single role. Members can be - user accounts, service accounts, Google groups, and - domains (such as G Suite). A role is a named list of - permissions; each role can be an IAM predefined role - or a user-created custom role. - - For some types of Google Cloud resources, a binding - can also specify a condition, which is a logical - expression that allows access to a resource only if - the expression evaluates to true. A condition can add - constraints based on attributes of the request, the - resource, or both. To learn which resources support - conditions in their IAM policies, see the [IAM - documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). - - **JSON example:** - - { "bindings": [ { "role": - "roles/resourcemanager.organizationAdmin", "members": - [ "user:mike@example.com", - "group:admins@example.com", "domain:google.com", - "serviceAccount:my-project-id@appspot.gserviceaccount.com" - ] }, { "role": - "roles/resourcemanager.organizationViewer", - "members": [ "user:eve@example.com" ], "condition": { - "title": "expirable access", "description": "Does not - grant access after Sep 2020", "expression": - "request.time < - timestamp('2020-10-01T00:00:00.000Z')", } } ], - "etag": "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - - bindings: - members: - user:\ mike@example.com - - group:\ admins@example.com - domain:google.com - - serviceAccount:\ my-project-id@appspot.gserviceaccount.com - role: roles/resourcemanager.organizationAdmin - - members: - user:\ eve@example.com role: - roles/resourcemanager.organizationViewer condition: - title: expirable access description: Does not grant - access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the - [IAM - documentation](\ https://cloud.google.com/iam/docs/). + specifies access controls for Google Cloud resources. A + Policy is a collection of bindings. A binding binds one + or more members to a single role. Members can be user + accounts, service accounts, Google groups, and domains + (such as G Suite). A role is a named list of + permissions; each role can be an IAM predefined role or + a user-created custom role. For some types of Google + Cloud resources, a binding can also specify a condition, + which is a logical expression that allows access to a + resource only if the expression evaluates to true. A + condition can add constraints based on attributes of the + request, the resource, or both. To learn which resources + support conditions in their IAM policies, see the [IAM + documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:\ mike@example.com - + group:\ admins@example.com - domain:google.com - + serviceAccount:\ my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:\ eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the [IAM + documentation](\ https://cloud.google.com/iam/docs/). """ # Create or coerce a protobuf request object. @@ -1746,7 +1666,7 @@ def get_serial_port_output( Returns: google.cloud.compute_v1.types.SerialPortOutput: - An instance's serial console output. + An instance serial console output. """ # Create or coerce a protobuf request object. # Sanity check: If we got a request object, we should *not* have @@ -1828,7 +1748,7 @@ def get_shielded_instance_identity( Returns: google.cloud.compute_v1.types.ShieldedInstanceIdentity: - A shielded Instance identity entry. + A Shielded Instance Identity. """ # Create or coerce a protobuf request object. # Sanity check: If we got a request object, we should *not* have @@ -1911,31 +1831,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -2204,31 +2114,21 @@ def remove_resource_policies( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -2323,31 +2223,106 @@ def reset( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. - Google Compute Engine has three Operation resources: + """ + # Create or coerce a protobuf request object. + # Sanity check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any([project, zone, instance]) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + # Minor optimization to avoid making a copy if the user passes + # in a compute.ResetInstanceRequest. + # There's no risk of modifying the input as we've already verified + # there are no flattened fields. + if not isinstance(request, compute.ResetInstanceRequest): + request = compute.ResetInstanceRequest(request) + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if project is not None: + request.project = project + if zone is not None: + request.zone = zone + if instance is not None: + request.instance = instance + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = self._transport._wrapped_methods[self._transport.reset] + + # Send the request. + response = rpc(request, retry=retry, timeout=timeout, metadata=metadata,) + + # Done; return the response. + return response - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) + def send_diagnostic_interrupt( + self, + request: compute.SendDiagnosticInterruptInstanceRequest = None, + *, + project: str = None, + zone: str = None, + instance: str = None, + retry: retries.Retry = gapic_v1.method.DEFAULT, + timeout: float = None, + metadata: Sequence[Tuple[str, str]] = (), + ) -> compute.SendDiagnosticInterruptInstanceResponse: + r"""Sends diagnostic interrupt to the instance. - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. + Args: + request (google.cloud.compute_v1.types.SendDiagnosticInterruptInstanceRequest): + The request object. A request message for + Instances.SendDiagnosticInterrupt. See the method + description for details. + project (str): + Project ID for this request. + This corresponds to the ``project`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + zone (str): + The name of the zone for this + request. - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. + This corresponds to the ``zone`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + instance (str): + Name of the instance scoping this + request. + + This corresponds to the ``instance`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Returns: + google.cloud.compute_v1.types.SendDiagnosticInterruptInstanceResponse: + A response message for + Instances.SendDiagnosticInterrupt. See + the method description for details. """ # Create or coerce a protobuf request object. @@ -2361,11 +2336,11 @@ def reset( ) # Minor optimization to avoid making a copy if the user passes - # in a compute.ResetInstanceRequest. + # in a compute.SendDiagnosticInterruptInstanceRequest. # There's no risk of modifying the input as we've already verified # there are no flattened fields. - if not isinstance(request, compute.ResetInstanceRequest): - request = compute.ResetInstanceRequest(request) + if not isinstance(request, compute.SendDiagnosticInterruptInstanceRequest): + request = compute.SendDiagnosticInterruptInstanceRequest(request) # If we have keyword arguments corresponding to fields on the # request, apply these. if project is not None: @@ -2377,7 +2352,9 @@ def reset( # Wrap the RPC method; this adds retry and timeout information, # and friendly error handling. - rpc = self._transport._wrapped_methods[self._transport.reset] + rpc = self._transport._wrapped_methods[ + self._transport.send_diagnostic_interrupt + ] # Send the request. response = rpc(request, retry=retry, timeout=timeout, metadata=metadata,) @@ -2430,31 +2407,21 @@ def set_deletion_protection( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -2554,31 +2521,21 @@ def set_disk_auto_delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -2673,56 +2630,44 @@ def set_iam_policy( Returns: google.cloud.compute_v1.types.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A Policy is a collection of bindings. A binding binds - one or more members to a single role. Members can be - user accounts, service accounts, Google groups, and - domains (such as G Suite). A role is a named list of - permissions; each role can be an IAM predefined role - or a user-created custom role. - - For some types of Google Cloud resources, a binding - can also specify a condition, which is a logical - expression that allows access to a resource only if - the expression evaluates to true. A condition can add - constraints based on attributes of the request, the - resource, or both. To learn which resources support - conditions in their IAM policies, see the [IAM - documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). - - **JSON example:** - - { "bindings": [ { "role": - "roles/resourcemanager.organizationAdmin", "members": - [ "user:mike@example.com", - "group:admins@example.com", "domain:google.com", - "serviceAccount:my-project-id@appspot.gserviceaccount.com" - ] }, { "role": - "roles/resourcemanager.organizationViewer", - "members": [ "user:eve@example.com" ], "condition": { - "title": "expirable access", "description": "Does not - grant access after Sep 2020", "expression": - "request.time < - timestamp('2020-10-01T00:00:00.000Z')", } } ], - "etag": "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - - bindings: - members: - user:\ mike@example.com - - group:\ admins@example.com - domain:google.com - - serviceAccount:\ my-project-id@appspot.gserviceaccount.com - role: roles/resourcemanager.organizationAdmin - - members: - user:\ eve@example.com role: - roles/resourcemanager.organizationViewer condition: - title: expirable access description: Does not grant - access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the - [IAM - documentation](\ https://cloud.google.com/iam/docs/). + specifies access controls for Google Cloud resources. A + Policy is a collection of bindings. A binding binds one + or more members to a single role. Members can be user + accounts, service accounts, Google groups, and domains + (such as G Suite). A role is a named list of + permissions; each role can be an IAM predefined role or + a user-created custom role. For some types of Google + Cloud resources, a binding can also specify a condition, + which is a logical expression that allows access to a + resource only if the expression evaluates to true. A + condition can add constraints based on attributes of the + request, the resource, or both. To learn which resources + support conditions in their IAM policies, see the [IAM + documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:\ mike@example.com - + group:\ admins@example.com - domain:google.com - + serviceAccount:\ my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:\ eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the [IAM + documentation](\ https://cloud.google.com/iam/docs/). """ # Create or coerce a protobuf request object. @@ -2818,31 +2763,21 @@ def set_labels( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -2938,31 +2873,21 @@ def set_machine_resources( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -3058,31 +2983,21 @@ def set_machine_type( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -3178,31 +3093,21 @@ def set_metadata( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -3296,31 +3201,21 @@ def set_min_cpu_platform( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -3416,31 +3311,21 @@ def set_scheduling( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -3533,31 +3418,21 @@ def set_service_account( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -3655,31 +3530,21 @@ def set_shielded_instance_integrity_policy( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -3779,31 +3644,21 @@ def set_tags( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -3888,31 +3743,21 @@ def simulate_maintenance_event( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -3998,31 +3843,21 @@ def start( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -4113,31 +3948,21 @@ def start_with_encryption_key( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -4238,31 +4063,21 @@ def stop( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -4409,7 +4224,7 @@ def update( ) -> compute.Operation: r"""Updates an instance only if the necessary resources are available. This method can update only a specific - set of instance properties. See Updating a running + set of instance properties. See Updating a running instance for a list of updatable instance properties. Args: @@ -4449,31 +4264,21 @@ def update( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -4573,31 +4378,21 @@ def update_access_config( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -4695,31 +4490,21 @@ def update_display_device( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -4822,31 +4607,21 @@ def update_network_interface( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -4944,31 +4719,21 @@ def update_shielded_instance_config( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/instances/transports/base.py b/google/cloud/compute_v1/services/instances/transports/base.py index d5158fc8a..eb2efb4c6 100644 --- a/google/cloud/compute_v1/services/instances/transports/base.py +++ b/google/cloud/compute_v1/services/instances/transports/base.py @@ -232,6 +232,11 @@ def _prep_wrapped_messages(self, client_info): self.reset: gapic_v1.method.wrap_method( self.reset, default_timeout=None, client_info=client_info, ), + self.send_diagnostic_interrupt: gapic_v1.method.wrap_method( + self.send_diagnostic_interrupt, + default_timeout=None, + client_info=client_info, + ), self.set_deletion_protection: gapic_v1.method.wrap_method( self.set_deletion_protection, default_timeout=None, @@ -512,6 +517,18 @@ def reset( ]: raise NotImplementedError() + @property + def send_diagnostic_interrupt( + self, + ) -> Callable[ + [compute.SendDiagnosticInterruptInstanceRequest], + Union[ + compute.SendDiagnosticInterruptInstanceResponse, + Awaitable[compute.SendDiagnosticInterruptInstanceResponse], + ], + ]: + raise NotImplementedError() + @property def set_deletion_protection( self, diff --git a/google/cloud/compute_v1/services/instances/transports/rest.py b/google/cloud/compute_v1/services/instances/transports/rest.py index af8df32fd..ee426afa0 100644 --- a/google/cloud/compute_v1/services/instances/transports/rest.py +++ b/google/cloud/compute_v1/services/instances/transports/rest.py @@ -117,34 +117,21 @@ def add_access_config( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -205,34 +192,21 @@ def add_resource_policies( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -351,34 +325,21 @@ def attach_disk( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -440,34 +401,21 @@ def bulk_insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -524,34 +472,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -602,34 +537,21 @@ def delete_access_config( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -682,34 +604,21 @@ def detach_disk( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -760,12 +669,11 @@ def get( Returns: ~.compute.Instance: - Represents an Instance resource. - - An instance is a virtual machine that is hosted on - Google Cloud Platform. For more information, read - Virtual Machine Instances. (== resource_for - {$api_version}.instances ==) + Represents an Instance resource. An + instance is a virtual machine that is + hosted on Google Cloud Platform. For + more information, read Virtual Machine + Instances. """ @@ -920,28 +828,22 @@ def get_iam_policy( Returns: ~.compute.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A ``Policy`` is a collection of ``bindings``. A + specifies access controls for Google Cloud resources. A + ``Policy`` is a collection of ``bindings``. A ``binding`` binds one or more ``members`` to a single ``role``. Members can be user accounts, service accounts, Google groups, and domains (such as G Suite). A ``role`` is a named list of permissions; each ``role`` can be an IAM predefined role or a user-created custom - role. - - For some types of Google Cloud resources, a ``binding`` - can also specify a ``condition``, which is a logical - expression that allows access to a resource only if the - expression evaluates to ``true``. A condition can add - constraints based on attributes of the request, the + role. For some types of Google Cloud resources, a + ``binding`` can also specify a ``condition``, which is a + logical expression that allows access to a resource only + if the expression evaluates to ``true``. A condition can + add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the `IAM documentation `__. - - **JSON example:** - - { "bindings": [ { "role": + **JSON example:** { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", @@ -952,10 +854,7 @@ def get_iam_policy( "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": - "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - + "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com @@ -964,10 +863,9 @@ def get_iam_policy( roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the `IAM + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the `IAM documentation `__. """ @@ -1074,7 +972,7 @@ def get_serial_port_output( Returns: ~.compute.SerialPortOutput: - An instance's serial console output. + An instance serial console output. """ # TODO(yon-mg): need to handle grpc transcoding and parse url correctly @@ -1129,7 +1027,7 @@ def get_shielded_instance_identity( Returns: ~.compute.ShieldedInstanceIdentity: - A shielded Instance identity entry. + A Shielded Instance Identity. """ # TODO(yon-mg): need to handle grpc transcoding and parse url correctly @@ -1179,34 +1077,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -1383,34 +1268,21 @@ def remove_resource_policies( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -1470,34 +1342,21 @@ def reset( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -1529,6 +1388,59 @@ def reset( # Return the response return compute.Operation.from_json(response.content, ignore_unknown_fields=True) + def send_diagnostic_interrupt( + self, + request: compute.SendDiagnosticInterruptInstanceRequest, + *, + metadata: Sequence[Tuple[str, str]] = (), + ) -> compute.SendDiagnosticInterruptInstanceResponse: + r"""Call the send diagnostic interrupt method over HTTP. + + Args: + request (~.compute.SendDiagnosticInterruptInstanceRequest): + The request object. A request message for + Instances.SendDiagnosticInterrupt. See + the method description for details. + + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + ~.compute.SendDiagnosticInterruptInstanceResponse: + A response message for + Instances.SendDiagnosticInterrupt. See + the method description for details. + + """ + + # TODO(yon-mg): need to handle grpc transcoding and parse url correctly + # current impl assumes basic case of grpc transcoding + url = "https://{host}/compute/v1/projects/{project}/zones/{zone}/instances/{instance}/sendDiagnosticInterrupt".format( + host=self._host, + project=request.project, + zone=request.zone, + instance=request.instance, + ) + + # TODO(yon-mg): handle nested fields corerctly rather than using only top level fields + # not required for GCE + query_params = {} + + # Send the request + headers = dict(metadata) + headers["Content-Type"] = "application/json" + response = self._session.post(url, headers=headers, params=query_params,) + + # In case of error, raise the appropriate core_exceptions.GoogleAPICallError exception + # subclass. + if response.status_code >= 400: + raise core_exceptions.from_http_response(response) + + # Return the response + return compute.SendDiagnosticInterruptInstanceResponse.from_json( + response.content, ignore_unknown_fields=True + ) + def set_deletion_protection( self, request: compute.SetDeletionProtectionInstanceRequest, @@ -1548,34 +1460,21 @@ def set_deletion_protection( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -1628,34 +1527,21 @@ def set_disk_auto_delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -1709,28 +1595,22 @@ def set_iam_policy( Returns: ~.compute.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A ``Policy`` is a collection of ``bindings``. A + specifies access controls for Google Cloud resources. A + ``Policy`` is a collection of ``bindings``. A ``binding`` binds one or more ``members`` to a single ``role``. Members can be user accounts, service accounts, Google groups, and domains (such as G Suite). A ``role`` is a named list of permissions; each ``role`` can be an IAM predefined role or a user-created custom - role. - - For some types of Google Cloud resources, a ``binding`` - can also specify a ``condition``, which is a logical - expression that allows access to a resource only if the - expression evaluates to ``true``. A condition can add - constraints based on attributes of the request, the + role. For some types of Google Cloud resources, a + ``binding`` can also specify a ``condition``, which is a + logical expression that allows access to a resource only + if the expression evaluates to ``true``. A condition can + add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the `IAM documentation `__. - - **JSON example:** - - { "bindings": [ { "role": + **JSON example:** { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", @@ -1741,10 +1621,7 @@ def set_iam_policy( "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": - "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - + "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com @@ -1753,10 +1630,9 @@ def set_iam_policy( roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the `IAM + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the `IAM documentation `__. """ @@ -1815,34 +1691,21 @@ def set_labels( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -1902,34 +1765,21 @@ def set_machine_resources( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -1989,34 +1839,21 @@ def set_machine_type( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -2076,34 +1913,21 @@ def set_metadata( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -2163,34 +1987,21 @@ def set_min_cpu_platform( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -2250,34 +2061,21 @@ def set_scheduling( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -2337,34 +2135,21 @@ def set_service_account( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -2425,34 +2210,21 @@ def set_shielded_instance_integrity_policy( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -2515,34 +2287,21 @@ def set_tags( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -2603,34 +2362,21 @@ def simulate_maintenance_event( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -2679,34 +2425,21 @@ def start( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -2757,34 +2490,21 @@ def start_with_encryption_key( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -2843,34 +2563,21 @@ def stop( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -2980,34 +2687,21 @@ def update( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -3073,34 +2767,21 @@ def update_access_config( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -3161,34 +2842,21 @@ def update_display_device( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -3248,34 +2916,21 @@ def update_network_interface( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -3337,34 +2992,21 @@ def update_shielded_instance_config( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/interconnect_attachments/client.py b/google/cloud/compute_v1/services/interconnect_attachments/client.py index d52aab4cd..7374b5011 100644 --- a/google/cloud/compute_v1/services/interconnect_attachments/client.py +++ b/google/cloud/compute_v1/services/interconnect_attachments/client.py @@ -447,31 +447,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -552,14 +542,14 @@ def get( Returns: google.cloud.compute_v1.types.InterconnectAttachment: - Represents an Interconnect Attachment (VLAN) resource. - - You can use Interconnect attachments (VLANS) to - connect your Virtual Private Cloud networks to your - on-premises networks through an Interconnect. For - more information, read Creating VLAN Attachments. (== - resource_for {$api_version}.interconnectAttachments - ==) + Represents an Interconnect Attachment + (VLAN) resource. You can use + Interconnect attachments (VLANS) to + connect your Virtual Private Cloud + networks to your on-premises networks + through an Interconnect. For more + information, read Creating VLAN + Attachments. """ # Create or coerce a protobuf request object. @@ -639,31 +629,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -839,31 +819,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/interconnect_attachments/transports/rest.py b/google/cloud/compute_v1/services/interconnect_attachments/transports/rest.py index 7ad833014..192e5f837 100644 --- a/google/cloud/compute_v1/services/interconnect_attachments/transports/rest.py +++ b/google/cloud/compute_v1/services/interconnect_attachments/transports/rest.py @@ -182,34 +182,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -260,13 +247,14 @@ def get( Returns: ~.compute.InterconnectAttachment: - Represents an Interconnect Attachment (VLAN) resource. - - You can use Interconnect attachments (VLANS) to connect - your Virtual Private Cloud networks to your on-premises - networks through an Interconnect. For more information, - read Creating VLAN Attachments. (== resource_for - {$api_version}.interconnectAttachments ==) + Represents an Interconnect Attachment + (VLAN) resource. You can use + Interconnect attachments (VLANS) to + connect your Virtual Private Cloud + networks to your on-premises networks + through an Interconnect. For more + information, read Creating VLAN + Attachments. """ @@ -317,34 +305,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -463,34 +438,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/interconnect_locations/client.py b/google/cloud/compute_v1/services/interconnect_locations/client.py index 8a22f3ca3..ddfa9ff8d 100644 --- a/google/cloud/compute_v1/services/interconnect_locations/client.py +++ b/google/cloud/compute_v1/services/interconnect_locations/client.py @@ -370,12 +370,12 @@ def get( Returns: google.cloud.compute_v1.types.InterconnectLocation: Represents an Interconnect Attachment - (VLAN) Location resource. - You can use this resource to find - location details about an Interconnect - attachment (VLAN). For more information - about interconnect attachments, read - Creating VLAN Attachments. + (VLAN) Location resource. You can use + this resource to find location details + about an Interconnect attachment (VLAN). + For more information about interconnect + attachments, read Creating VLAN + Attachments. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/interconnect_locations/transports/rest.py b/google/cloud/compute_v1/services/interconnect_locations/transports/rest.py index 2a0a9ba60..6834bbaaa 100644 --- a/google/cloud/compute_v1/services/interconnect_locations/transports/rest.py +++ b/google/cloud/compute_v1/services/interconnect_locations/transports/rest.py @@ -118,12 +118,12 @@ def get( Returns: ~.compute.InterconnectLocation: Represents an Interconnect Attachment - (VLAN) Location resource. - You can use this resource to find - location details about an Interconnect - attachment (VLAN). For more information - about interconnect attachments, read - Creating VLAN Attachments. + (VLAN) Location resource. You can use + this resource to find location details + about an Interconnect attachment (VLAN). + For more information about interconnect + attachments, read Creating VLAN + Attachments. """ diff --git a/google/cloud/compute_v1/services/interconnects/client.py b/google/cloud/compute_v1/services/interconnects/client.py index 990e41185..3f901999c 100644 --- a/google/cloud/compute_v1/services/interconnects/client.py +++ b/google/cloud/compute_v1/services/interconnects/client.py @@ -361,31 +361,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -458,12 +448,11 @@ def get( Returns: google.cloud.compute_v1.types.Interconnect: Represents an Interconnect resource. - - An Interconnect resource is a dedicated connection - between the GCP network and your on-premises network. - For more information, read the Dedicated Interconnect - Overview. (== resource_for - {$api_version}.interconnects ==) + An Interconnect resource is a dedicated + connection between the GCP network and + your on-premises network. For more + information, read the Dedicated + Interconnect Overview. """ # Create or coerce a protobuf request object. @@ -610,31 +599,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -788,31 +767,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/interconnects/transports/rest.py b/google/cloud/compute_v1/services/interconnects/transports/rest.py index 36167e41a..312b6b479 100644 --- a/google/cloud/compute_v1/services/interconnects/transports/rest.py +++ b/google/cloud/compute_v1/services/interconnects/transports/rest.py @@ -117,34 +117,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -193,12 +180,11 @@ def get( Returns: ~.compute.Interconnect: Represents an Interconnect resource. - - An Interconnect resource is a dedicated connection - between the GCP network and your on-premises network. - For more information, read the Dedicated Interconnect - Overview. (== resource_for {$api_version}.interconnects - ==) + An Interconnect resource is a dedicated + connection between the GCP network and + your on-premises network. For more + information, read the Dedicated + Interconnect Overview. """ @@ -295,34 +281,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -438,34 +411,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/license_codes/client.py b/google/cloud/compute_v1/services/license_codes/client.py index 19c0bf585..f2039cf9a 100644 --- a/google/cloud/compute_v1/services/license_codes/client.py +++ b/google/cloud/compute_v1/services/license_codes/client.py @@ -335,11 +335,10 @@ def get( timeout: float = None, metadata: Sequence[Tuple[str, str]] = (), ) -> compute.LicenseCode: - r"""Return a specified license code. License codes are - mirrored across all projects that have permissions to - read the License Code. Caution This resource is - intended for use only by third-party partners who are - creating Cloud Marketplace images. + r"""Return a specified license code. License codes are mirrored + across all projects that have permissions to read the License + Code. *Caution* This resource is intended for use only by + third-party partners who are creating Cloud Marketplace images. Args: request (google.cloud.compute_v1.types.GetLicenseCodeRequest): @@ -366,13 +365,11 @@ def get( Returns: google.cloud.compute_v1.types.LicenseCode: - Represents a License Code resource. - - A License Code is a unique identifier used to - represent a license resource. Caution This resource - is intended for use only by third-party partners who - are creating Cloud Marketplace images. (== - resource_for {$api_version}.licenseCodes ==) + Represents a License Code resource. A License Code is a + unique identifier used to represent a license resource. + *Caution* This resource is intended for use only by + third-party partners who are creating Cloud Marketplace + images. """ # Create or coerce a protobuf request object. @@ -419,10 +416,9 @@ def test_iam_permissions( timeout: float = None, metadata: Sequence[Tuple[str, str]] = (), ) -> compute.TestPermissionsResponse: - r"""Returns permissions that a caller has on the - specified resource. Caution This resource is intended - for use only by third-party partners who are creating - Cloud Marketplace images. + r"""Returns permissions that a caller has on the specified resource. + *Caution* This resource is intended for use only by third-party + partners who are creating Cloud Marketplace images. Args: request (google.cloud.compute_v1.types.TestIamPermissionsLicenseCodeRequest): diff --git a/google/cloud/compute_v1/services/license_codes/transports/rest.py b/google/cloud/compute_v1/services/license_codes/transports/rest.py index c62ef553e..86406d82c 100644 --- a/google/cloud/compute_v1/services/license_codes/transports/rest.py +++ b/google/cloud/compute_v1/services/license_codes/transports/rest.py @@ -117,13 +117,11 @@ def get( Returns: ~.compute.LicenseCode: - Represents a License Code resource. - - A License Code is a unique identifier used to represent - a license resource. Caution This resource is intended - for use only by third-party partners who are creating - Cloud Marketplace images. (== resource_for - {$api_version}.licenseCodes ==) + Represents a License Code resource. A License Code is a + unique identifier used to represent a license resource. + *Caution* This resource is intended for use only by + third-party partners who are creating Cloud Marketplace + images. """ diff --git a/google/cloud/compute_v1/services/licenses/client.py b/google/cloud/compute_v1/services/licenses/client.py index d6edd0887..624abc16e 100644 --- a/google/cloud/compute_v1/services/licenses/client.py +++ b/google/cloud/compute_v1/services/licenses/client.py @@ -336,9 +336,9 @@ def delete( timeout: float = None, metadata: Sequence[Tuple[str, str]] = (), ) -> compute.Operation: - r"""Deletes the specified license. Caution This resource - is intended for use only by third-party partners who are - creating Cloud Marketplace images. + r"""Deletes the specified license. *Caution* This resource is + intended for use only by third-party partners who are creating + Cloud Marketplace images. Args: request (google.cloud.compute_v1.types.DeleteLicenseRequest): @@ -364,31 +364,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -434,9 +424,9 @@ def get( timeout: float = None, metadata: Sequence[Tuple[str, str]] = (), ) -> compute.License: - r"""Returns the specified License resource. Caution This - resource is intended for use only by third-party - partners who are creating Cloud Marketplace images. + r"""Returns the specified License resource. *Caution* This resource + is intended for use only by third-party partners who are + creating Cloud Marketplace images. Args: request (google.cloud.compute_v1.types.GetLicenseRequest): @@ -462,13 +452,11 @@ def get( Returns: google.cloud.compute_v1.types.License: - Represents a License resource. - - A License represents billing and aggregate usage data - for public and marketplace images. Caution This - resource is intended for use only by third-party - partners who are creating Cloud Marketplace images. - (== resource_for {$api_version}.licenses ==) + Represents a License resource. A License represents + billing and aggregate usage data for public and + marketplace images. *Caution* This resource is intended + for use only by third-party partners who are creating + Cloud Marketplace images. """ # Create or coerce a protobuf request object. @@ -514,10 +502,10 @@ def get_iam_policy( timeout: float = None, metadata: Sequence[Tuple[str, str]] = (), ) -> compute.Policy: - r"""Gets the access control policy for a resource. May be - empty if no such policy or resource exists. Caution - This resource is intended for use only by third-party - partners who are creating Cloud Marketplace images. + r"""Gets the access control policy for a resource. May be empty if + no such policy or resource exists. *Caution* This resource is + intended for use only by third-party partners who are creating + Cloud Marketplace images. Args: request (google.cloud.compute_v1.types.GetIamPolicyLicenseRequest): @@ -545,56 +533,44 @@ def get_iam_policy( Returns: google.cloud.compute_v1.types.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A Policy is a collection of bindings. A binding binds - one or more members to a single role. Members can be - user accounts, service accounts, Google groups, and - domains (such as G Suite). A role is a named list of - permissions; each role can be an IAM predefined role - or a user-created custom role. - - For some types of Google Cloud resources, a binding - can also specify a condition, which is a logical - expression that allows access to a resource only if - the expression evaluates to true. A condition can add - constraints based on attributes of the request, the - resource, or both. To learn which resources support - conditions in their IAM policies, see the [IAM - documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). - - **JSON example:** - - { "bindings": [ { "role": - "roles/resourcemanager.organizationAdmin", "members": - [ "user:mike@example.com", - "group:admins@example.com", "domain:google.com", - "serviceAccount:my-project-id@appspot.gserviceaccount.com" - ] }, { "role": - "roles/resourcemanager.organizationViewer", - "members": [ "user:eve@example.com" ], "condition": { - "title": "expirable access", "description": "Does not - grant access after Sep 2020", "expression": - "request.time < - timestamp('2020-10-01T00:00:00.000Z')", } } ], - "etag": "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - - bindings: - members: - user:\ mike@example.com - - group:\ admins@example.com - domain:google.com - - serviceAccount:\ my-project-id@appspot.gserviceaccount.com - role: roles/resourcemanager.organizationAdmin - - members: - user:\ eve@example.com role: - roles/resourcemanager.organizationViewer condition: - title: expirable access description: Does not grant - access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the - [IAM - documentation](\ https://cloud.google.com/iam/docs/). + specifies access controls for Google Cloud resources. A + Policy is a collection of bindings. A binding binds one + or more members to a single role. Members can be user + accounts, service accounts, Google groups, and domains + (such as G Suite). A role is a named list of + permissions; each role can be an IAM predefined role or + a user-created custom role. For some types of Google + Cloud resources, a binding can also specify a condition, + which is a logical expression that allows access to a + resource only if the expression evaluates to true. A + condition can add constraints based on attributes of the + request, the resource, or both. To learn which resources + support conditions in their IAM policies, see the [IAM + documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:\ mike@example.com - + group:\ admins@example.com - domain:google.com - + serviceAccount:\ my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:\ eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the [IAM + documentation](\ https://cloud.google.com/iam/docs/). """ # Create or coerce a protobuf request object. @@ -640,10 +616,9 @@ def insert( timeout: float = None, metadata: Sequence[Tuple[str, str]] = (), ) -> compute.Operation: - r"""Create a License resource in the specified project. - Caution This resource is intended for use only by third- - party partners who are creating Cloud Marketplace - images. + r"""Create a License resource in the specified project. *Caution* + This resource is intended for use only by third-party partners + who are creating Cloud Marketplace images. Args: request (google.cloud.compute_v1.types.InsertLicenseRequest): @@ -667,31 +642,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -736,15 +701,14 @@ def list( timeout: float = None, metadata: Sequence[Tuple[str, str]] = (), ) -> pagers.ListPager: - r"""Retrieves the list of licenses available in the - specified project. This method does not get any licenses - that belong to other projects, including licenses - attached to publicly-available images, like Debian 9. If - you want to get a list of publicly-available licenses, - use this method to make a request to the respective - image project, such as debian-cloud or windows-cloud. - Caution This resource is intended for use only by third- - party partners who are creating Cloud Marketplace + r"""Retrieves the list of licenses available in the specified + project. This method does not get any licenses that belong to + other projects, including licenses attached to + publicly-available images, like Debian 9. If you want to get a + list of publicly-available licenses, use this method to make a + request to the respective image project, such as debian-cloud or + windows-cloud. *Caution* This resource is intended for use only + by third-party partners who are creating Cloud Marketplace images. Args: @@ -817,10 +781,10 @@ def set_iam_policy( timeout: float = None, metadata: Sequence[Tuple[str, str]] = (), ) -> compute.Policy: - r"""Sets the access control policy on the specified - resource. Replaces any existing policy. Caution This - resource is intended for use only by third-party - partners who are creating Cloud Marketplace images. + r"""Sets the access control policy on the specified resource. + Replaces any existing policy. *Caution* This resource is + intended for use only by third-party partners who are creating + Cloud Marketplace images. Args: request (google.cloud.compute_v1.types.SetIamPolicyLicenseRequest): @@ -853,56 +817,44 @@ def set_iam_policy( Returns: google.cloud.compute_v1.types.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A Policy is a collection of bindings. A binding binds - one or more members to a single role. Members can be - user accounts, service accounts, Google groups, and - domains (such as G Suite). A role is a named list of - permissions; each role can be an IAM predefined role - or a user-created custom role. - - For some types of Google Cloud resources, a binding - can also specify a condition, which is a logical - expression that allows access to a resource only if - the expression evaluates to true. A condition can add - constraints based on attributes of the request, the - resource, or both. To learn which resources support - conditions in their IAM policies, see the [IAM - documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). - - **JSON example:** - - { "bindings": [ { "role": - "roles/resourcemanager.organizationAdmin", "members": - [ "user:mike@example.com", - "group:admins@example.com", "domain:google.com", - "serviceAccount:my-project-id@appspot.gserviceaccount.com" - ] }, { "role": - "roles/resourcemanager.organizationViewer", - "members": [ "user:eve@example.com" ], "condition": { - "title": "expirable access", "description": "Does not - grant access after Sep 2020", "expression": - "request.time < - timestamp('2020-10-01T00:00:00.000Z')", } } ], - "etag": "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - - bindings: - members: - user:\ mike@example.com - - group:\ admins@example.com - domain:google.com - - serviceAccount:\ my-project-id@appspot.gserviceaccount.com - role: roles/resourcemanager.organizationAdmin - - members: - user:\ eve@example.com role: - roles/resourcemanager.organizationViewer condition: - title: expirable access description: Does not grant - access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the - [IAM - documentation](\ https://cloud.google.com/iam/docs/). + specifies access controls for Google Cloud resources. A + Policy is a collection of bindings. A binding binds one + or more members to a single role. Members can be user + accounts, service accounts, Google groups, and domains + (such as G Suite). A role is a named list of + permissions; each role can be an IAM predefined role or + a user-created custom role. For some types of Google + Cloud resources, a binding can also specify a condition, + which is a logical expression that allows access to a + resource only if the expression evaluates to true. A + condition can add constraints based on attributes of the + request, the resource, or both. To learn which resources + support conditions in their IAM policies, see the [IAM + documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:\ mike@example.com - + group:\ admins@example.com - domain:google.com - + serviceAccount:\ my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:\ eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the [IAM + documentation](\ https://cloud.google.com/iam/docs/). """ # Create or coerce a protobuf request object. @@ -955,10 +907,9 @@ def test_iam_permissions( timeout: float = None, metadata: Sequence[Tuple[str, str]] = (), ) -> compute.TestPermissionsResponse: - r"""Returns permissions that a caller has on the - specified resource. Caution This resource is intended - for use only by third-party partners who are creating - Cloud Marketplace images. + r"""Returns permissions that a caller has on the specified resource. + *Caution* This resource is intended for use only by third-party + partners who are creating Cloud Marketplace images. Args: request (google.cloud.compute_v1.types.TestIamPermissionsLicenseRequest): diff --git a/google/cloud/compute_v1/services/licenses/transports/rest.py b/google/cloud/compute_v1/services/licenses/transports/rest.py index c35bbf587..de84eb58b 100644 --- a/google/cloud/compute_v1/services/licenses/transports/rest.py +++ b/google/cloud/compute_v1/services/licenses/transports/rest.py @@ -117,34 +117,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -192,13 +179,11 @@ def get( Returns: ~.compute.License: - Represents a License resource. - - A License represents billing and aggregate usage data - for public and marketplace images. Caution This resource - is intended for use only by third-party partners who are - creating Cloud Marketplace images. (== resource_for - {$api_version}.licenses ==) + Represents a License resource. A License represents + billing and aggregate usage data for public and + marketplace images. *Caution* This resource is intended + for use only by third-party partners who are creating + Cloud Marketplace images. """ @@ -246,28 +231,22 @@ def get_iam_policy( Returns: ~.compute.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A ``Policy`` is a collection of ``bindings``. A + specifies access controls for Google Cloud resources. A + ``Policy`` is a collection of ``bindings``. A ``binding`` binds one or more ``members`` to a single ``role``. Members can be user accounts, service accounts, Google groups, and domains (such as G Suite). A ``role`` is a named list of permissions; each ``role`` can be an IAM predefined role or a user-created custom - role. - - For some types of Google Cloud resources, a ``binding`` - can also specify a ``condition``, which is a logical - expression that allows access to a resource only if the - expression evaluates to ``true``. A condition can add - constraints based on attributes of the request, the + role. For some types of Google Cloud resources, a + ``binding`` can also specify a ``condition``, which is a + logical expression that allows access to a resource only + if the expression evaluates to ``true``. A condition can + add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the `IAM documentation `__. - - **JSON example:** - - { "bindings": [ { "role": + **JSON example:** { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", @@ -278,10 +257,7 @@ def get_iam_policy( "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": - "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - + "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com @@ -290,10 +266,9 @@ def get_iam_policy( roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the `IAM + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the `IAM documentation `__. """ @@ -347,34 +322,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -488,28 +450,22 @@ def set_iam_policy( Returns: ~.compute.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A ``Policy`` is a collection of ``bindings``. A + specifies access controls for Google Cloud resources. A + ``Policy`` is a collection of ``bindings``. A ``binding`` binds one or more ``members`` to a single ``role``. Members can be user accounts, service accounts, Google groups, and domains (such as G Suite). A ``role`` is a named list of permissions; each ``role`` can be an IAM predefined role or a user-created custom - role. - - For some types of Google Cloud resources, a ``binding`` - can also specify a ``condition``, which is a logical - expression that allows access to a resource only if the - expression evaluates to ``true``. A condition can add - constraints based on attributes of the request, the + role. For some types of Google Cloud resources, a + ``binding`` can also specify a ``condition``, which is a + logical expression that allows access to a resource only + if the expression evaluates to ``true``. A condition can + add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the `IAM documentation `__. - - **JSON example:** - - { "bindings": [ { "role": + **JSON example:** { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", @@ -520,10 +476,7 @@ def set_iam_policy( "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": - "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - + "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com @@ -532,10 +485,9 @@ def set_iam_policy( roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the `IAM + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the `IAM documentation `__. """ diff --git a/google/cloud/compute_v1/services/machine_types/client.py b/google/cloud/compute_v1/services/machine_types/client.py index 5084fea19..80a6650e8 100644 --- a/google/cloud/compute_v1/services/machine_types/client.py +++ b/google/cloud/compute_v1/services/machine_types/client.py @@ -442,12 +442,10 @@ def get( Returns: google.cloud.compute_v1.types.MachineType: Represents a Machine Type resource. - - You can use specific machine types for your VM - instances based on performance and pricing - requirements. For more information, read Machine - Types. (== resource_for {$api_version}.machineTypes - ==) + You can use specific machine types for + your VM instances based on performance + and pricing requirements. For more + information, read Machine Types. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/machine_types/transports/rest.py b/google/cloud/compute_v1/services/machine_types/transports/rest.py index ad377ff30..dd57321e7 100644 --- a/google/cloud/compute_v1/services/machine_types/transports/rest.py +++ b/google/cloud/compute_v1/services/machine_types/transports/rest.py @@ -177,11 +177,10 @@ def get( Returns: ~.compute.MachineType: Represents a Machine Type resource. - - You can use specific machine types for your VM instances - based on performance and pricing requirements. For more - information, read Machine Types. (== resource_for - {$api_version}.machineTypes ==) + You can use specific machine types for + your VM instances based on performance + and pricing requirements. For more + information, read Machine Types. """ diff --git a/google/cloud/compute_v1/services/network_endpoint_groups/client.py b/google/cloud/compute_v1/services/network_endpoint_groups/client.py index f17226fd6..ea6f60199 100644 --- a/google/cloud/compute_v1/services/network_endpoint_groups/client.py +++ b/google/cloud/compute_v1/services/network_endpoint_groups/client.py @@ -457,31 +457,21 @@ def attach_network_endpoints( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -583,31 +573,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -700,31 +680,21 @@ def detach_network_endpoints( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -823,20 +793,17 @@ def get( Returns: google.cloud.compute_v1.types.NetworkEndpointGroup: - Represents a collection of network endpoints. - - A network endpoint group (NEG) defines how a set of - endpoints should be reached, whether they are - reachable, and where they are located. For more - information about using NEGs, see Setting up external - HTTP(S) Load Balancing with internet NEGs, Setting up - zonal NEGs, or Setting up external HTTP(S) Load - Balancing with serverless NEGs. (== resource_for - {$api_version}.networkEndpointGroups ==) (== - resource_for - {$api_version}.globalNetworkEndpointGroups ==) (== - resource_for - {$api_version}.regionNetworkEndpointGroups ==) + Represents a collection of network + endpoints. A network endpoint group + (NEG) defines how a set of endpoints + should be reached, whether they are + reachable, and where they are located. + For more information about using NEGs, + see Setting up external HTTP(S) Load + Balancing with internet NEGs, Setting up + zonal NEGs, or Setting up external + HTTP(S) Load Balancing with serverless + NEGs. """ # Create or coerce a protobuf request object. @@ -920,31 +887,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/network_endpoint_groups/transports/rest.py b/google/cloud/compute_v1/services/network_endpoint_groups/transports/rest.py index 2e485ef0c..d7ecb2650 100644 --- a/google/cloud/compute_v1/services/network_endpoint_groups/transports/rest.py +++ b/google/cloud/compute_v1/services/network_endpoint_groups/transports/rest.py @@ -182,34 +182,21 @@ def attach_network_endpoints( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -272,34 +259,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -350,34 +324,21 @@ def detach_network_endpoints( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -440,19 +401,17 @@ def get( Returns: ~.compute.NetworkEndpointGroup: - Represents a collection of network endpoints. - - A network endpoint group (NEG) defines how a set of - endpoints should be reached, whether they are reachable, - and where they are located. For more information about - using NEGs, see Setting up external HTTP(S) Load - Balancing with internet NEGs, Setting up zonal NEGs, or - Setting up external HTTP(S) Load Balancing with - serverless NEGs. (== resource_for - {$api_version}.networkEndpointGroups ==) (== - resource_for {$api_version}.globalNetworkEndpointGroups - ==) (== resource_for - {$api_version}.regionNetworkEndpointGroups ==) + Represents a collection of network + endpoints. A network endpoint group + (NEG) defines how a set of endpoints + should be reached, whether they are + reachable, and where they are located. + For more information about using NEGs, + see Setting up external HTTP(S) Load + Balancing with internet NEGs, Setting up + zonal NEGs, or Setting up external + HTTP(S) Load Balancing with serverless + NEGs. """ @@ -503,34 +462,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/networks/client.py b/google/cloud/compute_v1/services/networks/client.py index 7196c366b..1b338d41f 100644 --- a/google/cloud/compute_v1/services/networks/client.py +++ b/google/cloud/compute_v1/services/networks/client.py @@ -369,31 +369,21 @@ def add_peering( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -469,31 +459,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -565,11 +545,10 @@ def get( Returns: google.cloud.compute_v1.types.Network: Represents a VPC Network resource. - - Networks connect resources to each other and to the - internet. For more information, read Virtual Private - Cloud (VPC) Network. (== resource_for - {$api_version}.networks ==) + Networks connect resources to each other + and to the internet. For more + information, read Virtual Private Cloud + (VPC) Network. """ # Create or coerce a protobuf request object. @@ -710,31 +689,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -964,31 +933,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1069,31 +1028,21 @@ def remove_peering( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1171,31 +1120,21 @@ def switch_to_custom_mode( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1243,9 +1182,9 @@ def update_peering( metadata: Sequence[Tuple[str, str]] = (), ) -> compute.Operation: r"""Updates the specified network peering with the data included in - the request Only the following fields can be modified: - NetworkPeering.export_custom_routes, and - NetworkPeering.import_custom_routes + the request. You can only modify the + NetworkPeering.export_custom_routes field and the + NetworkPeering.import_custom_routes field. Args: request (google.cloud.compute_v1.types.UpdatePeeringNetworkRequest): @@ -1277,31 +1216,21 @@ def update_peering( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/networks/transports/rest.py b/google/cloud/compute_v1/services/networks/transports/rest.py index b843ea546..dbd6dad47 100644 --- a/google/cloud/compute_v1/services/networks/transports/rest.py +++ b/google/cloud/compute_v1/services/networks/transports/rest.py @@ -117,34 +117,21 @@ def add_peering( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -201,34 +188,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -276,11 +250,10 @@ def get( Returns: ~.compute.Network: Represents a VPC Network resource. - - Networks connect resources to each other and to the - internet. For more information, read Virtual Private - Cloud (VPC) Network. (== resource_for - {$api_version}.networks ==) + Networks connect resources to each other + and to the internet. For more + information, read Virtual Private Cloud + (VPC) Network. """ @@ -373,34 +346,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -575,34 +535,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -659,34 +606,21 @@ def remove_peering( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -743,34 +677,21 @@ def switch_to_custom_mode( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -818,34 +739,21 @@ def update_peering( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/node_groups/client.py b/google/cloud/compute_v1/services/node_groups/client.py index 6e2e17366..e1dbe0070 100644 --- a/google/cloud/compute_v1/services/node_groups/client.py +++ b/google/cloud/compute_v1/services/node_groups/client.py @@ -375,31 +375,21 @@ def add_nodes( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -561,31 +551,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -674,31 +654,21 @@ def delete_nodes( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -787,16 +757,17 @@ def get( Returns: google.cloud.compute_v1.types.NodeGroup: - Represent a sole-tenant Node Group resource. - - A sole-tenant node is a physical server that is - dedicated to hosting VM instances only for your - specific project. Use sole-tenant nodes to keep your - instances physically separated from instances in - other projects, or to group your instances together - on the same host hardware. For more information, read - Sole-tenant nodes. (== resource_for - {$api_version}.nodeGroups ==) + Represents a sole-tenant Node Group + resource. A sole-tenant node is a + physical server that is dedicated to + hosting VM instances only for your + specific project. Use sole-tenant nodes + to keep your instances physically + separated from instances in other + projects, or to group your instances + together on the same host hardware. For + more information, read Sole-tenant + nodes. """ # Create or coerce a protobuf request object. @@ -881,56 +852,44 @@ def get_iam_policy( Returns: google.cloud.compute_v1.types.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A Policy is a collection of bindings. A binding binds - one or more members to a single role. Members can be - user accounts, service accounts, Google groups, and - domains (such as G Suite). A role is a named list of - permissions; each role can be an IAM predefined role - or a user-created custom role. - - For some types of Google Cloud resources, a binding - can also specify a condition, which is a logical - expression that allows access to a resource only if - the expression evaluates to true. A condition can add - constraints based on attributes of the request, the - resource, or both. To learn which resources support - conditions in their IAM policies, see the [IAM - documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). - - **JSON example:** - - { "bindings": [ { "role": - "roles/resourcemanager.organizationAdmin", "members": - [ "user:mike@example.com", - "group:admins@example.com", "domain:google.com", - "serviceAccount:my-project-id@appspot.gserviceaccount.com" - ] }, { "role": - "roles/resourcemanager.organizationViewer", - "members": [ "user:eve@example.com" ], "condition": { - "title": "expirable access", "description": "Does not - grant access after Sep 2020", "expression": - "request.time < - timestamp('2020-10-01T00:00:00.000Z')", } } ], - "etag": "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - - bindings: - members: - user:\ mike@example.com - - group:\ admins@example.com - domain:google.com - - serviceAccount:\ my-project-id@appspot.gserviceaccount.com - role: roles/resourcemanager.organizationAdmin - - members: - user:\ eve@example.com role: - roles/resourcemanager.organizationViewer condition: - title: expirable access description: Does not grant - access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the - [IAM - documentation](\ https://cloud.google.com/iam/docs/). + specifies access controls for Google Cloud resources. A + Policy is a collection of bindings. A binding binds one + or more members to a single role. Members can be user + accounts, service accounts, Google groups, and domains + (such as G Suite). A role is a named list of + permissions; each role can be an IAM predefined role or + a user-created custom role. For some types of Google + Cloud resources, a binding can also specify a condition, + which is a logical expression that allows access to a + resource only if the expression evaluates to true. A + condition can add constraints based on attributes of the + request, the resource, or both. To learn which resources + support conditions in their IAM policies, see the [IAM + documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:\ mike@example.com - + group:\ admins@example.com - domain:google.com - + serviceAccount:\ my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:\ eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the [IAM + documentation](\ https://cloud.google.com/iam/docs/). """ # Create or coerce a protobuf request object. @@ -1020,31 +979,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1311,31 +1260,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1428,56 +1367,44 @@ def set_iam_policy( Returns: google.cloud.compute_v1.types.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A Policy is a collection of bindings. A binding binds - one or more members to a single role. Members can be - user accounts, service accounts, Google groups, and - domains (such as G Suite). A role is a named list of - permissions; each role can be an IAM predefined role - or a user-created custom role. - - For some types of Google Cloud resources, a binding - can also specify a condition, which is a logical - expression that allows access to a resource only if - the expression evaluates to true. A condition can add - constraints based on attributes of the request, the - resource, or both. To learn which resources support - conditions in their IAM policies, see the [IAM - documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). - - **JSON example:** - - { "bindings": [ { "role": - "roles/resourcemanager.organizationAdmin", "members": - [ "user:mike@example.com", - "group:admins@example.com", "domain:google.com", - "serviceAccount:my-project-id@appspot.gserviceaccount.com" - ] }, { "role": - "roles/resourcemanager.organizationViewer", - "members": [ "user:eve@example.com" ], "condition": { - "title": "expirable access", "description": "Does not - grant access after Sep 2020", "expression": - "request.time < - timestamp('2020-10-01T00:00:00.000Z')", } } ], - "etag": "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - - bindings: - members: - user:\ mike@example.com - - group:\ admins@example.com - domain:google.com - - serviceAccount:\ my-project-id@appspot.gserviceaccount.com - role: roles/resourcemanager.organizationAdmin - - members: - user:\ eve@example.com role: - roles/resourcemanager.organizationViewer condition: - title: expirable access description: Does not grant - access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the - [IAM - documentation](\ https://cloud.google.com/iam/docs/). + specifies access controls for Google Cloud resources. A + Policy is a collection of bindings. A binding binds one + or more members to a single role. Members can be user + accounts, service accounts, Google groups, and domains + (such as G Suite). A role is a named list of + permissions; each role can be an IAM predefined role or + a user-created custom role. For some types of Google + Cloud resources, a binding can also specify a condition, + which is a logical expression that allows access to a + resource only if the expression evaluates to true. A + condition can add constraints based on attributes of the + request, the resource, or both. To learn which resources + support conditions in their IAM policies, see the [IAM + documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:\ mike@example.com - + group:\ admins@example.com - domain:google.com - + serviceAccount:\ my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:\ eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the [IAM + documentation](\ https://cloud.google.com/iam/docs/). """ # Create or coerce a protobuf request object. @@ -1572,31 +1499,21 @@ def set_node_template( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/node_groups/transports/rest.py b/google/cloud/compute_v1/services/node_groups/transports/rest.py index eff7a170a..3e462c744 100644 --- a/google/cloud/compute_v1/services/node_groups/transports/rest.py +++ b/google/cloud/compute_v1/services/node_groups/transports/rest.py @@ -117,34 +117,21 @@ def add_nodes( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -263,34 +250,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -341,34 +315,21 @@ def delete_nodes( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -427,15 +388,17 @@ def get( Returns: ~.compute.NodeGroup: - Represent a sole-tenant Node Group resource. - - A sole-tenant node is a physical server that is - dedicated to hosting VM instances only for your specific - project. Use sole-tenant nodes to keep your instances - physically separated from instances in other projects, - or to group your instances together on the same host - hardware. For more information, read Sole-tenant nodes. - (== resource_for {$api_version}.nodeGroups ==) + Represents a sole-tenant Node Group + resource. A sole-tenant node is a + physical server that is dedicated to + hosting VM instances only for your + specific project. Use sole-tenant nodes + to keep your instances physically + separated from instances in other + projects, or to group your instances + together on the same host hardware. For + more information, read Sole-tenant + nodes. """ @@ -485,28 +448,22 @@ def get_iam_policy( Returns: ~.compute.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A ``Policy`` is a collection of ``bindings``. A + specifies access controls for Google Cloud resources. A + ``Policy`` is a collection of ``bindings``. A ``binding`` binds one or more ``members`` to a single ``role``. Members can be user accounts, service accounts, Google groups, and domains (such as G Suite). A ``role`` is a named list of permissions; each ``role`` can be an IAM predefined role or a user-created custom - role. - - For some types of Google Cloud resources, a ``binding`` - can also specify a ``condition``, which is a logical - expression that allows access to a resource only if the - expression evaluates to ``true``. A condition can add - constraints based on attributes of the request, the + role. For some types of Google Cloud resources, a + ``binding`` can also specify a ``condition``, which is a + logical expression that allows access to a resource only + if the expression evaluates to ``true``. A condition can + add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the `IAM documentation `__. - - **JSON example:** - - { "bindings": [ { "role": + **JSON example:** { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", @@ -517,10 +474,7 @@ def get_iam_policy( "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": - "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - + "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com @@ -529,10 +483,9 @@ def get_iam_policy( roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the `IAM + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the `IAM documentation `__. """ @@ -589,34 +542,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -791,34 +731,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -879,28 +806,22 @@ def set_iam_policy( Returns: ~.compute.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A ``Policy`` is a collection of ``bindings``. A + specifies access controls for Google Cloud resources. A + ``Policy`` is a collection of ``bindings``. A ``binding`` binds one or more ``members`` to a single ``role``. Members can be user accounts, service accounts, Google groups, and domains (such as G Suite). A ``role`` is a named list of permissions; each ``role`` can be an IAM predefined role or a user-created custom - role. - - For some types of Google Cloud resources, a ``binding`` - can also specify a ``condition``, which is a logical - expression that allows access to a resource only if the - expression evaluates to ``true``. A condition can add - constraints based on attributes of the request, the + role. For some types of Google Cloud resources, a + ``binding`` can also specify a ``condition``, which is a + logical expression that allows access to a resource only + if the expression evaluates to ``true``. A condition can + add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the `IAM documentation `__. - - **JSON example:** - - { "bindings": [ { "role": + **JSON example:** { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", @@ -911,10 +832,7 @@ def set_iam_policy( "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": - "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - + "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com @@ -923,10 +841,9 @@ def set_iam_policy( roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the `IAM + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the `IAM documentation `__. """ @@ -985,34 +902,21 @@ def set_node_template( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/node_templates/client.py b/google/cloud/compute_v1/services/node_templates/client.py index 1416b6c98..2b9adb54d 100644 --- a/google/cloud/compute_v1/services/node_templates/client.py +++ b/google/cloud/compute_v1/services/node_templates/client.py @@ -442,31 +442,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -548,12 +538,11 @@ def get( Returns: google.cloud.compute_v1.types.NodeTemplate: - Represent a sole-tenant Node Template resource. - - You can use a template to define properties for nodes - in a node group. For more information, read Creating - node groups and instances. (== resource_for - {$api_version}.nodeTemplates ==) + Represent a sole-tenant Node Template + resource. You can use a template to + define properties for nodes in a node + group. For more information, read + Creating node groups and instances. """ # Create or coerce a protobuf request object. @@ -638,56 +627,44 @@ def get_iam_policy( Returns: google.cloud.compute_v1.types.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A Policy is a collection of bindings. A binding binds - one or more members to a single role. Members can be - user accounts, service accounts, Google groups, and - domains (such as G Suite). A role is a named list of - permissions; each role can be an IAM predefined role - or a user-created custom role. - - For some types of Google Cloud resources, a binding - can also specify a condition, which is a logical - expression that allows access to a resource only if - the expression evaluates to true. A condition can add - constraints based on attributes of the request, the - resource, or both. To learn which resources support - conditions in their IAM policies, see the [IAM - documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). - - **JSON example:** - - { "bindings": [ { "role": - "roles/resourcemanager.organizationAdmin", "members": - [ "user:mike@example.com", - "group:admins@example.com", "domain:google.com", - "serviceAccount:my-project-id@appspot.gserviceaccount.com" - ] }, { "role": - "roles/resourcemanager.organizationViewer", - "members": [ "user:eve@example.com" ], "condition": { - "title": "expirable access", "description": "Does not - grant access after Sep 2020", "expression": - "request.time < - timestamp('2020-10-01T00:00:00.000Z')", } } ], - "etag": "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - - bindings: - members: - user:\ mike@example.com - - group:\ admins@example.com - domain:google.com - - serviceAccount:\ my-project-id@appspot.gserviceaccount.com - role: roles/resourcemanager.organizationAdmin - - members: - user:\ eve@example.com role: - roles/resourcemanager.organizationViewer condition: - title: expirable access description: Does not grant - access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the - [IAM - documentation](\ https://cloud.google.com/iam/docs/). + specifies access controls for Google Cloud resources. A + Policy is a collection of bindings. A binding binds one + or more members to a single role. Members can be user + accounts, service accounts, Google groups, and domains + (such as G Suite). A role is a named list of + permissions; each role can be an IAM predefined role or + a user-created custom role. For some types of Google + Cloud resources, a binding can also specify a condition, + which is a logical expression that allows access to a + resource only if the expression evaluates to true. A + condition can add constraints based on attributes of the + request, the resource, or both. To learn which resources + support conditions in their IAM policies, see the [IAM + documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:\ mike@example.com - + group:\ admins@example.com - domain:google.com - + serviceAccount:\ my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:\ eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the [IAM + documentation](\ https://cloud.google.com/iam/docs/). """ # Create or coerce a protobuf request object. @@ -769,31 +746,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -967,56 +934,44 @@ def set_iam_policy( Returns: google.cloud.compute_v1.types.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A Policy is a collection of bindings. A binding binds - one or more members to a single role. Members can be - user accounts, service accounts, Google groups, and - domains (such as G Suite). A role is a named list of - permissions; each role can be an IAM predefined role - or a user-created custom role. - - For some types of Google Cloud resources, a binding - can also specify a condition, which is a logical - expression that allows access to a resource only if - the expression evaluates to true. A condition can add - constraints based on attributes of the request, the - resource, or both. To learn which resources support - conditions in their IAM policies, see the [IAM - documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). - - **JSON example:** - - { "bindings": [ { "role": - "roles/resourcemanager.organizationAdmin", "members": - [ "user:mike@example.com", - "group:admins@example.com", "domain:google.com", - "serviceAccount:my-project-id@appspot.gserviceaccount.com" - ] }, { "role": - "roles/resourcemanager.organizationViewer", - "members": [ "user:eve@example.com" ], "condition": { - "title": "expirable access", "description": "Does not - grant access after Sep 2020", "expression": - "request.time < - timestamp('2020-10-01T00:00:00.000Z')", } } ], - "etag": "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - - bindings: - members: - user:\ mike@example.com - - group:\ admins@example.com - domain:google.com - - serviceAccount:\ my-project-id@appspot.gserviceaccount.com - role: roles/resourcemanager.organizationAdmin - - members: - user:\ eve@example.com role: - roles/resourcemanager.organizationViewer condition: - title: expirable access description: Does not grant - access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the - [IAM - documentation](\ https://cloud.google.com/iam/docs/). + specifies access controls for Google Cloud resources. A + Policy is a collection of bindings. A binding binds one + or more members to a single role. Members can be user + accounts, service accounts, Google groups, and domains + (such as G Suite). A role is a named list of + permissions; each role can be an IAM predefined role or + a user-created custom role. For some types of Google + Cloud resources, a binding can also specify a condition, + which is a logical expression that allows access to a + resource only if the expression evaluates to true. A + condition can add constraints based on attributes of the + request, the resource, or both. To learn which resources + support conditions in their IAM policies, see the [IAM + documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:\ mike@example.com - + group:\ admins@example.com - domain:google.com - + serviceAccount:\ my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:\ eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the [IAM + documentation](\ https://cloud.google.com/iam/docs/). """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/node_templates/transports/rest.py b/google/cloud/compute_v1/services/node_templates/transports/rest.py index a0e261096..0c895df6b 100644 --- a/google/cloud/compute_v1/services/node_templates/transports/rest.py +++ b/google/cloud/compute_v1/services/node_templates/transports/rest.py @@ -176,34 +176,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -254,12 +241,11 @@ def get( Returns: ~.compute.NodeTemplate: - Represent a sole-tenant Node Template resource. - - You can use a template to define properties for nodes in - a node group. For more information, read Creating node - groups and instances. (== resource_for - {$api_version}.nodeTemplates ==) + Represent a sole-tenant Node Template + resource. You can use a template to + define properties for nodes in a node + group. For more information, read + Creating node groups and instances. """ @@ -311,28 +297,22 @@ def get_iam_policy( Returns: ~.compute.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A ``Policy`` is a collection of ``bindings``. A + specifies access controls for Google Cloud resources. A + ``Policy`` is a collection of ``bindings``. A ``binding`` binds one or more ``members`` to a single ``role``. Members can be user accounts, service accounts, Google groups, and domains (such as G Suite). A ``role`` is a named list of permissions; each ``role`` can be an IAM predefined role or a user-created custom - role. - - For some types of Google Cloud resources, a ``binding`` - can also specify a ``condition``, which is a logical - expression that allows access to a resource only if the - expression evaluates to ``true``. A condition can add - constraints based on attributes of the request, the + role. For some types of Google Cloud resources, a + ``binding`` can also specify a ``condition``, which is a + logical expression that allows access to a resource only + if the expression evaluates to ``true``. A condition can + add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the `IAM documentation `__. - - **JSON example:** - - { "bindings": [ { "role": + **JSON example:** { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", @@ -343,10 +323,7 @@ def get_iam_policy( "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": - "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - + "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com @@ -355,10 +332,9 @@ def get_iam_policy( roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the `IAM + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the `IAM documentation `__. """ @@ -415,34 +391,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -557,28 +520,22 @@ def set_iam_policy( Returns: ~.compute.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A ``Policy`` is a collection of ``bindings``. A + specifies access controls for Google Cloud resources. A + ``Policy`` is a collection of ``bindings``. A ``binding`` binds one or more ``members`` to a single ``role``. Members can be user accounts, service accounts, Google groups, and domains (such as G Suite). A ``role`` is a named list of permissions; each ``role`` can be an IAM predefined role or a user-created custom - role. - - For some types of Google Cloud resources, a ``binding`` - can also specify a ``condition``, which is a logical - expression that allows access to a resource only if the - expression evaluates to ``true``. A condition can add - constraints based on attributes of the request, the + role. For some types of Google Cloud resources, a + ``binding`` can also specify a ``condition``, which is a + logical expression that allows access to a resource only + if the expression evaluates to ``true``. A condition can + add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the `IAM documentation `__. - - **JSON example:** - - { "bindings": [ { "role": + **JSON example:** { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", @@ -589,10 +546,7 @@ def set_iam_policy( "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": - "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - + "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com @@ -601,10 +555,9 @@ def set_iam_policy( roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the `IAM + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the `IAM documentation `__. """ diff --git a/google/cloud/compute_v1/services/node_types/client.py b/google/cloud/compute_v1/services/node_types/client.py index 47f07a1d3..7db2005a4 100644 --- a/google/cloud/compute_v1/services/node_types/client.py +++ b/google/cloud/compute_v1/services/node_types/client.py @@ -440,15 +440,16 @@ def get( Returns: google.cloud.compute_v1.types.NodeType: - Represent a sole-tenant Node Type resource. - - Each node within a node group must have a node type. - A node type specifies the total amount of cores and - memory for that node. Currently, the only available - node type is n1-node-96-624 node type that has 96 - vCPUs and 624 GB of memory, available in multiple - zones. For more information read Node types. (== - resource_for {$api_version}.nodeTypes ==) + Represent a sole-tenant Node Type + resource. Each node within a node group + must have a node type. A node type + specifies the total amount of cores and + memory for that node. Currently, the + only available node type is + n1-node-96-624 node type that has 96 + vCPUs and 624 GB of memory, available in + multiple zones. For more information + read Node types. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/node_types/transports/rest.py b/google/cloud/compute_v1/services/node_types/transports/rest.py index c37f08a39..2dd223e77 100644 --- a/google/cloud/compute_v1/services/node_types/transports/rest.py +++ b/google/cloud/compute_v1/services/node_types/transports/rest.py @@ -175,15 +175,16 @@ def get( Returns: ~.compute.NodeType: - Represent a sole-tenant Node Type resource. - - Each node within a node group must have a node type. A - node type specifies the total amount of cores and memory - for that node. Currently, the only available node type - is n1-node-96-624 node type that has 96 vCPUs and 624 GB - of memory, available in multiple zones. For more - information read Node types. (== resource_for - {$api_version}.nodeTypes ==) + Represent a sole-tenant Node Type + resource. Each node within a node group + must have a node type. A node type + specifies the total amount of cores and + memory for that node. Currently, the + only available node type is + n1-node-96-624 node type that has 96 + vCPUs and 624 GB of memory, available in + multiple zones. For more information + read Node types. """ diff --git a/google/cloud/compute_v1/services/packet_mirrorings/client.py b/google/cloud/compute_v1/services/packet_mirrorings/client.py index 97756f8f0..b06aa5440 100644 --- a/google/cloud/compute_v1/services/packet_mirrorings/client.py +++ b/google/cloud/compute_v1/services/packet_mirrorings/client.py @@ -443,31 +443,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -548,16 +538,16 @@ def get( Returns: google.cloud.compute_v1.types.PacketMirroring: - Represents a Packet Mirroring resource. - - Packet Mirroring clones the traffic of specified - instances in your Virtual Private Cloud (VPC) network - and forwards it to a collector destination, such as - an instance group of an internal TCP/UDP load - balancer, for analysis or examination. For more - information about setting up Packet Mirroring, see - Using Packet Mirroring. (== resource_for - {$api_version}.packetMirrorings ==) + Represents a Packet Mirroring + resource. Packet Mirroring clones the + traffic of specified instances in your + Virtual Private Cloud (VPC) network and + forwards it to a collector destination, + such as an instance group of an internal + TCP/UDP load balancer, for analysis or + examination. For more information about + setting up Packet Mirroring, see Using + Packet Mirroring. """ # Create or coerce a protobuf request object. @@ -638,31 +628,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -834,31 +814,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/packet_mirrorings/transports/rest.py b/google/cloud/compute_v1/services/packet_mirrorings/transports/rest.py index 93e9c68be..7aac687b4 100644 --- a/google/cloud/compute_v1/services/packet_mirrorings/transports/rest.py +++ b/google/cloud/compute_v1/services/packet_mirrorings/transports/rest.py @@ -179,34 +179,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -257,15 +244,16 @@ def get( Returns: ~.compute.PacketMirroring: - Represents a Packet Mirroring resource. - - Packet Mirroring clones the traffic of specified - instances in your Virtual Private Cloud (VPC) network - and forwards it to a collector destination, such as an - instance group of an internal TCP/UDP load balancer, for - analysis or examination. For more information about - setting up Packet Mirroring, see Using Packet Mirroring. - (== resource_for {$api_version}.packetMirrorings ==) + Represents a Packet Mirroring + resource. Packet Mirroring clones the + traffic of specified instances in your + Virtual Private Cloud (VPC) network and + forwards it to a collector destination, + such as an instance group of an internal + TCP/UDP load balancer, for analysis or + examination. For more information about + setting up Packet Mirroring, see Using + Packet Mirroring. """ @@ -316,34 +304,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -459,34 +434,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/projects/client.py b/google/cloud/compute_v1/services/projects/client.py index 2082c2ab1..71dd48e7a 100644 --- a/google/cloud/compute_v1/services/projects/client.py +++ b/google/cloud/compute_v1/services/projects/client.py @@ -355,31 +355,21 @@ def disable_xpn_host( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -449,31 +439,21 @@ def disable_xpn_resource( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -542,31 +522,21 @@ def enable_xpn_host( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -637,31 +607,21 @@ def enable_xpn_resource( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -729,12 +689,11 @@ def get( Returns: google.cloud.compute_v1.types.Project: - Represents a Project resource. - - A project is used to organize resources in a Google - Cloud Platform environment. For more information, - read about the Resource Hierarchy. (== resource_for - {$api_version}.projects ==) + Represents a Project resource. A + project is used to organize resources in + a Google Cloud Platform environment. For + more information, read about the + Resource Hierarchy. """ # Create or coerce a protobuf request object. @@ -798,12 +757,11 @@ def get_xpn_host( Returns: google.cloud.compute_v1.types.Project: - Represents a Project resource. - - A project is used to organize resources in a Google - Cloud Platform environment. For more information, - read about the Resource Hierarchy. (== resource_for - {$api_version}.projects ==) + Represents a Project resource. A + project is used to organize resources in + a Google Cloud Platform environment. For + more information, read about the + Resource Hierarchy. """ # Create or coerce a protobuf request object. @@ -1026,31 +984,21 @@ def move_disk( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1122,31 +1070,21 @@ def move_instance( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1219,31 +1157,21 @@ def set_common_instance_metadata( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1319,31 +1247,21 @@ def set_default_network_tier( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1421,31 +1339,21 @@ def set_usage_export_bucket( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/projects/transports/rest.py b/google/cloud/compute_v1/services/projects/transports/rest.py index 6c1510d6c..641e2b1b0 100644 --- a/google/cloud/compute_v1/services/projects/transports/rest.py +++ b/google/cloud/compute_v1/services/projects/transports/rest.py @@ -117,34 +117,21 @@ def disable_xpn_host( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -192,34 +179,21 @@ def disable_xpn_resource( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -276,34 +250,21 @@ def enable_xpn_host( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -351,34 +312,21 @@ def enable_xpn_resource( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -434,12 +382,11 @@ def get( Returns: ~.compute.Project: - Represents a Project resource. - - A project is used to organize resources in a Google - Cloud Platform environment. For more information, read - about the Resource Hierarchy. (== resource_for - {$api_version}.projects ==) + Represents a Project resource. A + project is used to organize resources in + a Google Cloud Platform environment. For + more information, read about the + Resource Hierarchy. """ @@ -485,12 +432,11 @@ def get_xpn_host( Returns: ~.compute.Project: - Represents a Project resource. - - A project is used to organize resources in a Google - Cloud Platform environment. For more information, read - about the Resource Hierarchy. (== resource_for - {$api_version}.projects ==) + Represents a Project resource. A + project is used to organize resources in + a Google Cloud Platform environment. For + more information, read about the + Resource Hierarchy. """ @@ -659,34 +605,21 @@ def move_disk( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -743,34 +676,21 @@ def move_instance( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -828,34 +748,21 @@ def set_common_instance_metadata( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -912,34 +819,21 @@ def set_default_network_tier( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -996,34 +890,21 @@ def set_usage_export_bucket( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/public_advertised_prefixes/client.py b/google/cloud/compute_v1/services/public_advertised_prefixes/client.py index d06116c46..8659f3009 100644 --- a/google/cloud/compute_v1/services/public_advertised_prefixes/client.py +++ b/google/cloud/compute_v1/services/public_advertised_prefixes/client.py @@ -367,31 +367,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -543,31 +533,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -722,31 +702,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/public_advertised_prefixes/transports/rest.py b/google/cloud/compute_v1/services/public_advertised_prefixes/transports/rest.py index 7e73748dc..edf3c3a09 100644 --- a/google/cloud/compute_v1/services/public_advertised_prefixes/transports/rest.py +++ b/google/cloud/compute_v1/services/public_advertised_prefixes/transports/rest.py @@ -117,34 +117,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -249,34 +236,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -393,34 +367,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/public_delegated_prefixes/client.py b/google/cloud/compute_v1/services/public_delegated_prefixes/client.py index 683a538f7..4f3aed629 100644 --- a/google/cloud/compute_v1/services/public_delegated_prefixes/client.py +++ b/google/cloud/compute_v1/services/public_delegated_prefixes/client.py @@ -450,31 +450,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -645,31 +635,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -841,31 +821,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/public_delegated_prefixes/transports/rest.py b/google/cloud/compute_v1/services/public_delegated_prefixes/transports/rest.py index 6c22d7efe..bf91e9b0c 100644 --- a/google/cloud/compute_v1/services/public_delegated_prefixes/transports/rest.py +++ b/google/cloud/compute_v1/services/public_delegated_prefixes/transports/rest.py @@ -182,34 +182,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -319,34 +306,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -460,34 +434,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/region_autoscalers/client.py b/google/cloud/compute_v1/services/region_autoscalers/client.py index cadd50e72..9749a8484 100644 --- a/google/cloud/compute_v1/services/region_autoscalers/client.py +++ b/google/cloud/compute_v1/services/region_autoscalers/client.py @@ -373,31 +373,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -478,26 +468,17 @@ def get( Returns: google.cloud.compute_v1.types.Autoscaler: - Represents an Autoscaler resource. - - Google Compute Engine has two Autoscaler resources: - - - [Zonal](/compute/docs/reference/rest/{$api_version}/autoscalers) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionAutoscalers) - - Use autoscalers to automatically add or delete - instances from a managed instance group according to - your defined autoscaling policy. For more - information, read Autoscaling Groups of Instances. - - For zonal managed instance groups resource, use the - autoscaler resource. - - For regional managed instance groups, use the - regionAutoscalers resource. (== resource_for - {$api_version}.autoscalers ==) (== resource_for - {$api_version}.regionAutoscalers ==) + Represents an Autoscaler resource. Google Compute Engine + has two Autoscaler resources: \* + [Zonal](/compute/docs/reference/rest/v1/autoscalers) \* + [Regional](/compute/docs/reference/rest/v1/regionAutoscalers) + Use autoscalers to automatically add or delete instances + from a managed instance group according to your defined + autoscaling policy. For more information, read + Autoscaling Groups of Instances. For zonal managed + instance groups resource, use the autoscaler resource. + For regional managed instance groups, use the + regionAutoscalers resource. """ # Create or coerce a protobuf request object. @@ -579,31 +560,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -770,31 +741,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -876,31 +837,21 @@ def update( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/region_autoscalers/transports/rest.py b/google/cloud/compute_v1/services/region_autoscalers/transports/rest.py index 5758cfa92..1fd39a445 100644 --- a/google/cloud/compute_v1/services/region_autoscalers/transports/rest.py +++ b/google/cloud/compute_v1/services/region_autoscalers/transports/rest.py @@ -117,34 +117,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -195,26 +182,18 @@ def get( Returns: ~.compute.Autoscaler: - Represents an Autoscaler resource. - - Google Compute Engine has two Autoscaler resources: - - - `Zonal `__ - \* - `Regional `__ - + Represents an Autoscaler resource. Google Compute Engine + has two Autoscaler resources: \* + `Zonal `__ + \* + `Regional `__ Use autoscalers to automatically add or delete instances from a managed instance group according to your defined autoscaling policy. For more information, read - Autoscaling Groups of Instances. - - For zonal managed instance groups resource, use the - autoscaler resource. - + Autoscaling Groups of Instances. For zonal managed + instance groups resource, use the autoscaler resource. For regional managed instance groups, use the - regionAutoscalers resource. (== resource_for - {$api_version}.autoscalers ==) (== resource_for - {$api_version}.regionAutoscalers ==) + regionAutoscalers resource. """ @@ -265,34 +244,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -406,34 +372,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -492,34 +445,21 @@ def update( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/region_backend_services/client.py b/google/cloud/compute_v1/services/region_backend_services/client.py index 2c4251a27..7521b6ee4 100644 --- a/google/cloud/compute_v1/services/region_backend_services/client.py +++ b/google/cloud/compute_v1/services/region_backend_services/client.py @@ -376,31 +376,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -484,28 +474,21 @@ def get( Returns: google.cloud.compute_v1.types.BackendService: - Represents a Backend Service resource. - - A backend service defines how Google Cloud load - balancers distribute traffic. The backend service - configuration contains a set of values, such as the - protocol used to connect to backends, various - distribution and session settings, health checks, and - timeouts. These settings provide fine-grained control - over how your load balancer behaves. Most of the - settings have default values that allow for easy - configuration if you need to get started quickly. - - Backend services in Google Compute Engine can be - either regionally or globally scoped. - - - [Global](/compute/docs/reference/rest/{$api_version}/backendServices) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionBackendServices) - - For more information, see Backend Services. - - (== resource_for {$api_version}.backendService ==) + Represents a Backend Service resource. A backend service + defines how Google Cloud load balancers distribute + traffic. The backend service configuration contains a + set of values, such as the protocol used to connect to + backends, various distribution and session settings, + health checks, and timeouts. These settings provide + fine-grained control over how your load balancer + behaves. Most of the settings have default values that + allow for easy configuration if you need to get started + quickly. Backend services in Google Compute Engine can + be either regionally or globally scoped. \* + [Global](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices) + \* + [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices) + For more information, see Backend Services. """ # Create or coerce a protobuf request object. @@ -651,7 +634,7 @@ def insert( ) -> compute.Operation: r"""Creates a regional BackendService resource in the specified project using the data included in the - request. For more information, see Backend services + request. For more information, see Backend services overview. Args: @@ -684,31 +667,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -845,7 +818,7 @@ def patch( ) -> compute.Operation: r"""Updates the specified regional BackendService resource with the data included in the request. For more - information, see Understanding backend services This + information, see Understanding backend services This method supports PATCH semantics and uses the JSON merge patch format and processing rules. @@ -886,31 +859,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -966,7 +929,7 @@ def update( ) -> compute.Operation: r"""Updates the specified regional BackendService resource with the data included in the request. For more - information, see Backend services overview. + information, see Backend services overview . Args: request (google.cloud.compute_v1.types.UpdateRegionBackendServiceRequest): @@ -1005,31 +968,21 @@ def update( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/region_backend_services/transports/rest.py b/google/cloud/compute_v1/services/region_backend_services/transports/rest.py index e0f80a578..453f2ed72 100644 --- a/google/cloud/compute_v1/services/region_backend_services/transports/rest.py +++ b/google/cloud/compute_v1/services/region_backend_services/transports/rest.py @@ -117,34 +117,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -195,29 +182,22 @@ def get( Returns: ~.compute.BackendService: - Represents a Backend Service resource. - - A backend service defines how Google Cloud load - balancers distribute traffic. The backend service - configuration contains a set of values, such as the - protocol used to connect to backends, various - distribution and session settings, health checks, and - timeouts. These settings provide fine-grained control - over how your load balancer behaves. Most of the - settings have default values that allow for easy - configuration if you need to get started quickly. - - Backend services in Google Compute Engine can be either - regionally or globally scoped. - - - `Global `__ - \* - `Regional `__ - + Represents a Backend Service resource. A backend service + defines how Google Cloud load balancers distribute + traffic. The backend service configuration contains a + set of values, such as the protocol used to connect to + backends, various distribution and session settings, + health checks, and timeouts. These settings provide + fine-grained control over how your load balancer + behaves. Most of the settings have default values that + allow for easy configuration if you need to get started + quickly. Backend services in Google Compute Engine can + be either regionally or globally scoped. \* + `Global `__ + \* + `Regional `__ For more information, see Backend Services. - (== resource_for {$api_version}.backendService ==) - """ # TODO(yon-mg): need to handle grpc transcoding and parse url correctly @@ -326,34 +306,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -469,34 +436,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -556,34 +510,21 @@ def update( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/region_commitments/client.py b/google/cloud/compute_v1/services/region_commitments/client.py index 6342ada41..582f000c4 100644 --- a/google/cloud/compute_v1/services/region_commitments/client.py +++ b/google/cloud/compute_v1/services/region_commitments/client.py @@ -339,7 +339,8 @@ def aggregated_list( timeout: float = None, metadata: Sequence[Tuple[str, str]] = (), ) -> pagers.AggregatedListPager: - r"""Retrieves an aggregated list of commitments. + r"""Retrieves an aggregated list of commitments by + region. Args: request (google.cloud.compute_v1.types.AggregatedListRegionCommitmentsRequest): @@ -444,15 +445,15 @@ def get( Returns: google.cloud.compute_v1.types.Commitment: - Represents a regional Commitment resource. - - Creating a commitment resource means that you are - purchasing a committed use contract with an explicit - start and end time. You can create commitments based - on vCPUs and memory usage and receive discounted - rates. For full details, read Signing Up for - Committed Use Discounts. (== resource_for - {$api_version}.regionCommitments ==) + Represents a regional Commitment + resource. Creating a commitment resource + means that you are purchasing a + committed use contract with an explicit + start and end time. You can create + commitments based on vCPUs and memory + usage and receive discounted rates. For + full details, read Signing Up for + Committed Use Discounts. """ # Create or coerce a protobuf request object. @@ -532,31 +533,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/region_commitments/transports/rest.py b/google/cloud/compute_v1/services/region_commitments/transports/rest.py index 91db4d797..80920dc9d 100644 --- a/google/cloud/compute_v1/services/region_commitments/transports/rest.py +++ b/google/cloud/compute_v1/services/region_commitments/transports/rest.py @@ -179,15 +179,15 @@ def get( Returns: ~.compute.Commitment: - Represents a regional Commitment resource. - - Creating a commitment resource means that you are - purchasing a committed use contract with an explicit - start and end time. You can create commitments based on - vCPUs and memory usage and receive discounted rates. For - full details, read Signing Up for Committed Use - Discounts. (== resource_for - {$api_version}.regionCommitments ==) + Represents a regional Commitment + resource. Creating a commitment resource + means that you are purchasing a + committed use contract with an explicit + start and end time. You can create + commitments based on vCPUs and memory + usage and receive discounted rates. For + full details, read Signing Up for + Committed Use Discounts. """ @@ -238,34 +238,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/region_disk_types/client.py b/google/cloud/compute_v1/services/region_disk_types/client.py index fbeeca2b3..8519d3a9e 100644 --- a/google/cloud/compute_v1/services/region_disk_types/client.py +++ b/google/cloud/compute_v1/services/region_disk_types/client.py @@ -372,27 +372,17 @@ def get( Returns: google.cloud.compute_v1.types.DiskType: - Represents a Disk Type resource. - - Google Compute Engine has two Disk Type resources: - - - [Regional](/compute/docs/reference/rest/{$api_version}/regionDiskTypes) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/diskTypes) - - You can choose from a variety of disk types based on - your needs. For more information, read Storage - options. - - The diskTypes resource represents disk types for a - zonal persistent disk. For more information, read - Zonal persistent disks. - - The regionDiskTypes resource represents disk types - for a regional persistent disk. For more information, - read Regional persistent disks. (== resource_for - {$api_version}.diskTypes ==) (== resource_for - {$api_version}.regionDiskTypes ==) + Represents a Disk Type resource. Google Compute Engine + has two Disk Type resources: \* + [Regional](/compute/docs/reference/rest/v1/regionDiskTypes) + \* [Zonal](/compute/docs/reference/rest/v1/diskTypes) + You can choose from a variety of disk types based on + your needs. For more information, read Storage options. + The diskTypes resource represents disk types for a zonal + persistent disk. For more information, read Zonal + persistent disks. The regionDiskTypes resource + represents disk types for a regional persistent disk. + For more information, read Regional persistent disks. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/region_disk_types/transports/rest.py b/google/cloud/compute_v1/services/region_disk_types/transports/rest.py index 084869510..7bd3747c8 100644 --- a/google/cloud/compute_v1/services/region_disk_types/transports/rest.py +++ b/google/cloud/compute_v1/services/region_disk_types/transports/rest.py @@ -117,26 +117,17 @@ def get( Returns: ~.compute.DiskType: - Represents a Disk Type resource. - - Google Compute Engine has two Disk Type resources: - - - `Regional `__ - \* - `Zonal `__ - + Represents a Disk Type resource. Google Compute Engine + has two Disk Type resources: \* + `Regional `__ + \* `Zonal `__ You can choose from a variety of disk types based on your needs. For more information, read Storage options. - The diskTypes resource represents disk types for a zonal persistent disk. For more information, read Zonal - persistent disks. - - The regionDiskTypes resource represents disk types for a - regional persistent disk. For more information, read - Regional persistent disks. (== resource_for - {$api_version}.diskTypes ==) (== resource_for - {$api_version}.regionDiskTypes ==) + persistent disks. The regionDiskTypes resource + represents disk types for a regional persistent disk. + For more information, read Regional persistent disks. """ diff --git a/google/cloud/compute_v1/services/region_disks/client.py b/google/cloud/compute_v1/services/region_disks/client.py index 4e7cc7c64..66955ffe8 100644 --- a/google/cloud/compute_v1/services/region_disks/client.py +++ b/google/cloud/compute_v1/services/region_disks/client.py @@ -377,31 +377,21 @@ def add_resource_policies( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -494,31 +484,21 @@ def create_snapshot( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -605,31 +585,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -709,28 +679,18 @@ def get( Returns: google.cloud.compute_v1.types.Disk: - Represents a Persistent Disk resource. - - Google Compute Engine has two Disk resources: - - - [Zonal](/compute/docs/reference/rest/{$api_version}/disks) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionDisks) - - Persistent disks are required for running your VM - instances. Create both boot and non-boot (data) - persistent disks. For more information, read - Persistent Disks. For more storage options, read - Storage options. - - The disks resource represents a zonal persistent - disk. For more information, read Zonal persistent - disks. - - The regionDisks resource represents a regional - persistent disk. For more information, read Regional - resources. (== resource_for {$api_version}.disks ==) - (== resource_for {$api_version}.regionDisks ==) + Represents a Persistent Disk resource. Google Compute + Engine has two Disk resources: \* + [Zonal](/compute/docs/reference/rest/v1/disks) \* + [Regional](/compute/docs/reference/rest/v1/regionDisks) + Persistent disks are required for running your VM + instances. Create both boot and non-boot (data) + persistent disks. For more information, read Persistent + Disks. For more storage options, read Storage options. + The disks resource represents a zonal persistent disk. + For more information, read Zonal persistent disks. The + regionDisks resource represents a regional persistent + disk. For more information, read Regional resources. """ # Create or coerce a protobuf request object. @@ -815,56 +775,44 @@ def get_iam_policy( Returns: google.cloud.compute_v1.types.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A Policy is a collection of bindings. A binding binds - one or more members to a single role. Members can be - user accounts, service accounts, Google groups, and - domains (such as G Suite). A role is a named list of - permissions; each role can be an IAM predefined role - or a user-created custom role. - - For some types of Google Cloud resources, a binding - can also specify a condition, which is a logical - expression that allows access to a resource only if - the expression evaluates to true. A condition can add - constraints based on attributes of the request, the - resource, or both. To learn which resources support - conditions in their IAM policies, see the [IAM - documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). - - **JSON example:** - - { "bindings": [ { "role": - "roles/resourcemanager.organizationAdmin", "members": - [ "user:mike@example.com", - "group:admins@example.com", "domain:google.com", - "serviceAccount:my-project-id@appspot.gserviceaccount.com" - ] }, { "role": - "roles/resourcemanager.organizationViewer", - "members": [ "user:eve@example.com" ], "condition": { - "title": "expirable access", "description": "Does not - grant access after Sep 2020", "expression": - "request.time < - timestamp('2020-10-01T00:00:00.000Z')", } } ], - "etag": "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - - bindings: - members: - user:\ mike@example.com - - group:\ admins@example.com - domain:google.com - - serviceAccount:\ my-project-id@appspot.gserviceaccount.com - role: roles/resourcemanager.organizationAdmin - - members: - user:\ eve@example.com role: - roles/resourcemanager.organizationViewer condition: - title: expirable access description: Does not grant - access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the - [IAM - documentation](\ https://cloud.google.com/iam/docs/). + specifies access controls for Google Cloud resources. A + Policy is a collection of bindings. A binding binds one + or more members to a single role. Members can be user + accounts, service accounts, Google groups, and domains + (such as G Suite). A role is a named list of + permissions; each role can be an IAM predefined role or + a user-created custom role. For some types of Google + Cloud resources, a binding can also specify a condition, + which is a logical expression that allows access to a + resource only if the expression evaluates to true. A + condition can add constraints based on attributes of the + request, the resource, or both. To learn which resources + support conditions in their IAM policies, see the [IAM + documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:\ mike@example.com - + group:\ admins@example.com - domain:google.com - + serviceAccount:\ my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:\ eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the [IAM + documentation](\ https://cloud.google.com/iam/docs/). """ # Create or coerce a protobuf request object. @@ -944,31 +892,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1136,31 +1074,21 @@ def remove_resource_policies( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1256,31 +1184,21 @@ def resize( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1377,56 +1295,44 @@ def set_iam_policy( Returns: google.cloud.compute_v1.types.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A Policy is a collection of bindings. A binding binds - one or more members to a single role. Members can be - user accounts, service accounts, Google groups, and - domains (such as G Suite). A role is a named list of - permissions; each role can be an IAM predefined role - or a user-created custom role. - - For some types of Google Cloud resources, a binding - can also specify a condition, which is a logical - expression that allows access to a resource only if - the expression evaluates to true. A condition can add - constraints based on attributes of the request, the - resource, or both. To learn which resources support - conditions in their IAM policies, see the [IAM - documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). - - **JSON example:** - - { "bindings": [ { "role": - "roles/resourcemanager.organizationAdmin", "members": - [ "user:mike@example.com", - "group:admins@example.com", "domain:google.com", - "serviceAccount:my-project-id@appspot.gserviceaccount.com" - ] }, { "role": - "roles/resourcemanager.organizationViewer", - "members": [ "user:eve@example.com" ], "condition": { - "title": "expirable access", "description": "Does not - grant access after Sep 2020", "expression": - "request.time < - timestamp('2020-10-01T00:00:00.000Z')", } } ], - "etag": "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - - bindings: - members: - user:\ mike@example.com - - group:\ admins@example.com - domain:google.com - - serviceAccount:\ my-project-id@appspot.gserviceaccount.com - role: roles/resourcemanager.organizationAdmin - - members: - user:\ eve@example.com role: - roles/resourcemanager.organizationViewer condition: - title: expirable access description: Does not grant - access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the - [IAM - documentation](\ https://cloud.google.com/iam/docs/). + specifies access controls for Google Cloud resources. A + Policy is a collection of bindings. A binding binds one + or more members to a single role. Members can be user + accounts, service accounts, Google groups, and domains + (such as G Suite). A role is a named list of + permissions; each role can be an IAM predefined role or + a user-created custom role. For some types of Google + Cloud resources, a binding can also specify a condition, + which is a logical expression that allows access to a + resource only if the expression evaluates to true. A + condition can add constraints based on attributes of the + request, the resource, or both. To learn which resources + support conditions in their IAM policies, see the [IAM + documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:\ mike@example.com - + group:\ admins@example.com - domain:google.com - + serviceAccount:\ my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:\ eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the [IAM + documentation](\ https://cloud.google.com/iam/docs/). """ # Create or coerce a protobuf request object. @@ -1519,31 +1425,21 @@ def set_labels( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/region_disks/transports/rest.py b/google/cloud/compute_v1/services/region_disks/transports/rest.py index 8a3e9fdc1..16a39f097 100644 --- a/google/cloud/compute_v1/services/region_disks/transports/rest.py +++ b/google/cloud/compute_v1/services/region_disks/transports/rest.py @@ -117,34 +117,21 @@ def add_resource_policies( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -204,34 +191,21 @@ def create_snapshot( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -291,34 +265,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -369,26 +330,18 @@ def get( Returns: ~.compute.Disk: - Represents a Persistent Disk resource. - - Google Compute Engine has two Disk resources: - - - `Zonal `__ - \* - `Regional `__ - + Represents a Persistent Disk resource. Google Compute + Engine has two Disk resources: \* + `Zonal `__ \* + `Regional `__ Persistent disks are required for running your VM instances. Create both boot and non-boot (data) persistent disks. For more information, read Persistent Disks. For more storage options, read Storage options. - The disks resource represents a zonal persistent disk. - For more information, read Zonal persistent disks. - - The regionDisks resource represents a regional - persistent disk. For more information, read Regional - resources. (== resource_for {$api_version}.disks ==) (== - resource_for {$api_version}.regionDisks ==) + For more information, read Zonal persistent disks. The + regionDisks resource represents a regional persistent + disk. For more information, read Regional resources. """ @@ -438,28 +391,22 @@ def get_iam_policy( Returns: ~.compute.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A ``Policy`` is a collection of ``bindings``. A + specifies access controls for Google Cloud resources. A + ``Policy`` is a collection of ``bindings``. A ``binding`` binds one or more ``members`` to a single ``role``. Members can be user accounts, service accounts, Google groups, and domains (such as G Suite). A ``role`` is a named list of permissions; each ``role`` can be an IAM predefined role or a user-created custom - role. - - For some types of Google Cloud resources, a ``binding`` - can also specify a ``condition``, which is a logical - expression that allows access to a resource only if the - expression evaluates to ``true``. A condition can add - constraints based on attributes of the request, the + role. For some types of Google Cloud resources, a + ``binding`` can also specify a ``condition``, which is a + logical expression that allows access to a resource only + if the expression evaluates to ``true``. A condition can + add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the `IAM documentation `__. - - **JSON example:** - - { "bindings": [ { "role": + **JSON example:** { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", @@ -470,10 +417,7 @@ def get_iam_policy( "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": - "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - + "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com @@ -482,10 +426,9 @@ def get_iam_policy( roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the `IAM + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the `IAM documentation `__. """ @@ -542,34 +485,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -683,34 +613,21 @@ def remove_resource_policies( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -770,34 +687,21 @@ def resize( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -858,28 +762,22 @@ def set_iam_policy( Returns: ~.compute.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A ``Policy`` is a collection of ``bindings``. A + specifies access controls for Google Cloud resources. A + ``Policy`` is a collection of ``bindings``. A ``binding`` binds one or more ``members`` to a single ``role``. Members can be user accounts, service accounts, Google groups, and domains (such as G Suite). A ``role`` is a named list of permissions; each ``role`` can be an IAM predefined role or a user-created custom - role. - - For some types of Google Cloud resources, a ``binding`` - can also specify a ``condition``, which is a logical - expression that allows access to a resource only if the - expression evaluates to ``true``. A condition can add - constraints based on attributes of the request, the + role. For some types of Google Cloud resources, a + ``binding`` can also specify a ``condition``, which is a + logical expression that allows access to a resource only + if the expression evaluates to ``true``. A condition can + add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the `IAM documentation `__. - - **JSON example:** - - { "bindings": [ { "role": + **JSON example:** { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", @@ -890,10 +788,7 @@ def set_iam_policy( "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": - "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - + "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com @@ -902,10 +797,9 @@ def set_iam_policy( roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the `IAM + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the `IAM documentation `__. """ @@ -964,34 +858,21 @@ def set_labels( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/region_health_check_services/client.py b/google/cloud/compute_v1/services/region_health_check_services/client.py index 0a87cafa5..2321ff38c 100644 --- a/google/cloud/compute_v1/services/region_health_check_services/client.py +++ b/google/cloud/compute_v1/services/region_health_check_services/client.py @@ -376,31 +376,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -485,10 +475,8 @@ def get( Returns: google.cloud.compute_v1.types.HealthCheckService: - Represents a Health-Check as a Service resource. - - (== resource_for - {$api_version}.regionHealthCheckServices ==) + Represents a Health-Check as a + Service resource. """ # Create or coerce a protobuf request object. @@ -571,31 +559,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -771,31 +749,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/region_health_check_services/transports/rest.py b/google/cloud/compute_v1/services/region_health_check_services/transports/rest.py index afd42000e..aed7ac66f 100644 --- a/google/cloud/compute_v1/services/region_health_check_services/transports/rest.py +++ b/google/cloud/compute_v1/services/region_health_check_services/transports/rest.py @@ -117,34 +117,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -195,10 +182,8 @@ def get( Returns: ~.compute.HealthCheckService: - Represents a Health-Check as a Service resource. - - (== resource_for - {$api_version}.regionHealthCheckServices ==) + Represents a Health-Check as a + Service resource. """ @@ -249,34 +234,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -393,34 +365,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/region_health_checks/client.py b/google/cloud/compute_v1/services/region_health_checks/client.py index d4319a20b..f78100c38 100644 --- a/google/cloud/compute_v1/services/region_health_checks/client.py +++ b/google/cloud/compute_v1/services/region_health_checks/client.py @@ -375,31 +375,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -484,34 +474,25 @@ def get( Returns: google.cloud.compute_v1.types.HealthCheck: - Represents a Health Check resource. - - Google Compute Engine has two Health Check resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/healthChecks) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionHealthChecks) - - Internal HTTP(S) load balancers must use regional - health checks (compute.v1.regionHealthChecks). - - Traffic Director must use global health checks - (compute.v1.HealthChecks). - - Internal TCP/UDP load balancers can use either - regional or global health checks - (compute.v1.regionHealthChecks or - compute.v1.HealthChecks). - - External HTTP(S), TCP proxy, and SSL proxy load - balancers as well as managed instance group - auto-healing must use global health checks - (compute.v1.HealthChecks). - - Network load balancers must use legacy HTTP health - checks (httpHealthChecks). - - For more information, see Health checks overview. + Represents a Health Check resource. Google Compute + Engine has two Health Check resources: \* + [Global](/compute/docs/reference/rest/v1/healthChecks) + \* + [Regional](/compute/docs/reference/rest/v1/regionHealthChecks) + Internal HTTP(S) load balancers must use regional health + checks (compute.v1.regionHealthChecks). Traffic Director + must use global health checks (compute.v1.HealthChecks). + Internal TCP/UDP load balancers can use either regional + or global health checks (compute.v1.regionHealthChecks + or compute.v1.HealthChecks). External HTTP(S), TCP + proxy, and SSL proxy load balancers as well as managed + instance group auto-healing must use global health + checks (compute.v1.HealthChecks). Backend service-based + network load balancers must use regional health checks + (compute.v1.regionHealthChecks). Target pool-based + network load balancers must use legacy HTTP health + checks (compute.v1.httpHealthChecks). For more + information, see Health checks overview. """ # Create or coerce a protobuf request object. @@ -593,31 +574,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -793,31 +764,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -911,31 +872,21 @@ def update( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/region_health_checks/transports/rest.py b/google/cloud/compute_v1/services/region_health_checks/transports/rest.py index ecf62c3f4..5a3fce8f6 100644 --- a/google/cloud/compute_v1/services/region_health_checks/transports/rest.py +++ b/google/cloud/compute_v1/services/region_health_checks/transports/rest.py @@ -117,34 +117,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -195,33 +182,25 @@ def get( Returns: ~.compute.HealthCheck: - Represents a Health Check resource. - - Google Compute Engine has two Health Check resources: - - - `Global `__ - \* - `Regional `__ - + Represents a Health Check resource. Google Compute + Engine has two Health Check resources: \* + `Global `__ + \* + `Regional `__ Internal HTTP(S) load balancers must use regional health - checks (``compute.v1.regionHealthChecks``). - - Traffic Director must use global health checks - (``compute.v1.HealthChecks``). - - Internal TCP/UDP load balancers can use either regional - or global health checks - (``compute.v1.regionHealthChecks`` or - ``compute.v1.HealthChecks``). - - External HTTP(S), TCP proxy, and SSL proxy load - balancers as well as managed instance group auto-healing - must use global health checks - (``compute.v1.HealthChecks``). - - Network load balancers must use legacy HTTP health - checks (httpHealthChecks). - + checks (``compute.v1.regionHealthChecks``). Traffic + Director must use global health checks + (``compute.v1.HealthChecks``). Internal TCP/UDP load + balancers can use either regional or global health + checks (``compute.v1.regionHealthChecks`` or + ``compute.v1.HealthChecks``). External HTTP(S), TCP + proxy, and SSL proxy load balancers as well as managed + instance group auto-healing must use global health + checks (``compute.v1.HealthChecks``). Backend + service-based network load balancers must use regional + health checks (``compute.v1.regionHealthChecks``). + Target pool-based network load balancers must use legacy + HTTP health checks (``compute.v1.httpHealthChecks``). For more information, see Health checks overview. """ @@ -273,34 +252,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -416,34 +382,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -503,34 +456,21 @@ def update( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/region_instance_group_managers/client.py b/google/cloud/compute_v1/services/region_instance_group_managers/client.py index 86e099aba..a16cb48e7 100644 --- a/google/cloud/compute_v1/services/region_instance_group_managers/client.py +++ b/google/cloud/compute_v1/services/region_instance_group_managers/client.py @@ -354,13 +354,12 @@ def abandon_instances( is marked as DONE when the action is scheduled even if the instances have not yet been removed from the group. You must separately verify the status of the abandoning - action with the listmanagedinstances method. If the + action with the listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the - VM instance is removed or deleted. - You can specify a maximum of 1000 instances with this - method per request. + VM instance is removed or deleted. You can specify a + maximum of 1000 instances with this method per request. Args: request (google.cloud.compute_v1.types.AbandonInstancesRegionInstanceGroupManagerRequest): @@ -397,31 +396,21 @@ def abandon_instances( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -527,31 +516,21 @@ def apply_updates_to_instances( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -668,31 +647,21 @@ def create_instances( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -792,31 +761,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -875,13 +834,12 @@ def delete_instances( if the deleteInstances request is successful. The underlying actions take additional time. You must separately verify the status of the deleting action with - the listmanagedinstances method. If the group is part - of a backend service that has enabled connection - draining, it can take up to 60 seconds after the - connection draining duration has elapsed before the VM - instance is removed or deleted. - You can specify a maximum of 1000 instances with this - method per request. + the listmanagedinstances method. If the group is part of + a backend service that has enabled connection draining, + it can take up to 60 seconds after the connection + draining duration has elapsed before the VM instance is + removed or deleted. You can specify a maximum of 1000 + instances with this method per request. Args: request (google.cloud.compute_v1.types.DeleteInstancesRegionInstanceGroupManagerRequest): @@ -918,31 +876,21 @@ def delete_instances( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1048,31 +996,21 @@ def delete_per_instance_configs( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1176,20 +1114,15 @@ def get( Returns: google.cloud.compute_v1.types.InstanceGroupManager: - Represents a Managed Instance Group resource. - - An instance group is a collection of VM instances - that you can manage as a single entity. For more - information, read Instance groups. - - For zonal Managed Instance Group, use the - instanceGroupManagers resource. - - For regional Managed Instance Group, use the - regionInstanceGroupManagers resource. (== - resource_for {$api_version}.instanceGroupManagers ==) - (== resource_for - {$api_version}.regionInstanceGroupManagers ==) + Represents a Managed Instance Group + resource. An instance group is a + collection of VM instances that you can + manage as a single entity. For more + information, read Instance groups. For + zonal Managed Instance Group, use the + instanceGroupManagers resource. For + regional Managed Instance Group, use the + regionInstanceGroupManagers resource. """ # Create or coerce a protobuf request object. @@ -1245,7 +1178,7 @@ def insert( marked as DONE when the group is created even if the instances in the group have not yet been created. You must separately verify the status of the individual - instances with the listmanagedinstances method. A + instances with the listmanagedinstances method. A regional managed instance group can contain up to 2000 instances. @@ -1279,31 +1212,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1463,7 +1386,7 @@ def list_errors( The name of the managed instance group. It must be a string that meets the requirements in RFC1035, or an unsigned long integer: must match regexp pattern: - (?:`a-z `__?)|[1-9][0-9]{0,19}. + (?:`a-z `__?)|1-9{0,19}. This corresponds to the ``instance_group_manager`` field on the ``request`` instance; if ``request`` is provided, this @@ -1742,7 +1665,12 @@ def patch( status of the individual instances with the listmanagedinstances method. This method supports PATCH semantics and uses the JSON merge patch format and - processing rules. + processing rules. If you update your group to specify a + new template or instance configuration, it's possible + that your intended specification for each VM in the + group is different from the current state of that VM. To + learn how to apply an updated configuration to the VMs + in a MIG, see Updating instances in a MIG. Args: request (google.cloud.compute_v1.types.PatchRegionInstanceGroupManagerRequest): @@ -1781,31 +1709,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1903,31 +1821,21 @@ def patch_per_instance_configs( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -2005,7 +1913,7 @@ def recreate_instances( recreated. You must separately verify the status of each instance by checking its currentAction field; for more information, see Checking the status of managed - instances. If the group is part of a backend service + instances. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. @@ -2047,31 +1955,21 @@ def recreate_instances( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -2140,15 +2038,15 @@ def resize( group. If you increase the size, the group creates new instances using the current instance template. If you decrease the size, the group deletes one or more - instances. The resize operation is marked DONE if the + instances. The resize operation is marked DONE if the resize request is successful. The underlying actions take additional time. You must separately verify the status of the creating or deleting actions with the - listmanagedinstances method. - If the group is part of a backend service that has - enabled connection draining, it can take up to 60 - seconds after the connection draining duration has - elapsed before the VM instance is removed or deleted. + listmanagedinstances method. If the group is part of a + backend service that has enabled connection draining, it + can take up to 60 seconds after the connection draining + duration has elapsed before the VM instance is removed + or deleted. Args: request (google.cloud.compute_v1.types.ResizeRegionInstanceGroupManagerRequest): @@ -2187,31 +2085,21 @@ def resize( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -2304,31 +2192,21 @@ def set_instance_template( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -2432,31 +2310,21 @@ def set_target_pools( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -2564,31 +2432,21 @@ def update_per_instance_configs( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/region_instance_group_managers/transports/rest.py b/google/cloud/compute_v1/services/region_instance_group_managers/transports/rest.py index f3ffd371c..5c0a0a2a5 100644 --- a/google/cloud/compute_v1/services/region_instance_group_managers/transports/rest.py +++ b/google/cloud/compute_v1/services/region_instance_group_managers/transports/rest.py @@ -117,34 +117,21 @@ def abandon_instances( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -208,34 +195,21 @@ def apply_updates_to_instances( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -293,34 +267,21 @@ def create_instances( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -383,34 +344,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -461,34 +409,21 @@ def delete_instances( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -552,34 +487,21 @@ def delete_per_instance_configs( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -637,20 +559,15 @@ def get( Returns: ~.compute.InstanceGroupManager: - Represents a Managed Instance Group resource. - - An instance group is a collection of VM instances that - you can manage as a single entity. For more information, - read Instance groups. - - For zonal Managed Instance Group, use the - instanceGroupManagers resource. - - For regional Managed Instance Group, use the - regionInstanceGroupManagers resource. (== resource_for - {$api_version}.instanceGroupManagers ==) (== - resource_for {$api_version}.regionInstanceGroupManagers - ==) + Represents a Managed Instance Group + resource. An instance group is a + collection of VM instances that you can + manage as a single entity. For more + information, read Instance groups. For + zonal Managed Instance Group, use the + instanceGroupManagers resource. For + regional Managed Instance Group, use the + regionInstanceGroupManagers resource. """ @@ -701,34 +618,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -1060,34 +964,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -1148,34 +1039,21 @@ def patch_per_instance_configs( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -1238,34 +1116,21 @@ def recreate_instances( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -1328,34 +1193,21 @@ def resize( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -1407,34 +1259,21 @@ def set_instance_template( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -1497,34 +1336,21 @@ def set_target_pools( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -1588,34 +1414,21 @@ def update_per_instance_configs( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/region_instance_groups/client.py b/google/cloud/compute_v1/services/region_instance_groups/client.py index c1accafd4..13b4caca1 100644 --- a/google/cloud/compute_v1/services/region_instance_groups/client.py +++ b/google/cloud/compute_v1/services/region_instance_groups/client.py @@ -375,28 +375,20 @@ def get( Returns: google.cloud.compute_v1.types.InstanceGroup: - Represents an Instance Group resource. - - Instance Groups can be used to configure a target for - load balancing. - - Instance groups can either be managed or unmanaged. - - To create managed instance groups, use the - instanceGroupManager or regionInstanceGroupManager - resource instead. - - Use zonal unmanaged instance groups if you need to - apply load balancing to groups of heterogeneous - instances or if you need to manage the instances - yourself. You cannot create regional unmanaged - instance groups. - - For more information, read Instance groups. - - (== resource_for {$api_version}.instanceGroups ==) - (== resource_for {$api_version}.regionInstanceGroups - ==) + Represents an Instance Group + resource. Instance Groups can be used to + configure a target for load balancing. + Instance groups can either be managed or + unmanaged. To create managed instance + groups, use the instanceGroupManager or + regionInstanceGroupManager resource + instead. Use zonal unmanaged instance + groups if you need to apply load + balancing to groups of heterogeneous + instances or if you need to manage the + instances yourself. You cannot create + regional unmanaged instance groups. For + more information, read Instance groups. """ # Create or coerce a protobuf request object. @@ -682,31 +674,21 @@ def set_named_ports( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/region_instance_groups/transports/rest.py b/google/cloud/compute_v1/services/region_instance_groups/transports/rest.py index d292688b1..b55c8b823 100644 --- a/google/cloud/compute_v1/services/region_instance_groups/transports/rest.py +++ b/google/cloud/compute_v1/services/region_instance_groups/transports/rest.py @@ -117,26 +117,20 @@ def get( Returns: ~.compute.InstanceGroup: - Represents an Instance Group resource. - - Instance Groups can be used to configure a target for - load balancing. - - Instance groups can either be managed or unmanaged. - - To create managed instance groups, use the - instanceGroupManager or regionInstanceGroupManager - resource instead. - - Use zonal unmanaged instance groups if you need to apply - load balancing to groups of heterogeneous instances or - if you need to manage the instances yourself. You cannot - create regional unmanaged instance groups. - - For more information, read Instance groups. - - (== resource_for {$api_version}.instanceGroups ==) (== - resource_for {$api_version}.regionInstanceGroups ==) + Represents an Instance Group + resource. Instance Groups can be used to + configure a target for load balancing. + Instance groups can either be managed or + unmanaged. To create managed instance + groups, use the instanceGroupManager or + regionInstanceGroupManager resource + instead. Use zonal unmanaged instance + groups if you need to apply load + balancing to groups of heterogeneous + instances or if you need to manage the + instances yourself. You cannot create + regional unmanaged instance groups. For + more information, read Instance groups. """ @@ -318,34 +312,21 @@ def set_named_ports( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/region_instances/client.py b/google/cloud/compute_v1/services/region_instances/client.py index c98ec0934..f0a626248 100644 --- a/google/cloud/compute_v1/services/region_instances/client.py +++ b/google/cloud/compute_v1/services/region_instances/client.py @@ -371,31 +371,21 @@ def bulk_insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/region_instances/transports/rest.py b/google/cloud/compute_v1/services/region_instances/transports/rest.py index eecc61e45..a86bd9875 100644 --- a/google/cloud/compute_v1/services/region_instances/transports/rest.py +++ b/google/cloud/compute_v1/services/region_instances/transports/rest.py @@ -117,34 +117,21 @@ def bulk_insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/region_network_endpoint_groups/client.py b/google/cloud/compute_v1/services/region_network_endpoint_groups/client.py index abbe6ce69..e9db050b8 100644 --- a/google/cloud/compute_v1/services/region_network_endpoint_groups/client.py +++ b/google/cloud/compute_v1/services/region_network_endpoint_groups/client.py @@ -381,31 +381,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -491,20 +481,17 @@ def get( Returns: google.cloud.compute_v1.types.NetworkEndpointGroup: - Represents a collection of network endpoints. - - A network endpoint group (NEG) defines how a set of - endpoints should be reached, whether they are - reachable, and where they are located. For more - information about using NEGs, see Setting up external - HTTP(S) Load Balancing with internet NEGs, Setting up - zonal NEGs, or Setting up external HTTP(S) Load - Balancing with serverless NEGs. (== resource_for - {$api_version}.networkEndpointGroups ==) (== - resource_for - {$api_version}.globalNetworkEndpointGroups ==) (== - resource_for - {$api_version}.regionNetworkEndpointGroups ==) + Represents a collection of network + endpoints. A network endpoint group + (NEG) defines how a set of endpoints + should be reached, whether they are + reachable, and where they are located. + For more information about using NEGs, + see Setting up external HTTP(S) Load + Balancing with internet NEGs, Setting up + zonal NEGs, or Setting up external + HTTP(S) Load Balancing with serverless + NEGs. """ # Create or coerce a protobuf request object. @@ -588,31 +575,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/region_network_endpoint_groups/transports/rest.py b/google/cloud/compute_v1/services/region_network_endpoint_groups/transports/rest.py index 368138aec..73bf7b577 100644 --- a/google/cloud/compute_v1/services/region_network_endpoint_groups/transports/rest.py +++ b/google/cloud/compute_v1/services/region_network_endpoint_groups/transports/rest.py @@ -117,34 +117,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -195,19 +182,17 @@ def get( Returns: ~.compute.NetworkEndpointGroup: - Represents a collection of network endpoints. - - A network endpoint group (NEG) defines how a set of - endpoints should be reached, whether they are reachable, - and where they are located. For more information about - using NEGs, see Setting up external HTTP(S) Load - Balancing with internet NEGs, Setting up zonal NEGs, or - Setting up external HTTP(S) Load Balancing with - serverless NEGs. (== resource_for - {$api_version}.networkEndpointGroups ==) (== - resource_for {$api_version}.globalNetworkEndpointGroups - ==) (== resource_for - {$api_version}.regionNetworkEndpointGroups ==) + Represents a collection of network + endpoints. A network endpoint group + (NEG) defines how a set of endpoints + should be reached, whether they are + reachable, and where they are located. + For more information about using NEGs, + see Setting up external HTTP(S) Load + Balancing with internet NEGs, Setting up + zonal NEGs, or Setting up external + HTTP(S) Load Balancing with serverless + NEGs. """ @@ -258,34 +243,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/region_notification_endpoints/client.py b/google/cloud/compute_v1/services/region_notification_endpoints/client.py index d0570c8a6..adf6de44d 100644 --- a/google/cloud/compute_v1/services/region_notification_endpoints/client.py +++ b/google/cloud/compute_v1/services/region_notification_endpoints/client.py @@ -378,31 +378,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -486,17 +476,13 @@ def get( Returns: google.cloud.compute_v1.types.NotificationEndpoint: - Represents a notification endpoint. - - A notification endpoint resource defines an endpoint - to receive notifications when there are status - changes detected by the associated health check - service. - - For more information, see Health checks overview. (== - resource_for {$api_version}.notificationEndpoint ==) - (== resource_for - {$api_version}.regionNotificationEndpoints ==) + Represents a notification endpoint. A + notification endpoint resource defines + an endpoint to receive notifications + when there are status changes detected + by the associated health check service. + For more information, see Health checks + overview. """ # Create or coerce a protobuf request object. @@ -579,31 +565,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/region_notification_endpoints/transports/rest.py b/google/cloud/compute_v1/services/region_notification_endpoints/transports/rest.py index 19604f40b..b89785bad 100644 --- a/google/cloud/compute_v1/services/region_notification_endpoints/transports/rest.py +++ b/google/cloud/compute_v1/services/region_notification_endpoints/transports/rest.py @@ -117,34 +117,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -195,16 +182,13 @@ def get( Returns: ~.compute.NotificationEndpoint: - Represents a notification endpoint. - - A notification endpoint resource defines an endpoint to - receive notifications when there are status changes - detected by the associated health check service. - - For more information, see Health checks overview. (== - resource_for {$api_version}.notificationEndpoint ==) (== - resource_for {$api_version}.regionNotificationEndpoints - ==) + Represents a notification endpoint. A + notification endpoint resource defines + an endpoint to receive notifications + when there are status changes detected + by the associated health check service. + For more information, see Health checks + overview. """ @@ -255,34 +239,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/region_operations/client.py b/google/cloud/compute_v1/services/region_operations/client.py index 26c947209..8cb2b305c 100644 --- a/google/cloud/compute_v1/services/region_operations/client.py +++ b/google/cloud/compute_v1/services/region_operations/client.py @@ -456,31 +456,21 @@ def get( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -617,15 +607,13 @@ def wait( from the ``GET`` method in that it waits for no more than the default deadline (2 minutes) and then returns the current state of the operation, which might be ``DONE`` or still in progress. - - This method is called on a best-effort basis. Specifically: - - - In uncommon cases, when the server is overloaded, the request - might return before the default deadline is reached, or might - return after zero seconds. - - If the default deadline is reached, there is no guarantee - that the operation is actually done when the method returns. - Be prepared to retry if the operation is not ``DONE``. + This method is called on a best-effort basis. Specifically: - In + uncommon cases, when the server is overloaded, the request might + return before the default deadline is reached, or might return + after zero seconds. - If the default deadline is reached, there + is no guarantee that the operation is actually done when the + method returns. Be prepared to retry if the operation is not + ``DONE``. Args: request (google.cloud.compute_v1.types.WaitRegionOperationRequest): @@ -657,31 +645,21 @@ def wait( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/region_operations/transports/rest.py b/google/cloud/compute_v1/services/region_operations/transports/rest.py index 9a98a8e72..cbfbbafb1 100644 --- a/google/cloud/compute_v1/services/region_operations/transports/rest.py +++ b/google/cloud/compute_v1/services/region_operations/transports/rest.py @@ -170,34 +170,21 @@ def get( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -305,34 +292,21 @@ def wait( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/region_ssl_certificates/client.py b/google/cloud/compute_v1/services/region_ssl_certificates/client.py index c6b23615a..36c3e1b57 100644 --- a/google/cloud/compute_v1/services/region_ssl_certificates/client.py +++ b/google/cloud/compute_v1/services/region_ssl_certificates/client.py @@ -376,31 +376,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -485,31 +475,22 @@ def get( Returns: google.cloud.compute_v1.types.SslCertificate: - Represents an SSL Certificate resource. - - Google Compute Engine has two SSL Certificate - resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/sslCertificates) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionSslCertificates) - - The sslCertificates are used by: - external HTTPS - load balancers - SSL proxy load balancers - - The regionSslCertificates are used by internal HTTPS - load balancers. - - Optionally, certificate file contents that you upload - can contain a set of up to five PEM-encoded - certificates. The API call creates an object - (sslCertificate) that holds this data. You can use - SSL keys and certificates to secure connections to a - load balancer. For more information, read Creating - and using SSL certificates, SSL certificates quotas - and limits, and Troubleshooting SSL certificates. (== - resource_for {$api_version}.sslCertificates ==) (== - resource_for {$api_version}.regionSslCertificates ==) + Represents an SSL Certificate resource. Google Compute + Engine has two SSL Certificate resources: \* + [Global](/compute/docs/reference/rest/v1/sslCertificates) + \* + [Regional](/compute/docs/reference/rest/v1/regionSslCertificates) + The sslCertificates are used by: - external HTTPS load + balancers - SSL proxy load balancers The + regionSslCertificates are used by internal HTTPS load + balancers. Optionally, certificate file contents that + you upload can contain a set of up to five PEM-encoded + certificates. The API call creates an object + (sslCertificate) that holds this data. You can use SSL + keys and certificates to secure connections to a load + balancer. For more information, read Creating and using + SSL certificates, SSL certificates quotas and limits, + and Troubleshooting SSL certificates. """ # Create or coerce a protobuf request object. @@ -592,31 +573,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/region_ssl_certificates/transports/rest.py b/google/cloud/compute_v1/services/region_ssl_certificates/transports/rest.py index 23813cc42..a6cf530b3 100644 --- a/google/cloud/compute_v1/services/region_ssl_certificates/transports/rest.py +++ b/google/cloud/compute_v1/services/region_ssl_certificates/transports/rest.py @@ -117,34 +117,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -195,32 +182,22 @@ def get( Returns: ~.compute.SslCertificate: - Represents an SSL Certificate resource. - - Google Compute Engine has two SSL Certificate resources: - - - `Global `__ - \* - `Regional `__ - - The sslCertificates are used by: - - - external HTTPS load balancers - - SSL proxy load balancers - - The regionSslCertificates are used by internal HTTPS - load balancers. - - Optionally, certificate file contents that you upload - can contain a set of up to five PEM-encoded + Represents an SSL Certificate resource. Google Compute + Engine has two SSL Certificate resources: \* + `Global `__ + \* + `Regional `__ + The sslCertificates are used by: - external HTTPS load + balancers - SSL proxy load balancers The + regionSslCertificates are used by internal HTTPS load + balancers. Optionally, certificate file contents that + you upload can contain a set of up to five PEM-encoded certificates. The API call creates an object (sslCertificate) that holds this data. You can use SSL keys and certificates to secure connections to a load balancer. For more information, read Creating and using SSL certificates, SSL certificates quotas and limits, - and Troubleshooting SSL certificates. (== resource_for - {$api_version}.sslCertificates ==) (== resource_for - {$api_version}.regionSslCertificates ==) + and Troubleshooting SSL certificates. """ @@ -271,34 +248,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/region_target_http_proxies/client.py b/google/cloud/compute_v1/services/region_target_http_proxies/client.py index 254d0886e..ba7cfc837 100644 --- a/google/cloud/compute_v1/services/region_target_http_proxies/client.py +++ b/google/cloud/compute_v1/services/region_target_http_proxies/client.py @@ -375,31 +375,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -484,29 +474,19 @@ def get( Returns: google.cloud.compute_v1.types.TargetHttpProxy: - Represents a Target HTTP Proxy resource. - - Google Compute Engine has two Target HTTP Proxy - resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/targetHttpProxies) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionTargetHttpProxies) - - A target HTTP proxy is a component of GCP HTTP load - balancers. - - - targetHttpProxies are used by external HTTP load - balancers and Traffic Director. \* - regionTargetHttpProxies are used by internal HTTP - load balancers. - - Forwarding rules reference a target HTTP proxy, and - the target proxy then references a URL map. For more - information, read Using Target Proxies and Forwarding - rule concepts. (== resource_for - {$api_version}.targetHttpProxies ==) (== resource_for - {$api_version}.regionTargetHttpProxies ==) + Represents a Target HTTP Proxy resource. Google Compute + Engine has two Target HTTP Proxy resources: \* + [Global](/compute/docs/reference/rest/v1/targetHttpProxies) + \* + [Regional](/compute/docs/reference/rest/v1/regionTargetHttpProxies) + A target HTTP proxy is a component of GCP HTTP load + balancers. \* targetHttpProxies are used by external + HTTP load balancers and Traffic Director. \* + regionTargetHttpProxies are used by internal HTTP load + balancers. Forwarding rules reference a target HTTP + proxy, and the target proxy then references a URL map. + For more information, read Using Target Proxies and + Forwarding rule concepts. """ # Create or coerce a protobuf request object. @@ -589,31 +569,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -786,31 +756,21 @@ def set_url_map( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/region_target_http_proxies/transports/rest.py b/google/cloud/compute_v1/services/region_target_http_proxies/transports/rest.py index 6168212e0..23e226df8 100644 --- a/google/cloud/compute_v1/services/region_target_http_proxies/transports/rest.py +++ b/google/cloud/compute_v1/services/region_target_http_proxies/transports/rest.py @@ -117,34 +117,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -195,29 +182,19 @@ def get( Returns: ~.compute.TargetHttpProxy: - Represents a Target HTTP Proxy resource. - - Google Compute Engine has two Target HTTP Proxy - resources: - - - `Global `__ - \* - `Regional `__ - + Represents a Target HTTP Proxy resource. Google Compute + Engine has two Target HTTP Proxy resources: \* + `Global `__ + \* + `Regional `__ A target HTTP proxy is a component of GCP HTTP load - balancers. - - - targetHttpProxies are used by external HTTP load - balancers and Traffic Director. \* - regionTargetHttpProxies are used by internal HTTP - load balancers. - - Forwarding rules reference a target HTTP proxy, and the - target proxy then references a URL map. For more - information, read Using Target Proxies and Forwarding - rule concepts. (== resource_for - {$api_version}.targetHttpProxies ==) (== resource_for - {$api_version}.regionTargetHttpProxies ==) + balancers. \* targetHttpProxies are used by external + HTTP load balancers and Traffic Director. \* + regionTargetHttpProxies are used by internal HTTP load + balancers. Forwarding rules reference a target HTTP + proxy, and the target proxy then references a URL map. + For more information, read Using Target Proxies and + Forwarding rule concepts. """ @@ -268,34 +245,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -409,34 +373,21 @@ def set_url_map( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/region_target_https_proxies/client.py b/google/cloud/compute_v1/services/region_target_https_proxies/client.py index 73cb8be42..dbb922c85 100644 --- a/google/cloud/compute_v1/services/region_target_https_proxies/client.py +++ b/google/cloud/compute_v1/services/region_target_https_proxies/client.py @@ -375,31 +375,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -484,29 +474,18 @@ def get( Returns: google.cloud.compute_v1.types.TargetHttpsProxy: - Represents a Target HTTPS Proxy resource. - - Google Compute Engine has two Target HTTPS Proxy - resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/targetHttpsProxies) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionTargetHttpsProxies) - - A target HTTPS proxy is a component of GCP HTTPS load - balancers. - - - targetHttpsProxies are used by external HTTPS load - balancers. \* regionTargetHttpsProxies are used by - internal HTTPS load balancers. - - Forwarding rules reference a target HTTPS proxy, and - the target proxy then references a URL map. For more - information, read Using Target Proxies and Forwarding - rule concepts. (== resource_for - {$api_version}.targetHttpsProxies ==) (== - resource_for {$api_version}.regionTargetHttpsProxies - ==) + Represents a Target HTTPS Proxy resource. Google Compute + Engine has two Target HTTPS Proxy resources: \* + [Global](/compute/docs/reference/rest/v1/targetHttpsProxies) + \* + [Regional](/compute/docs/reference/rest/v1/regionTargetHttpsProxies) + A target HTTPS proxy is a component of GCP HTTPS load + balancers. \* targetHttpsProxies are used by external + HTTPS load balancers. \* regionTargetHttpsProxies are + used by internal HTTPS load balancers. Forwarding rules + reference a target HTTPS proxy, and the target proxy + then references a URL map. For more information, read + Using Target Proxies and Forwarding rule concepts. """ # Create or coerce a protobuf request object. @@ -589,31 +568,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -787,31 +756,21 @@ def set_ssl_certificates( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -916,31 +875,21 @@ def set_url_map( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/region_target_https_proxies/transports/rest.py b/google/cloud/compute_v1/services/region_target_https_proxies/transports/rest.py index c80d2b733..f1dd47b53 100644 --- a/google/cloud/compute_v1/services/region_target_https_proxies/transports/rest.py +++ b/google/cloud/compute_v1/services/region_target_https_proxies/transports/rest.py @@ -117,34 +117,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -195,28 +182,18 @@ def get( Returns: ~.compute.TargetHttpsProxy: - Represents a Target HTTPS Proxy resource. - - Google Compute Engine has two Target HTTPS Proxy - resources: - - - `Global `__ - \* - `Regional `__ - + Represents a Target HTTPS Proxy resource. Google Compute + Engine has two Target HTTPS Proxy resources: \* + `Global `__ + \* + `Regional `__ A target HTTPS proxy is a component of GCP HTTPS load - balancers. - - - targetHttpsProxies are used by external HTTPS load - balancers. \* regionTargetHttpsProxies are used by - internal HTTPS load balancers. - - Forwarding rules reference a target HTTPS proxy, and the - target proxy then references a URL map. For more - information, read Using Target Proxies and Forwarding - rule concepts. (== resource_for - {$api_version}.targetHttpsProxies ==) (== resource_for - {$api_version}.regionTargetHttpsProxies ==) + balancers. \* targetHttpsProxies are used by external + HTTPS load balancers. \* regionTargetHttpsProxies are + used by internal HTTPS load balancers. Forwarding rules + reference a target HTTPS proxy, and the target proxy + then references a URL map. For more information, read + Using Target Proxies and Forwarding rule concepts. """ @@ -267,34 +244,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -413,34 +377,21 @@ def set_ssl_certificates( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -503,34 +454,21 @@ def set_url_map( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/region_url_maps/client.py b/google/cloud/compute_v1/services/region_url_maps/client.py index e5e02e1da..5d19110a5 100644 --- a/google/cloud/compute_v1/services/region_url_maps/client.py +++ b/google/cloud/compute_v1/services/region_url_maps/client.py @@ -371,31 +371,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -479,39 +469,27 @@ def get( Returns: google.cloud.compute_v1.types.UrlMap: - Represents a URL Map resource. - - Google Compute Engine has two URL Map resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/urlMaps) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionUrlMaps) - - A URL map resource is a component of certain types of - GCP load balancers and Traffic Director. - - - urlMaps are used by external HTTP(S) load - balancers and Traffic Director. \* regionUrlMaps - are used by internal HTTP(S) load balancers. - - For a list of supported URL map features by load - balancer type, see the Load balancing features: - Routing and traffic management table. - - For a list of supported URL map features for Traffic - Director, see the Traffic Director features: Routing - and traffic management table. - - This resource defines mappings from host names and - URL paths to either a backend service or a backend - bucket. - - To use the global urlMaps resource, the backend - service must have a loadBalancingScheme of either - EXTERNAL or INTERNAL_SELF_MANAGED. To use the - regionUrlMaps resource, the backend service must have - a loadBalancingScheme of INTERNAL_MANAGED. For more - information, read URL Map Concepts. + Represents a URL Map resource. Google Compute Engine has + two URL Map resources: \* + [Global](/compute/docs/reference/rest/v1/urlMaps) \* + [Regional](/compute/docs/reference/rest/v1/regionUrlMaps) + A URL map resource is a component of certain types of + GCP load balancers and Traffic Director. \* urlMaps are + used by external HTTP(S) load balancers and Traffic + Director. \* regionUrlMaps are used by internal HTTP(S) + load balancers. For a list of supported URL map features + by load balancer type, see the Load balancing features: + Routing and traffic management table. For a list of + supported URL map features for Traffic Director, see the + Traffic Director features: Routing and traffic + management table. This resource defines mappings from + host names and URL paths to either a backend service or + a backend bucket. To use the global urlMaps resource, + the backend service must have a loadBalancingScheme of + either EXTERNAL or INTERNAL_SELF_MANAGED. To use the + regionUrlMaps resource, the backend service must have a + loadBalancingScheme of INTERNAL_MANAGED. For more + information, read URL Map Concepts. """ # Create or coerce a protobuf request object. @@ -593,31 +571,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -790,31 +758,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -906,31 +864,21 @@ def update( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/region_url_maps/transports/rest.py b/google/cloud/compute_v1/services/region_url_maps/transports/rest.py index 850f767ba..3d60692ac 100644 --- a/google/cloud/compute_v1/services/region_url_maps/transports/rest.py +++ b/google/cloud/compute_v1/services/region_url_maps/transports/rest.py @@ -117,34 +117,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -195,36 +182,25 @@ def get( Returns: ~.compute.UrlMap: - Represents a URL Map resource. - - Google Compute Engine has two URL Map resources: - - - `Global `__ - \* - `Regional `__ - + Represents a URL Map resource. Google Compute Engine has + two URL Map resources: \* + `Global `__ \* + `Regional `__ A URL map resource is a component of certain types of - GCP load balancers and Traffic Director. - - - urlMaps are used by external HTTP(S) load balancers - and Traffic Director. \* regionUrlMaps are used by - internal HTTP(S) load balancers. - - For a list of supported URL map features by load - balancer type, see the Load balancing features: Routing - and traffic management table. - - For a list of supported URL map features for Traffic - Director, see the Traffic Director features: Routing and - traffic management table. - - This resource defines mappings from host names and URL - paths to either a backend service or a backend bucket. - - To use the global urlMaps resource, the backend service - must have a loadBalancingScheme of either EXTERNAL or - INTERNAL_SELF_MANAGED. To use the regionUrlMaps - resource, the backend service must have a + GCP load balancers and Traffic Director. \* urlMaps are + used by external HTTP(S) load balancers and Traffic + Director. \* regionUrlMaps are used by internal HTTP(S) + load balancers. For a list of supported URL map features + by load balancer type, see the Load balancing features: + Routing and traffic management table. For a list of + supported URL map features for Traffic Director, see the + Traffic Director features: Routing and traffic + management table. This resource defines mappings from + host names and URL paths to either a backend service or + a backend bucket. To use the global urlMaps resource, + the backend service must have a loadBalancingScheme of + either EXTERNAL or INTERNAL_SELF_MANAGED. To use the + regionUrlMaps resource, the backend service must have a loadBalancingScheme of INTERNAL_MANAGED. For more information, read URL Map Concepts. @@ -275,34 +251,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -416,34 +379,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -503,34 +453,21 @@ def update( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/regions/client.py b/google/cloud/compute_v1/services/regions/client.py index 2a363de0b..113cd2c2c 100644 --- a/google/cloud/compute_v1/services/regions/client.py +++ b/google/cloud/compute_v1/services/regions/client.py @@ -363,11 +363,10 @@ def get( Returns: google.cloud.compute_v1.types.Region: - Represents a Region resource. - - A region is a geographical area where a resource is - located. For more information, read Regions and - Zones. (== resource_for {$api_version}.regions ==) + Represents a Region resource. A + region is a geographical area where a + resource is located. For more + information, read Regions and Zones. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/regions/transports/rest.py b/google/cloud/compute_v1/services/regions/transports/rest.py index b2b35f0ed..e7f55df23 100644 --- a/google/cloud/compute_v1/services/regions/transports/rest.py +++ b/google/cloud/compute_v1/services/regions/transports/rest.py @@ -116,11 +116,10 @@ def get( Returns: ~.compute.Region: - Represents a Region resource. - - A region is a geographical area where a resource is - located. For more information, read Regions and Zones. - (== resource_for {$api_version}.regions ==) + Represents a Region resource. A + region is a geographical area where a + resource is located. For more + information, read Regions and Zones. """ diff --git a/google/cloud/compute_v1/services/reservations/client.py b/google/cloud/compute_v1/services/reservations/client.py index 795722b4c..323b647dd 100644 --- a/google/cloud/compute_v1/services/reservations/client.py +++ b/google/cloud/compute_v1/services/reservations/client.py @@ -439,31 +439,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -543,11 +533,12 @@ def get( Returns: google.cloud.compute_v1.types.Reservation: - Represents a reservation resource. A reservation ensures - that capacity is held in a specific zone even if the - reserved VMs are not running. For more information, read - Reserving zonal resources. (== resource_for - {$api_version}.reservations ==) + Represents a reservation resource. A + reservation ensures that capacity is + held in a specific zone even if the + reserved VMs are not running. For more + information, read Reserving zonal + resources. """ # Create or coerce a protobuf request object. @@ -632,56 +623,44 @@ def get_iam_policy( Returns: google.cloud.compute_v1.types.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A Policy is a collection of bindings. A binding binds - one or more members to a single role. Members can be - user accounts, service accounts, Google groups, and - domains (such as G Suite). A role is a named list of - permissions; each role can be an IAM predefined role - or a user-created custom role. - - For some types of Google Cloud resources, a binding - can also specify a condition, which is a logical - expression that allows access to a resource only if - the expression evaluates to true. A condition can add - constraints based on attributes of the request, the - resource, or both. To learn which resources support - conditions in their IAM policies, see the [IAM - documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). - - **JSON example:** - - { "bindings": [ { "role": - "roles/resourcemanager.organizationAdmin", "members": - [ "user:mike@example.com", - "group:admins@example.com", "domain:google.com", - "serviceAccount:my-project-id@appspot.gserviceaccount.com" - ] }, { "role": - "roles/resourcemanager.organizationViewer", - "members": [ "user:eve@example.com" ], "condition": { - "title": "expirable access", "description": "Does not - grant access after Sep 2020", "expression": - "request.time < - timestamp('2020-10-01T00:00:00.000Z')", } } ], - "etag": "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - - bindings: - members: - user:\ mike@example.com - - group:\ admins@example.com - domain:google.com - - serviceAccount:\ my-project-id@appspot.gserviceaccount.com - role: roles/resourcemanager.organizationAdmin - - members: - user:\ eve@example.com role: - roles/resourcemanager.organizationViewer condition: - title: expirable access description: Does not grant - access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the - [IAM - documentation](\ https://cloud.google.com/iam/docs/). + specifies access controls for Google Cloud resources. A + Policy is a collection of bindings. A binding binds one + or more members to a single role. Members can be user + accounts, service accounts, Google groups, and domains + (such as G Suite). A role is a named list of + permissions; each role can be an IAM predefined role or + a user-created custom role. For some types of Google + Cloud resources, a binding can also specify a condition, + which is a logical expression that allows access to a + resource only if the expression evaluates to true. A + condition can add constraints based on attributes of the + request, the resource, or both. To learn which resources + support conditions in their IAM policies, see the [IAM + documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:\ mike@example.com - + group:\ admins@example.com - domain:google.com - + serviceAccount:\ my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:\ eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the [IAM + documentation](\ https://cloud.google.com/iam/docs/). """ # Create or coerce a protobuf request object. @@ -761,31 +740,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -952,31 +921,21 @@ def resize( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1073,56 +1032,44 @@ def set_iam_policy( Returns: google.cloud.compute_v1.types.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A Policy is a collection of bindings. A binding binds - one or more members to a single role. Members can be - user accounts, service accounts, Google groups, and - domains (such as G Suite). A role is a named list of - permissions; each role can be an IAM predefined role - or a user-created custom role. - - For some types of Google Cloud resources, a binding - can also specify a condition, which is a logical - expression that allows access to a resource only if - the expression evaluates to true. A condition can add - constraints based on attributes of the request, the - resource, or both. To learn which resources support - conditions in their IAM policies, see the [IAM - documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). - - **JSON example:** - - { "bindings": [ { "role": - "roles/resourcemanager.organizationAdmin", "members": - [ "user:mike@example.com", - "group:admins@example.com", "domain:google.com", - "serviceAccount:my-project-id@appspot.gserviceaccount.com" - ] }, { "role": - "roles/resourcemanager.organizationViewer", - "members": [ "user:eve@example.com" ], "condition": { - "title": "expirable access", "description": "Does not - grant access after Sep 2020", "expression": - "request.time < - timestamp('2020-10-01T00:00:00.000Z')", } } ], - "etag": "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - - bindings: - members: - user:\ mike@example.com - - group:\ admins@example.com - domain:google.com - - serviceAccount:\ my-project-id@appspot.gserviceaccount.com - role: roles/resourcemanager.organizationAdmin - - members: - user:\ eve@example.com role: - roles/resourcemanager.organizationViewer condition: - title: expirable access description: Does not grant - access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the - [IAM - documentation](\ https://cloud.google.com/iam/docs/). + specifies access controls for Google Cloud resources. A + Policy is a collection of bindings. A binding binds one + or more members to a single role. Members can be user + accounts, service accounts, Google groups, and domains + (such as G Suite). A role is a named list of + permissions; each role can be an IAM predefined role or + a user-created custom role. For some types of Google + Cloud resources, a binding can also specify a condition, + which is a logical expression that allows access to a + resource only if the expression evaluates to true. A + condition can add constraints based on attributes of the + request, the resource, or both. To learn which resources + support conditions in their IAM policies, see the [IAM + documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:\ mike@example.com - + group:\ admins@example.com - domain:google.com - + serviceAccount:\ my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:\ eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the [IAM + documentation](\ https://cloud.google.com/iam/docs/). """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/reservations/transports/rest.py b/google/cloud/compute_v1/services/reservations/transports/rest.py index 2da132494..9cc7790bd 100644 --- a/google/cloud/compute_v1/services/reservations/transports/rest.py +++ b/google/cloud/compute_v1/services/reservations/transports/rest.py @@ -176,34 +176,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -254,11 +241,12 @@ def get( Returns: ~.compute.Reservation: - Represents a reservation resource. A reservation ensures - that capacity is held in a specific zone even if the - reserved VMs are not running. For more information, read - Reserving zonal resources. (== resource_for - {$api_version}.reservations ==) + Represents a reservation resource. A + reservation ensures that capacity is + held in a specific zone even if the + reserved VMs are not running. For more + information, read Reserving zonal + resources. """ @@ -310,28 +298,22 @@ def get_iam_policy( Returns: ~.compute.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A ``Policy`` is a collection of ``bindings``. A + specifies access controls for Google Cloud resources. A + ``Policy`` is a collection of ``bindings``. A ``binding`` binds one or more ``members`` to a single ``role``. Members can be user accounts, service accounts, Google groups, and domains (such as G Suite). A ``role`` is a named list of permissions; each ``role`` can be an IAM predefined role or a user-created custom - role. - - For some types of Google Cloud resources, a ``binding`` - can also specify a ``condition``, which is a logical - expression that allows access to a resource only if the - expression evaluates to ``true``. A condition can add - constraints based on attributes of the request, the + role. For some types of Google Cloud resources, a + ``binding`` can also specify a ``condition``, which is a + logical expression that allows access to a resource only + if the expression evaluates to ``true``. A condition can + add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the `IAM documentation `__. - - **JSON example:** - - { "bindings": [ { "role": + **JSON example:** { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", @@ -342,10 +324,7 @@ def get_iam_policy( "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": - "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - + "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com @@ -354,10 +333,9 @@ def get_iam_policy( roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the `IAM + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the `IAM documentation `__. """ @@ -414,34 +392,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -555,34 +520,21 @@ def resize( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -643,28 +595,22 @@ def set_iam_policy( Returns: ~.compute.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A ``Policy`` is a collection of ``bindings``. A + specifies access controls for Google Cloud resources. A + ``Policy`` is a collection of ``bindings``. A ``binding`` binds one or more ``members`` to a single ``role``. Members can be user accounts, service accounts, Google groups, and domains (such as G Suite). A ``role`` is a named list of permissions; each ``role`` can be an IAM predefined role or a user-created custom - role. - - For some types of Google Cloud resources, a ``binding`` - can also specify a ``condition``, which is a logical - expression that allows access to a resource only if the - expression evaluates to ``true``. A condition can add - constraints based on attributes of the request, the + role. For some types of Google Cloud resources, a + ``binding`` can also specify a ``condition``, which is a + logical expression that allows access to a resource only + if the expression evaluates to ``true``. A condition can + add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the `IAM documentation `__. - - **JSON example:** - - { "bindings": [ { "role": + **JSON example:** { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", @@ -675,10 +621,7 @@ def set_iam_policy( "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": - "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - + "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com @@ -687,10 +630,9 @@ def set_iam_policy( roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the `IAM + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the `IAM documentation `__. """ diff --git a/google/cloud/compute_v1/services/resource_policies/client.py b/google/cloud/compute_v1/services/resource_policies/client.py index cf85ecb27..a21ede291 100644 --- a/google/cloud/compute_v1/services/resource_policies/client.py +++ b/google/cloud/compute_v1/services/resource_policies/client.py @@ -443,31 +443,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -549,12 +539,12 @@ def get( Returns: google.cloud.compute_v1.types.ResourcePolicy: - Represents a Resource Policy resource. You can use - resource policies to schedule actions for some Compute - Engine resources. For example, you can use them to - schedule persistent disk snapshots. - - (== resource_for {$api_version}.resourcePolicies ==) + Represents a Resource Policy + resource. You can use resource policies + to schedule actions for some Compute + Engine resources. For example, you can + use them to schedule persistent disk + snapshots. """ # Create or coerce a protobuf request object. @@ -639,56 +629,44 @@ def get_iam_policy( Returns: google.cloud.compute_v1.types.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A Policy is a collection of bindings. A binding binds - one or more members to a single role. Members can be - user accounts, service accounts, Google groups, and - domains (such as G Suite). A role is a named list of - permissions; each role can be an IAM predefined role - or a user-created custom role. - - For some types of Google Cloud resources, a binding - can also specify a condition, which is a logical - expression that allows access to a resource only if - the expression evaluates to true. A condition can add - constraints based on attributes of the request, the - resource, or both. To learn which resources support - conditions in their IAM policies, see the [IAM - documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). - - **JSON example:** - - { "bindings": [ { "role": - "roles/resourcemanager.organizationAdmin", "members": - [ "user:mike@example.com", - "group:admins@example.com", "domain:google.com", - "serviceAccount:my-project-id@appspot.gserviceaccount.com" - ] }, { "role": - "roles/resourcemanager.organizationViewer", - "members": [ "user:eve@example.com" ], "condition": { - "title": "expirable access", "description": "Does not - grant access after Sep 2020", "expression": - "request.time < - timestamp('2020-10-01T00:00:00.000Z')", } } ], - "etag": "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - - bindings: - members: - user:\ mike@example.com - - group:\ admins@example.com - domain:google.com - - serviceAccount:\ my-project-id@appspot.gserviceaccount.com - role: roles/resourcemanager.organizationAdmin - - members: - user:\ eve@example.com role: - roles/resourcemanager.organizationViewer condition: - title: expirable access description: Does not grant - access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the - [IAM - documentation](\ https://cloud.google.com/iam/docs/). + specifies access controls for Google Cloud resources. A + Policy is a collection of bindings. A binding binds one + or more members to a single role. Members can be user + accounts, service accounts, Google groups, and domains + (such as G Suite). A role is a named list of + permissions; each role can be an IAM predefined role or + a user-created custom role. For some types of Google + Cloud resources, a binding can also specify a condition, + which is a logical expression that allows access to a + resource only if the expression evaluates to true. A + condition can add constraints based on attributes of the + request, the resource, or both. To learn which resources + support conditions in their IAM policies, see the [IAM + documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:\ mike@example.com - + group:\ admins@example.com - domain:google.com - + serviceAccount:\ my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:\ eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the [IAM + documentation](\ https://cloud.google.com/iam/docs/). """ # Create or coerce a protobuf request object. @@ -767,31 +745,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -963,56 +931,44 @@ def set_iam_policy( Returns: google.cloud.compute_v1.types.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A Policy is a collection of bindings. A binding binds - one or more members to a single role. Members can be - user accounts, service accounts, Google groups, and - domains (such as G Suite). A role is a named list of - permissions; each role can be an IAM predefined role - or a user-created custom role. - - For some types of Google Cloud resources, a binding - can also specify a condition, which is a logical - expression that allows access to a resource only if - the expression evaluates to true. A condition can add - constraints based on attributes of the request, the - resource, or both. To learn which resources support - conditions in their IAM policies, see the [IAM - documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). - - **JSON example:** - - { "bindings": [ { "role": - "roles/resourcemanager.organizationAdmin", "members": - [ "user:mike@example.com", - "group:admins@example.com", "domain:google.com", - "serviceAccount:my-project-id@appspot.gserviceaccount.com" - ] }, { "role": - "roles/resourcemanager.organizationViewer", - "members": [ "user:eve@example.com" ], "condition": { - "title": "expirable access", "description": "Does not - grant access after Sep 2020", "expression": - "request.time < - timestamp('2020-10-01T00:00:00.000Z')", } } ], - "etag": "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - - bindings: - members: - user:\ mike@example.com - - group:\ admins@example.com - domain:google.com - - serviceAccount:\ my-project-id@appspot.gserviceaccount.com - role: roles/resourcemanager.organizationAdmin - - members: - user:\ eve@example.com role: - roles/resourcemanager.organizationViewer condition: - title: expirable access description: Does not grant - access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the - [IAM - documentation](\ https://cloud.google.com/iam/docs/). + specifies access controls for Google Cloud resources. A + Policy is a collection of bindings. A binding binds one + or more members to a single role. Members can be user + accounts, service accounts, Google groups, and domains + (such as G Suite). A role is a named list of + permissions; each role can be an IAM predefined role or + a user-created custom role. For some types of Google + Cloud resources, a binding can also specify a condition, + which is a logical expression that allows access to a + resource only if the expression evaluates to true. A + condition can add constraints based on attributes of the + request, the resource, or both. To learn which resources + support conditions in their IAM policies, see the [IAM + documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:\ mike@example.com - + group:\ admins@example.com - domain:google.com - + serviceAccount:\ my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:\ eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the [IAM + documentation](\ https://cloud.google.com/iam/docs/). """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/resource_policies/transports/rest.py b/google/cloud/compute_v1/services/resource_policies/transports/rest.py index 70ddd8d50..afa2fd668 100644 --- a/google/cloud/compute_v1/services/resource_policies/transports/rest.py +++ b/google/cloud/compute_v1/services/resource_policies/transports/rest.py @@ -179,34 +179,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -257,12 +244,12 @@ def get( Returns: ~.compute.ResourcePolicy: - Represents a Resource Policy resource. You can use - resource policies to schedule actions for some Compute - Engine resources. For example, you can use them to - schedule persistent disk snapshots. - - (== resource_for {$api_version}.resourcePolicies ==) + Represents a Resource Policy + resource. You can use resource policies + to schedule actions for some Compute + Engine resources. For example, you can + use them to schedule persistent disk + snapshots. """ @@ -314,28 +301,22 @@ def get_iam_policy( Returns: ~.compute.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A ``Policy`` is a collection of ``bindings``. A + specifies access controls for Google Cloud resources. A + ``Policy`` is a collection of ``bindings``. A ``binding`` binds one or more ``members`` to a single ``role``. Members can be user accounts, service accounts, Google groups, and domains (such as G Suite). A ``role`` is a named list of permissions; each ``role`` can be an IAM predefined role or a user-created custom - role. - - For some types of Google Cloud resources, a ``binding`` - can also specify a ``condition``, which is a logical - expression that allows access to a resource only if the - expression evaluates to ``true``. A condition can add - constraints based on attributes of the request, the + role. For some types of Google Cloud resources, a + ``binding`` can also specify a ``condition``, which is a + logical expression that allows access to a resource only + if the expression evaluates to ``true``. A condition can + add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the `IAM documentation `__. - - **JSON example:** - - { "bindings": [ { "role": + **JSON example:** { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", @@ -346,10 +327,7 @@ def get_iam_policy( "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": - "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - + "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com @@ -358,10 +336,9 @@ def get_iam_policy( roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the `IAM + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the `IAM documentation `__. """ @@ -418,34 +395,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -560,28 +524,22 @@ def set_iam_policy( Returns: ~.compute.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A ``Policy`` is a collection of ``bindings``. A + specifies access controls for Google Cloud resources. A + ``Policy`` is a collection of ``bindings``. A ``binding`` binds one or more ``members`` to a single ``role``. Members can be user accounts, service accounts, Google groups, and domains (such as G Suite). A ``role`` is a named list of permissions; each ``role`` can be an IAM predefined role or a user-created custom - role. - - For some types of Google Cloud resources, a ``binding`` - can also specify a ``condition``, which is a logical - expression that allows access to a resource only if the - expression evaluates to ``true``. A condition can add - constraints based on attributes of the request, the + role. For some types of Google Cloud resources, a + ``binding`` can also specify a ``condition``, which is a + logical expression that allows access to a resource only + if the expression evaluates to ``true``. A condition can + add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the `IAM documentation `__. - - **JSON example:** - - { "bindings": [ { "role": + **JSON example:** { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", @@ -592,10 +550,7 @@ def set_iam_policy( "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": - "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - + "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com @@ -604,10 +559,9 @@ def set_iam_policy( roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the `IAM + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the `IAM documentation `__. """ diff --git a/google/cloud/compute_v1/services/routers/client.py b/google/cloud/compute_v1/services/routers/client.py index 90536eb71..d1f5bd449 100644 --- a/google/cloud/compute_v1/services/routers/client.py +++ b/google/cloud/compute_v1/services/routers/client.py @@ -440,31 +440,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -798,31 +788,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -989,31 +969,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1193,31 +1163,21 @@ def update( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/routers/transports/rest.py b/google/cloud/compute_v1/services/routers/transports/rest.py index c99d8d566..5eddeeaa7 100644 --- a/google/cloud/compute_v1/services/routers/transports/rest.py +++ b/google/cloud/compute_v1/services/routers/transports/rest.py @@ -175,34 +175,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -414,34 +401,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -553,34 +527,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -698,34 +659,21 @@ def update( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/routes/client.py b/google/cloud/compute_v1/services/routes/client.py index 15a059f51..0913ad774 100644 --- a/google/cloud/compute_v1/services/routes/client.py +++ b/google/cloud/compute_v1/services/routes/client.py @@ -360,31 +360,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -455,13 +445,12 @@ def get( Returns: google.cloud.compute_v1.types.Route: - Represents a Route resource. - - A route defines a path from VM instances in the VPC - network to a specific destination. This destination - can be inside or outside the VPC network. For more - information, read the Routes overview. (== - resource_for {$api_version}.routes ==) + Represents a Route resource. A route + defines a path from VM instances in the + VPC network to a specific destination. + This destination can be inside or + outside the VPC network. For more + information, read the Routes overview. """ # Create or coerce a protobuf request object. @@ -532,31 +521,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/routes/transports/rest.py b/google/cloud/compute_v1/services/routes/transports/rest.py index 5cab754e7..6e61a3d99 100644 --- a/google/cloud/compute_v1/services/routes/transports/rest.py +++ b/google/cloud/compute_v1/services/routes/transports/rest.py @@ -116,34 +116,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -190,13 +177,12 @@ def get( Returns: ~.compute.Route: - Represents a Route resource. - - A route defines a path from VM instances in the VPC - network to a specific destination. This destination can - be inside or outside the VPC network. For more - information, read the Routes overview. (== resource_for - {$api_version}.routes ==) + Represents a Route resource. A route + defines a path from VM instances in the + VPC network to a specific destination. + This destination can be inside or + outside the VPC network. For more + information, read the Routes overview. """ @@ -241,34 +227,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/security_policies/client.py b/google/cloud/compute_v1/services/security_policies/client.py index 9440c793a..ea91016ef 100644 --- a/google/cloud/compute_v1/services/security_policies/client.py +++ b/google/cloud/compute_v1/services/security_policies/client.py @@ -371,31 +371,21 @@ def add_rule( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -472,31 +462,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -568,14 +548,12 @@ def get( Returns: google.cloud.compute_v1.types.SecurityPolicy: - Represents a Google Cloud Armor security policy - resource. - - Only external backend services that use load - balancers can reference a security policy. For more - information, see Google Cloud Armor security policy - overview. (== resource_for - {$api_version}.securityPolicies ==) + Represents a Google Cloud Armor + security policy resource. Only external + backend services that use load balancers + can reference a security policy. For + more information, see Google Cloud Armor + security policy overview. """ # Create or coerce a protobuf request object. @@ -723,31 +701,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -970,31 +938,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1075,31 +1033,21 @@ def patch_rule( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1176,31 +1124,21 @@ def remove_rule( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/security_policies/transports/rest.py b/google/cloud/compute_v1/services/security_policies/transports/rest.py index a760203ad..801aa8084 100644 --- a/google/cloud/compute_v1/services/security_policies/transports/rest.py +++ b/google/cloud/compute_v1/services/security_policies/transports/rest.py @@ -117,34 +117,21 @@ def add_rule( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -201,34 +188,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -278,13 +252,12 @@ def get( Returns: ~.compute.SecurityPolicy: - Represents a Google Cloud Armor security policy - resource. - - Only external backend services that use load balancers - can reference a security policy. For more information, - see Google Cloud Armor security policy overview. (== - resource_for {$api_version}.securityPolicies ==) + Represents a Google Cloud Armor + security policy resource. Only external + backend services that use load balancers + can reference a security policy. For + more information, see Google Cloud Armor + security policy overview. """ @@ -389,34 +362,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -603,34 +563,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -689,34 +636,21 @@ def patch_rule( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -775,34 +709,21 @@ def remove_rule( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/service_attachments/__init__.py b/google/cloud/compute_v1/services/service_attachments/__init__.py new file mode 100644 index 000000000..6426373ab --- /dev/null +++ b/google/cloud/compute_v1/services/service_attachments/__init__.py @@ -0,0 +1,18 @@ +# -*- coding: utf-8 -*- +# Copyright 2020 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +from .client import ServiceAttachmentsClient + +__all__ = ("ServiceAttachmentsClient",) diff --git a/google/cloud/compute_v1/services/service_attachments/client.py b/google/cloud/compute_v1/services/service_attachments/client.py new file mode 100644 index 000000000..30cf389f9 --- /dev/null +++ b/google/cloud/compute_v1/services/service_attachments/client.py @@ -0,0 +1,1243 @@ +# -*- coding: utf-8 -*- +# Copyright 2020 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +from collections import OrderedDict +from distutils import util +import os +import re +from typing import Callable, Dict, Optional, Sequence, Tuple, Type, Union +import pkg_resources + +from google.api_core import client_options as client_options_lib # type: ignore +from google.api_core import exceptions as core_exceptions # type: ignore +from google.api_core import gapic_v1 # type: ignore +from google.api_core import retry as retries # type: ignore +from google.auth import credentials as ga_credentials # type: ignore +from google.auth.transport import mtls # type: ignore +from google.auth.transport.grpc import SslCredentials # type: ignore +from google.auth.exceptions import MutualTLSChannelError # type: ignore +from google.oauth2 import service_account # type: ignore + +from google.cloud.compute_v1.services.service_attachments import pagers +from google.cloud.compute_v1.types import compute +from .transports.base import ServiceAttachmentsTransport, DEFAULT_CLIENT_INFO +from .transports.rest import ServiceAttachmentsRestTransport + + +class ServiceAttachmentsClientMeta(type): + """Metaclass for the ServiceAttachments client. + + This provides class-level methods for building and retrieving + support objects (e.g. transport) without polluting the client instance + objects. + """ + + _transport_registry = ( + OrderedDict() + ) # type: Dict[str, Type[ServiceAttachmentsTransport]] + _transport_registry["rest"] = ServiceAttachmentsRestTransport + + def get_transport_class( + cls, label: str = None, + ) -> Type[ServiceAttachmentsTransport]: + """Returns an appropriate transport class. + + Args: + label: The name of the desired transport. If none is + provided, then the first transport in the registry is used. + + Returns: + The transport class to use. + """ + # If a specific transport is requested, return that one. + if label: + return cls._transport_registry[label] + + # No transport is requested; return the default (that is, the first one + # in the dictionary). + return next(iter(cls._transport_registry.values())) + + +class ServiceAttachmentsClient(metaclass=ServiceAttachmentsClientMeta): + """The ServiceAttachments API.""" + + @staticmethod + def _get_default_mtls_endpoint(api_endpoint): + """Converts api endpoint to mTLS endpoint. + + Convert "*.sandbox.googleapis.com" and "*.googleapis.com" to + "*.mtls.sandbox.googleapis.com" and "*.mtls.googleapis.com" respectively. + Args: + api_endpoint (Optional[str]): the api endpoint to convert. + Returns: + str: converted mTLS api endpoint. + """ + if not api_endpoint: + return api_endpoint + + mtls_endpoint_re = re.compile( + r"(?P[^.]+)(?P\.mtls)?(?P\.sandbox)?(?P\.googleapis\.com)?" + ) + + m = mtls_endpoint_re.match(api_endpoint) + name, mtls, sandbox, googledomain = m.groups() + if mtls or not googledomain: + return api_endpoint + + if sandbox: + return api_endpoint.replace( + "sandbox.googleapis.com", "mtls.sandbox.googleapis.com" + ) + + return api_endpoint.replace(".googleapis.com", ".mtls.googleapis.com") + + DEFAULT_ENDPOINT = "compute.googleapis.com" + DEFAULT_MTLS_ENDPOINT = _get_default_mtls_endpoint.__func__( # type: ignore + DEFAULT_ENDPOINT + ) + + @classmethod + def from_service_account_info(cls, info: dict, *args, **kwargs): + """Creates an instance of this client using the provided credentials + info. + + Args: + info (dict): The service account private key info. + args: Additional arguments to pass to the constructor. + kwargs: Additional arguments to pass to the constructor. + + Returns: + ServiceAttachmentsClient: The constructed client. + """ + credentials = service_account.Credentials.from_service_account_info(info) + kwargs["credentials"] = credentials + return cls(*args, **kwargs) + + @classmethod + def from_service_account_file(cls, filename: str, *args, **kwargs): + """Creates an instance of this client using the provided credentials + file. + + Args: + filename (str): The path to the service account private key json + file. + args: Additional arguments to pass to the constructor. + kwargs: Additional arguments to pass to the constructor. + + Returns: + ServiceAttachmentsClient: The constructed client. + """ + credentials = service_account.Credentials.from_service_account_file(filename) + kwargs["credentials"] = credentials + return cls(*args, **kwargs) + + from_service_account_json = from_service_account_file + + @property + def transport(self) -> ServiceAttachmentsTransport: + """Returns the transport used by the client instance. + + Returns: + ServiceAttachmentsTransport: The transport used by the client + instance. + """ + return self._transport + + @staticmethod + def common_billing_account_path(billing_account: str,) -> str: + """Returns a fully-qualified billing_account string.""" + return "billingAccounts/{billing_account}".format( + billing_account=billing_account, + ) + + @staticmethod + def parse_common_billing_account_path(path: str) -> Dict[str, str]: + """Parse a billing_account path into its component segments.""" + m = re.match(r"^billingAccounts/(?P.+?)$", path) + return m.groupdict() if m else {} + + @staticmethod + def common_folder_path(folder: str,) -> str: + """Returns a fully-qualified folder string.""" + return "folders/{folder}".format(folder=folder,) + + @staticmethod + def parse_common_folder_path(path: str) -> Dict[str, str]: + """Parse a folder path into its component segments.""" + m = re.match(r"^folders/(?P.+?)$", path) + return m.groupdict() if m else {} + + @staticmethod + def common_organization_path(organization: str,) -> str: + """Returns a fully-qualified organization string.""" + return "organizations/{organization}".format(organization=organization,) + + @staticmethod + def parse_common_organization_path(path: str) -> Dict[str, str]: + """Parse a organization path into its component segments.""" + m = re.match(r"^organizations/(?P.+?)$", path) + return m.groupdict() if m else {} + + @staticmethod + def common_project_path(project: str,) -> str: + """Returns a fully-qualified project string.""" + return "projects/{project}".format(project=project,) + + @staticmethod + def parse_common_project_path(path: str) -> Dict[str, str]: + """Parse a project path into its component segments.""" + m = re.match(r"^projects/(?P.+?)$", path) + return m.groupdict() if m else {} + + @staticmethod + def common_location_path(project: str, location: str,) -> str: + """Returns a fully-qualified location string.""" + return "projects/{project}/locations/{location}".format( + project=project, location=location, + ) + + @staticmethod + def parse_common_location_path(path: str) -> Dict[str, str]: + """Parse a location path into its component segments.""" + m = re.match(r"^projects/(?P.+?)/locations/(?P.+?)$", path) + return m.groupdict() if m else {} + + def __init__( + self, + *, + credentials: Optional[ga_credentials.Credentials] = None, + transport: Union[str, ServiceAttachmentsTransport, None] = None, + client_options: Optional[client_options_lib.ClientOptions] = None, + client_info: gapic_v1.client_info.ClientInfo = DEFAULT_CLIENT_INFO, + ) -> None: + """Instantiates the service attachments client. + + Args: + credentials (Optional[google.auth.credentials.Credentials]): The + authorization credentials to attach to requests. These + credentials identify the application to the service; if none + are specified, the client will attempt to ascertain the + credentials from the environment. + transport (Union[str, ServiceAttachmentsTransport]): The + transport to use. If set to None, a transport is chosen + automatically. + client_options (google.api_core.client_options.ClientOptions): Custom options for the + client. It won't take effect if a ``transport`` instance is provided. + (1) The ``api_endpoint`` property can be used to override the + default endpoint provided by the client. GOOGLE_API_USE_MTLS_ENDPOINT + environment variable can also be used to override the endpoint: + "always" (always use the default mTLS endpoint), "never" (always + use the default regular endpoint) and "auto" (auto switch to the + default mTLS endpoint if client certificate is present, this is + the default value). However, the ``api_endpoint`` property takes + precedence if provided. + (2) If GOOGLE_API_USE_CLIENT_CERTIFICATE environment variable + is "true", then the ``client_cert_source`` property can be used + to provide client certificate for mutual TLS transport. If + not provided, the default SSL client certificate will be used if + present. If GOOGLE_API_USE_CLIENT_CERTIFICATE is "false" or not + set, no client certificate will be used. + client_info (google.api_core.gapic_v1.client_info.ClientInfo): + The client info used to send a user-agent string along with + API requests. If ``None``, then default info will be used. + Generally, you only need to set this if you're developing + your own client library. + + Raises: + google.auth.exceptions.MutualTLSChannelError: If mutual TLS transport + creation failed for any reason. + """ + if isinstance(client_options, dict): + client_options = client_options_lib.from_dict(client_options) + if client_options is None: + client_options = client_options_lib.ClientOptions() + + # Create SSL credentials for mutual TLS if needed. + use_client_cert = bool( + util.strtobool(os.getenv("GOOGLE_API_USE_CLIENT_CERTIFICATE", "false")) + ) + + client_cert_source_func = None + is_mtls = False + if use_client_cert: + if client_options.client_cert_source: + is_mtls = True + client_cert_source_func = client_options.client_cert_source + else: + is_mtls = mtls.has_default_client_cert_source() + if is_mtls: + client_cert_source_func = mtls.default_client_cert_source() + else: + client_cert_source_func = None + + # Figure out which api endpoint to use. + if client_options.api_endpoint is not None: + api_endpoint = client_options.api_endpoint + else: + use_mtls_env = os.getenv("GOOGLE_API_USE_MTLS_ENDPOINT", "auto") + if use_mtls_env == "never": + api_endpoint = self.DEFAULT_ENDPOINT + elif use_mtls_env == "always": + api_endpoint = self.DEFAULT_MTLS_ENDPOINT + elif use_mtls_env == "auto": + if is_mtls: + api_endpoint = self.DEFAULT_MTLS_ENDPOINT + else: + api_endpoint = self.DEFAULT_ENDPOINT + else: + raise MutualTLSChannelError( + "Unsupported GOOGLE_API_USE_MTLS_ENDPOINT value. Accepted " + "values: never, auto, always" + ) + + # Save or instantiate the transport. + # Ordinarily, we provide the transport, but allowing a custom transport + # instance provides an extensibility point for unusual situations. + if isinstance(transport, ServiceAttachmentsTransport): + # transport is a ServiceAttachmentsTransport instance. + if credentials or client_options.credentials_file: + raise ValueError( + "When providing a transport instance, " + "provide its credentials directly." + ) + if client_options.scopes: + raise ValueError( + "When providing a transport instance, provide its scopes " + "directly." + ) + self._transport = transport + else: + Transport = type(self).get_transport_class(transport) + self._transport = Transport( + credentials=credentials, + credentials_file=client_options.credentials_file, + host=api_endpoint, + scopes=client_options.scopes, + client_cert_source_for_mtls=client_cert_source_func, + quota_project_id=client_options.quota_project_id, + client_info=client_info, + ) + + def aggregated_list( + self, + request: compute.AggregatedListServiceAttachmentsRequest = None, + *, + project: str = None, + retry: retries.Retry = gapic_v1.method.DEFAULT, + timeout: float = None, + metadata: Sequence[Tuple[str, str]] = (), + ) -> pagers.AggregatedListPager: + r"""Retrieves the list of all ServiceAttachment + resources, regional and global, available to the + specified project. + + Args: + request (google.cloud.compute_v1.types.AggregatedListServiceAttachmentsRequest): + The request object. A request message for + ServiceAttachments.AggregatedList. See the method + description for details. + project (str): + Name of the project scoping this + request. + + This corresponds to the ``project`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + google.cloud.compute_v1.services.service_attachments.pagers.AggregatedListPager: + Contains a list of + ServiceAttachmentsScopedList. + Iterating over this object will yield + results and resolve additional pages + automatically. + + """ + # Create or coerce a protobuf request object. + # Sanity check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any([project]) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + # Minor optimization to avoid making a copy if the user passes + # in a compute.AggregatedListServiceAttachmentsRequest. + # There's no risk of modifying the input as we've already verified + # there are no flattened fields. + if not isinstance(request, compute.AggregatedListServiceAttachmentsRequest): + request = compute.AggregatedListServiceAttachmentsRequest(request) + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if project is not None: + request.project = project + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = self._transport._wrapped_methods[self._transport.aggregated_list] + + # Send the request. + response = rpc(request, retry=retry, timeout=timeout, metadata=metadata,) + + # This method is paged; wrap the response in a pager, which provides + # an `__iter__` convenience method. + response = pagers.AggregatedListPager( + method=rpc, request=request, response=response, metadata=metadata, + ) + + # Done; return the response. + return response + + def delete( + self, + request: compute.DeleteServiceAttachmentRequest = None, + *, + project: str = None, + region: str = None, + service_attachment: str = None, + retry: retries.Retry = gapic_v1.method.DEFAULT, + timeout: float = None, + metadata: Sequence[Tuple[str, str]] = (), + ) -> compute.Operation: + r"""Deletes the specified ServiceAttachment in the given + scope + + Args: + request (google.cloud.compute_v1.types.DeleteServiceAttachmentRequest): + The request object. A request message for + ServiceAttachments.Delete. See the method description + for details. + project (str): + Project ID for this request. + This corresponds to the ``project`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + region (str): + Name of the region of this request. + This corresponds to the ``region`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + service_attachment (str): + Name of the ServiceAttachment + resource to delete. + + This corresponds to the ``service_attachment`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + google.cloud.compute_v1.types.Operation: + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. + + """ + # Create or coerce a protobuf request object. + # Sanity check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any([project, region, service_attachment]) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + # Minor optimization to avoid making a copy if the user passes + # in a compute.DeleteServiceAttachmentRequest. + # There's no risk of modifying the input as we've already verified + # there are no flattened fields. + if not isinstance(request, compute.DeleteServiceAttachmentRequest): + request = compute.DeleteServiceAttachmentRequest(request) + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if project is not None: + request.project = project + if region is not None: + request.region = region + if service_attachment is not None: + request.service_attachment = service_attachment + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = self._transport._wrapped_methods[self._transport.delete] + + # Send the request. + response = rpc(request, retry=retry, timeout=timeout, metadata=metadata,) + + # Done; return the response. + return response + + def get( + self, + request: compute.GetServiceAttachmentRequest = None, + *, + project: str = None, + region: str = None, + service_attachment: str = None, + retry: retries.Retry = gapic_v1.method.DEFAULT, + timeout: float = None, + metadata: Sequence[Tuple[str, str]] = (), + ) -> compute.ServiceAttachment: + r"""Returns the specified ServiceAttachment resource in + the given scope. + + Args: + request (google.cloud.compute_v1.types.GetServiceAttachmentRequest): + The request object. A request message for + ServiceAttachments.Get. See the method description for + details. + project (str): + Project ID for this request. + This corresponds to the ``project`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + region (str): + Name of the region of this request. + This corresponds to the ``region`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + service_attachment (str): + Name of the ServiceAttachment + resource to return. + + This corresponds to the ``service_attachment`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + google.cloud.compute_v1.types.ServiceAttachment: + Represents a ServiceAttachment + resource. A service attachment + represents a service that a producer has + exposed. It encapsulates the load + balancer which fronts the service runs + and a list of NAT IP ranges that the + producers uses to represent the + consumers connecting to the service. + next tag = 20 + + """ + # Create or coerce a protobuf request object. + # Sanity check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any([project, region, service_attachment]) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + # Minor optimization to avoid making a copy if the user passes + # in a compute.GetServiceAttachmentRequest. + # There's no risk of modifying the input as we've already verified + # there are no flattened fields. + if not isinstance(request, compute.GetServiceAttachmentRequest): + request = compute.GetServiceAttachmentRequest(request) + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if project is not None: + request.project = project + if region is not None: + request.region = region + if service_attachment is not None: + request.service_attachment = service_attachment + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = self._transport._wrapped_methods[self._transport.get] + + # Send the request. + response = rpc(request, retry=retry, timeout=timeout, metadata=metadata,) + + # Done; return the response. + return response + + def get_iam_policy( + self, + request: compute.GetIamPolicyServiceAttachmentRequest = None, + *, + project: str = None, + region: str = None, + resource: str = None, + retry: retries.Retry = gapic_v1.method.DEFAULT, + timeout: float = None, + metadata: Sequence[Tuple[str, str]] = (), + ) -> compute.Policy: + r"""Gets the access control policy for a resource. May be + empty if no such policy or resource exists. + + Args: + request (google.cloud.compute_v1.types.GetIamPolicyServiceAttachmentRequest): + The request object. A request message for + ServiceAttachments.GetIamPolicy. See the method + description for details. + project (str): + Project ID for this request. + This corresponds to the ``project`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + region (str): + The name of the region for this + request. + + This corresponds to the ``region`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + resource (str): + Name or id of the resource for this + request. + + This corresponds to the ``resource`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + google.cloud.compute_v1.types.Policy: + An Identity and Access Management (IAM) policy, which + specifies access controls for Google Cloud resources. A + Policy is a collection of bindings. A binding binds one + or more members to a single role. Members can be user + accounts, service accounts, Google groups, and domains + (such as G Suite). A role is a named list of + permissions; each role can be an IAM predefined role or + a user-created custom role. For some types of Google + Cloud resources, a binding can also specify a condition, + which is a logical expression that allows access to a + resource only if the expression evaluates to true. A + condition can add constraints based on attributes of the + request, the resource, or both. To learn which resources + support conditions in their IAM policies, see the [IAM + documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:\ mike@example.com - + group:\ admins@example.com - domain:google.com - + serviceAccount:\ my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:\ eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the [IAM + documentation](\ https://cloud.google.com/iam/docs/). + + """ + # Create or coerce a protobuf request object. + # Sanity check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any([project, region, resource]) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + # Minor optimization to avoid making a copy if the user passes + # in a compute.GetIamPolicyServiceAttachmentRequest. + # There's no risk of modifying the input as we've already verified + # there are no flattened fields. + if not isinstance(request, compute.GetIamPolicyServiceAttachmentRequest): + request = compute.GetIamPolicyServiceAttachmentRequest(request) + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if project is not None: + request.project = project + if region is not None: + request.region = region + if resource is not None: + request.resource = resource + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = self._transport._wrapped_methods[self._transport.get_iam_policy] + + # Send the request. + response = rpc(request, retry=retry, timeout=timeout, metadata=metadata,) + + # Done; return the response. + return response + + def insert( + self, + request: compute.InsertServiceAttachmentRequest = None, + *, + project: str = None, + region: str = None, + service_attachment_resource: compute.ServiceAttachment = None, + retry: retries.Retry = gapic_v1.method.DEFAULT, + timeout: float = None, + metadata: Sequence[Tuple[str, str]] = (), + ) -> compute.Operation: + r"""Creates a ServiceAttachment in the specified project + in the given scope using the parameters that are + included in the request. + + Args: + request (google.cloud.compute_v1.types.InsertServiceAttachmentRequest): + The request object. A request message for + ServiceAttachments.Insert. See the method description + for details. + project (str): + Project ID for this request. + This corresponds to the ``project`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + region (str): + Name of the region of this request. + This corresponds to the ``region`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + service_attachment_resource (google.cloud.compute_v1.types.ServiceAttachment): + The body resource for this request + This corresponds to the ``service_attachment_resource`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + google.cloud.compute_v1.types.Operation: + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. + + """ + # Create or coerce a protobuf request object. + # Sanity check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any([project, region, service_attachment_resource]) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + # Minor optimization to avoid making a copy if the user passes + # in a compute.InsertServiceAttachmentRequest. + # There's no risk of modifying the input as we've already verified + # there are no flattened fields. + if not isinstance(request, compute.InsertServiceAttachmentRequest): + request = compute.InsertServiceAttachmentRequest(request) + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if project is not None: + request.project = project + if region is not None: + request.region = region + if service_attachment_resource is not None: + request.service_attachment_resource = service_attachment_resource + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = self._transport._wrapped_methods[self._transport.insert] + + # Send the request. + response = rpc(request, retry=retry, timeout=timeout, metadata=metadata,) + + # Done; return the response. + return response + + def list( + self, + request: compute.ListServiceAttachmentsRequest = None, + *, + project: str = None, + region: str = None, + retry: retries.Retry = gapic_v1.method.DEFAULT, + timeout: float = None, + metadata: Sequence[Tuple[str, str]] = (), + ) -> pagers.ListPager: + r"""Lists the ServiceAttachments for a project in the + given scope. + + Args: + request (google.cloud.compute_v1.types.ListServiceAttachmentsRequest): + The request object. A request message for + ServiceAttachments.List. See the method description for + details. + project (str): + Project ID for this request. + This corresponds to the ``project`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + region (str): + Name of the region of this request. + This corresponds to the ``region`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + google.cloud.compute_v1.services.service_attachments.pagers.ListPager: + Iterating over this object will yield + results and resolve additional pages + automatically. + + """ + # Create or coerce a protobuf request object. + # Sanity check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any([project, region]) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + # Minor optimization to avoid making a copy if the user passes + # in a compute.ListServiceAttachmentsRequest. + # There's no risk of modifying the input as we've already verified + # there are no flattened fields. + if not isinstance(request, compute.ListServiceAttachmentsRequest): + request = compute.ListServiceAttachmentsRequest(request) + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if project is not None: + request.project = project + if region is not None: + request.region = region + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = self._transport._wrapped_methods[self._transport.list] + + # Send the request. + response = rpc(request, retry=retry, timeout=timeout, metadata=metadata,) + + # This method is paged; wrap the response in a pager, which provides + # an `__iter__` convenience method. + response = pagers.ListPager( + method=rpc, request=request, response=response, metadata=metadata, + ) + + # Done; return the response. + return response + + def patch( + self, + request: compute.PatchServiceAttachmentRequest = None, + *, + project: str = None, + region: str = None, + service_attachment: str = None, + service_attachment_resource: compute.ServiceAttachment = None, + retry: retries.Retry = gapic_v1.method.DEFAULT, + timeout: float = None, + metadata: Sequence[Tuple[str, str]] = (), + ) -> compute.Operation: + r"""Patches the specified ServiceAttachment resource with + the data included in the request. This method supports + PATCH semantics and uses JSON merge patch format and + processing rules. + + Args: + request (google.cloud.compute_v1.types.PatchServiceAttachmentRequest): + The request object. A request message for + ServiceAttachments.Patch. See the method description for + details. + project (str): + Project ID for this request. + This corresponds to the ``project`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + region (str): + The region scoping this request and + should conform to RFC1035. + + This corresponds to the ``region`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + service_attachment (str): + The resource id of the + ServiceAttachment to patch. It should + conform to RFC1035 resource name or be a + string form on an unsigned long number. + + This corresponds to the ``service_attachment`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + service_attachment_resource (google.cloud.compute_v1.types.ServiceAttachment): + The body resource for this request + This corresponds to the ``service_attachment_resource`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + google.cloud.compute_v1.types.Operation: + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. + + """ + # Create or coerce a protobuf request object. + # Sanity check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any( + [project, region, service_attachment, service_attachment_resource] + ) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + # Minor optimization to avoid making a copy if the user passes + # in a compute.PatchServiceAttachmentRequest. + # There's no risk of modifying the input as we've already verified + # there are no flattened fields. + if not isinstance(request, compute.PatchServiceAttachmentRequest): + request = compute.PatchServiceAttachmentRequest(request) + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if project is not None: + request.project = project + if region is not None: + request.region = region + if service_attachment is not None: + request.service_attachment = service_attachment + if service_attachment_resource is not None: + request.service_attachment_resource = service_attachment_resource + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = self._transport._wrapped_methods[self._transport.patch] + + # Send the request. + response = rpc(request, retry=retry, timeout=timeout, metadata=metadata,) + + # Done; return the response. + return response + + def set_iam_policy( + self, + request: compute.SetIamPolicyServiceAttachmentRequest = None, + *, + project: str = None, + region: str = None, + resource: str = None, + region_set_policy_request_resource: compute.RegionSetPolicyRequest = None, + retry: retries.Retry = gapic_v1.method.DEFAULT, + timeout: float = None, + metadata: Sequence[Tuple[str, str]] = (), + ) -> compute.Policy: + r"""Sets the access control policy on the specified + resource. Replaces any existing policy. + + Args: + request (google.cloud.compute_v1.types.SetIamPolicyServiceAttachmentRequest): + The request object. A request message for + ServiceAttachments.SetIamPolicy. See the method + description for details. + project (str): + Project ID for this request. + This corresponds to the ``project`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + region (str): + The name of the region for this + request. + + This corresponds to the ``region`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + resource (str): + Name or id of the resource for this + request. + + This corresponds to the ``resource`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + region_set_policy_request_resource (google.cloud.compute_v1.types.RegionSetPolicyRequest): + The body resource for this request + This corresponds to the ``region_set_policy_request_resource`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + google.cloud.compute_v1.types.Policy: + An Identity and Access Management (IAM) policy, which + specifies access controls for Google Cloud resources. A + Policy is a collection of bindings. A binding binds one + or more members to a single role. Members can be user + accounts, service accounts, Google groups, and domains + (such as G Suite). A role is a named list of + permissions; each role can be an IAM predefined role or + a user-created custom role. For some types of Google + Cloud resources, a binding can also specify a condition, + which is a logical expression that allows access to a + resource only if the expression evaluates to true. A + condition can add constraints based on attributes of the + request, the resource, or both. To learn which resources + support conditions in their IAM policies, see the [IAM + documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:\ mike@example.com - + group:\ admins@example.com - domain:google.com - + serviceAccount:\ my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:\ eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the [IAM + documentation](\ https://cloud.google.com/iam/docs/). + + """ + # Create or coerce a protobuf request object. + # Sanity check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any( + [project, region, resource, region_set_policy_request_resource] + ) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + # Minor optimization to avoid making a copy if the user passes + # in a compute.SetIamPolicyServiceAttachmentRequest. + # There's no risk of modifying the input as we've already verified + # there are no flattened fields. + if not isinstance(request, compute.SetIamPolicyServiceAttachmentRequest): + request = compute.SetIamPolicyServiceAttachmentRequest(request) + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if project is not None: + request.project = project + if region is not None: + request.region = region + if resource is not None: + request.resource = resource + if region_set_policy_request_resource is not None: + request.region_set_policy_request_resource = ( + region_set_policy_request_resource + ) + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = self._transport._wrapped_methods[self._transport.set_iam_policy] + + # Send the request. + response = rpc(request, retry=retry, timeout=timeout, metadata=metadata,) + + # Done; return the response. + return response + + def test_iam_permissions( + self, + request: compute.TestIamPermissionsServiceAttachmentRequest = None, + *, + project: str = None, + region: str = None, + resource: str = None, + test_permissions_request_resource: compute.TestPermissionsRequest = None, + retry: retries.Retry = gapic_v1.method.DEFAULT, + timeout: float = None, + metadata: Sequence[Tuple[str, str]] = (), + ) -> compute.TestPermissionsResponse: + r"""Returns permissions that a caller has on the + specified resource. + + Args: + request (google.cloud.compute_v1.types.TestIamPermissionsServiceAttachmentRequest): + The request object. A request message for + ServiceAttachments.TestIamPermissions. See the method + description for details. + project (str): + Project ID for this request. + This corresponds to the ``project`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + region (str): + The name of the region for this + request. + + This corresponds to the ``region`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + resource (str): + Name or id of the resource for this + request. + + This corresponds to the ``resource`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): + The body resource for this request + This corresponds to the ``test_permissions_request_resource`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + google.cloud.compute_v1.types.TestPermissionsResponse: + + """ + # Create or coerce a protobuf request object. + # Sanity check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any( + [project, region, resource, test_permissions_request_resource] + ) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + # Minor optimization to avoid making a copy if the user passes + # in a compute.TestIamPermissionsServiceAttachmentRequest. + # There's no risk of modifying the input as we've already verified + # there are no flattened fields. + if not isinstance(request, compute.TestIamPermissionsServiceAttachmentRequest): + request = compute.TestIamPermissionsServiceAttachmentRequest(request) + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if project is not None: + request.project = project + if region is not None: + request.region = region + if resource is not None: + request.resource = resource + if test_permissions_request_resource is not None: + request.test_permissions_request_resource = ( + test_permissions_request_resource + ) + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = self._transport._wrapped_methods[self._transport.test_iam_permissions] + + # Send the request. + response = rpc(request, retry=retry, timeout=timeout, metadata=metadata,) + + # Done; return the response. + return response + + +try: + DEFAULT_CLIENT_INFO = gapic_v1.client_info.ClientInfo( + gapic_version=pkg_resources.get_distribution("google-cloud-compute",).version, + ) +except pkg_resources.DistributionNotFound: + DEFAULT_CLIENT_INFO = gapic_v1.client_info.ClientInfo() + + +__all__ = ("ServiceAttachmentsClient",) diff --git a/google/cloud/compute_v1/services/service_attachments/pagers.py b/google/cloud/compute_v1/services/service_attachments/pagers.py new file mode 100644 index 000000000..4b1fc4f22 --- /dev/null +++ b/google/cloud/compute_v1/services/service_attachments/pagers.py @@ -0,0 +1,154 @@ +# -*- coding: utf-8 -*- +# Copyright 2020 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +from typing import ( + Any, + AsyncIterable, + Awaitable, + Callable, + Iterable, + Sequence, + Tuple, + Optional, +) + +from google.cloud.compute_v1.types import compute + + +class AggregatedListPager: + """A pager for iterating through ``aggregated_list`` requests. + + This class thinly wraps an initial + :class:`google.cloud.compute_v1.types.ServiceAttachmentAggregatedList` object, and + provides an ``__iter__`` method to iterate through its + ``items`` field. + + If there are more pages, the ``__iter__`` method will make additional + ``AggregatedList`` requests and continue to iterate + through the ``items`` field on the + corresponding responses. + + All the usual :class:`google.cloud.compute_v1.types.ServiceAttachmentAggregatedList` + attributes are available on the pager. If multiple requests are made, only + the most recent response is retained, and thus used for attribute lookup. + """ + + def __init__( + self, + method: Callable[..., compute.ServiceAttachmentAggregatedList], + request: compute.AggregatedListServiceAttachmentsRequest, + response: compute.ServiceAttachmentAggregatedList, + *, + metadata: Sequence[Tuple[str, str]] = () + ): + """Instantiate the pager. + + Args: + method (Callable): The method that was originally called, and + which instantiated this pager. + request (google.cloud.compute_v1.types.AggregatedListServiceAttachmentsRequest): + The initial request object. + response (google.cloud.compute_v1.types.ServiceAttachmentAggregatedList): + The initial response object. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + """ + self._method = method + self._request = compute.AggregatedListServiceAttachmentsRequest(request) + self._response = response + self._metadata = metadata + + def __getattr__(self, name: str) -> Any: + return getattr(self._response, name) + + @property + def pages(self) -> Iterable[compute.ServiceAttachmentAggregatedList]: + yield self._response + while self._response.next_page_token: + self._request.page_token = self._response.next_page_token + self._response = self._method(self._request, metadata=self._metadata) + yield self._response + + def __iter__(self) -> Iterable[Tuple[str, compute.ServiceAttachmentsScopedList]]: + for page in self.pages: + yield from page.items.items() + + def get(self, key: str) -> Optional[compute.ServiceAttachmentsScopedList]: + return self._response.items.get(key) + + def __repr__(self) -> str: + return "{0}<{1!r}>".format(self.__class__.__name__, self._response) + + +class ListPager: + """A pager for iterating through ``list`` requests. + + This class thinly wraps an initial + :class:`google.cloud.compute_v1.types.ServiceAttachmentList` object, and + provides an ``__iter__`` method to iterate through its + ``items`` field. + + If there are more pages, the ``__iter__`` method will make additional + ``List`` requests and continue to iterate + through the ``items`` field on the + corresponding responses. + + All the usual :class:`google.cloud.compute_v1.types.ServiceAttachmentList` + attributes are available on the pager. If multiple requests are made, only + the most recent response is retained, and thus used for attribute lookup. + """ + + def __init__( + self, + method: Callable[..., compute.ServiceAttachmentList], + request: compute.ListServiceAttachmentsRequest, + response: compute.ServiceAttachmentList, + *, + metadata: Sequence[Tuple[str, str]] = () + ): + """Instantiate the pager. + + Args: + method (Callable): The method that was originally called, and + which instantiated this pager. + request (google.cloud.compute_v1.types.ListServiceAttachmentsRequest): + The initial request object. + response (google.cloud.compute_v1.types.ServiceAttachmentList): + The initial response object. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + """ + self._method = method + self._request = compute.ListServiceAttachmentsRequest(request) + self._response = response + self._metadata = metadata + + def __getattr__(self, name: str) -> Any: + return getattr(self._response, name) + + @property + def pages(self) -> Iterable[compute.ServiceAttachmentList]: + yield self._response + while self._response.next_page_token: + self._request.page_token = self._response.next_page_token + self._response = self._method(self._request, metadata=self._metadata) + yield self._response + + def __iter__(self) -> Iterable[compute.ServiceAttachment]: + for page in self.pages: + yield from page.items + + def __repr__(self) -> str: + return "{0}<{1!r}>".format(self.__class__.__name__, self._response) diff --git a/google/cloud/compute_v1/services/service_attachments/transports/__init__.py b/google/cloud/compute_v1/services/service_attachments/transports/__init__.py new file mode 100644 index 000000000..bc43782ae --- /dev/null +++ b/google/cloud/compute_v1/services/service_attachments/transports/__init__.py @@ -0,0 +1,32 @@ +# -*- coding: utf-8 -*- +# Copyright 2020 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +from collections import OrderedDict +from typing import Dict, Type + +from .base import ServiceAttachmentsTransport +from .rest import ServiceAttachmentsRestTransport + + +# Compile a registry of transports. +_transport_registry = ( + OrderedDict() +) # type: Dict[str, Type[ServiceAttachmentsTransport]] +_transport_registry["rest"] = ServiceAttachmentsRestTransport + +__all__ = ( + "ServiceAttachmentsTransport", + "ServiceAttachmentsRestTransport", +) diff --git a/google/cloud/compute_v1/services/service_attachments/transports/base.py b/google/cloud/compute_v1/services/service_attachments/transports/base.py new file mode 100644 index 000000000..609ecbbbf --- /dev/null +++ b/google/cloud/compute_v1/services/service_attachments/transports/base.py @@ -0,0 +1,279 @@ +# -*- coding: utf-8 -*- +# Copyright 2020 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +import abc +from typing import Awaitable, Callable, Dict, Optional, Sequence, Union +import packaging.version +import pkg_resources +from requests import __version__ as requests_version + +import google.auth # type: ignore +import google.api_core # type: ignore +from google.api_core import exceptions as core_exceptions # type: ignore +from google.api_core import gapic_v1 # type: ignore +from google.api_core import retry as retries # type: ignore +from google.auth import credentials as ga_credentials # type: ignore +from google.oauth2 import service_account # type: ignore + +from google.cloud.compute_v1.types import compute + +try: + DEFAULT_CLIENT_INFO = gapic_v1.client_info.ClientInfo( + gapic_version=pkg_resources.get_distribution("google-cloud-compute",).version, + grpc_version=None, + rest_version=requests_version, + ) +except pkg_resources.DistributionNotFound: + DEFAULT_CLIENT_INFO = gapic_v1.client_info.ClientInfo() + +try: + # google.auth.__version__ was added in 1.26.0 + _GOOGLE_AUTH_VERSION = google.auth.__version__ +except AttributeError: + try: # try pkg_resources if it is available + _GOOGLE_AUTH_VERSION = pkg_resources.get_distribution("google-auth").version + except pkg_resources.DistributionNotFound: # pragma: NO COVER + _GOOGLE_AUTH_VERSION = None + + +class ServiceAttachmentsTransport(abc.ABC): + """Abstract transport class for ServiceAttachments.""" + + AUTH_SCOPES = ( + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/cloud-platform", + ) + + DEFAULT_HOST: str = "compute.googleapis.com" + + def __init__( + self, + *, + host: str = DEFAULT_HOST, + credentials: ga_credentials.Credentials = None, + credentials_file: Optional[str] = None, + scopes: Optional[Sequence[str]] = None, + quota_project_id: Optional[str] = None, + client_info: gapic_v1.client_info.ClientInfo = DEFAULT_CLIENT_INFO, + always_use_jwt_access: Optional[bool] = False, + **kwargs, + ) -> None: + """Instantiate the transport. + + Args: + host (Optional[str]): + The hostname to connect to. + credentials (Optional[google.auth.credentials.Credentials]): The + authorization credentials to attach to requests. These + credentials identify the application to the service; if none + are specified, the client will attempt to ascertain the + credentials from the environment. + credentials_file (Optional[str]): A file with credentials that can + be loaded with :func:`google.auth.load_credentials_from_file`. + This argument is mutually exclusive with credentials. + scopes (Optional[Sequence[str]]): A list of scopes. + quota_project_id (Optional[str]): An optional project to use for billing + and quota. + client_info (google.api_core.gapic_v1.client_info.ClientInfo): + The client info used to send a user-agent string along with + API requests. If ``None``, then default info will be used. + Generally, you only need to set this if you're developing + your own client library. + always_use_jwt_access (Optional[bool]): Whether self signed JWT should + be used for service account credentials. + """ + # Save the hostname. Default to port 443 (HTTPS) if none is specified. + if ":" not in host: + host += ":443" + self._host = host + + scopes_kwargs = self._get_scopes_kwargs(self._host, scopes) + + # Save the scopes. + self._scopes = scopes + + # If no credentials are provided, then determine the appropriate + # defaults. + if credentials and credentials_file: + raise core_exceptions.DuplicateCredentialArgs( + "'credentials_file' and 'credentials' are mutually exclusive" + ) + + if credentials_file is not None: + credentials, _ = google.auth.load_credentials_from_file( + credentials_file, **scopes_kwargs, quota_project_id=quota_project_id + ) + + elif credentials is None: + credentials, _ = google.auth.default( + **scopes_kwargs, quota_project_id=quota_project_id + ) + + # If the credentials is service account credentials, then always try to use self signed JWT. + if ( + always_use_jwt_access + and isinstance(credentials, service_account.Credentials) + and hasattr(service_account.Credentials, "with_always_use_jwt_access") + ): + credentials = credentials.with_always_use_jwt_access(True) + + # Save the credentials. + self._credentials = credentials + + # TODO(busunkim): This method is in the base transport + # to avoid duplicating code across the transport classes. These functions + # should be deleted once the minimum required versions of google-auth is increased. + + # TODO: Remove this function once google-auth >= 1.25.0 is required + @classmethod + def _get_scopes_kwargs( + cls, host: str, scopes: Optional[Sequence[str]] + ) -> Dict[str, Optional[Sequence[str]]]: + """Returns scopes kwargs to pass to google-auth methods depending on the google-auth version""" + + scopes_kwargs = {} + + if _GOOGLE_AUTH_VERSION and ( + packaging.version.parse(_GOOGLE_AUTH_VERSION) + >= packaging.version.parse("1.25.0") + ): + scopes_kwargs = {"scopes": scopes, "default_scopes": cls.AUTH_SCOPES} + else: + scopes_kwargs = {"scopes": scopes or cls.AUTH_SCOPES} + + return scopes_kwargs + + def _prep_wrapped_messages(self, client_info): + # Precompute the wrapped methods. + self._wrapped_methods = { + self.aggregated_list: gapic_v1.method.wrap_method( + self.aggregated_list, default_timeout=None, client_info=client_info, + ), + self.delete: gapic_v1.method.wrap_method( + self.delete, default_timeout=None, client_info=client_info, + ), + self.get: gapic_v1.method.wrap_method( + self.get, default_timeout=None, client_info=client_info, + ), + self.get_iam_policy: gapic_v1.method.wrap_method( + self.get_iam_policy, default_timeout=None, client_info=client_info, + ), + self.insert: gapic_v1.method.wrap_method( + self.insert, default_timeout=None, client_info=client_info, + ), + self.list: gapic_v1.method.wrap_method( + self.list, default_timeout=None, client_info=client_info, + ), + self.patch: gapic_v1.method.wrap_method( + self.patch, default_timeout=None, client_info=client_info, + ), + self.set_iam_policy: gapic_v1.method.wrap_method( + self.set_iam_policy, default_timeout=None, client_info=client_info, + ), + self.test_iam_permissions: gapic_v1.method.wrap_method( + self.test_iam_permissions, + default_timeout=None, + client_info=client_info, + ), + } + + @property + def aggregated_list( + self, + ) -> Callable[ + [compute.AggregatedListServiceAttachmentsRequest], + Union[ + compute.ServiceAttachmentAggregatedList, + Awaitable[compute.ServiceAttachmentAggregatedList], + ], + ]: + raise NotImplementedError() + + @property + def delete( + self, + ) -> Callable[ + [compute.DeleteServiceAttachmentRequest], + Union[compute.Operation, Awaitable[compute.Operation]], + ]: + raise NotImplementedError() + + @property + def get( + self, + ) -> Callable[ + [compute.GetServiceAttachmentRequest], + Union[compute.ServiceAttachment, Awaitable[compute.ServiceAttachment]], + ]: + raise NotImplementedError() + + @property + def get_iam_policy( + self, + ) -> Callable[ + [compute.GetIamPolicyServiceAttachmentRequest], + Union[compute.Policy, Awaitable[compute.Policy]], + ]: + raise NotImplementedError() + + @property + def insert( + self, + ) -> Callable[ + [compute.InsertServiceAttachmentRequest], + Union[compute.Operation, Awaitable[compute.Operation]], + ]: + raise NotImplementedError() + + @property + def list( + self, + ) -> Callable[ + [compute.ListServiceAttachmentsRequest], + Union[compute.ServiceAttachmentList, Awaitable[compute.ServiceAttachmentList]], + ]: + raise NotImplementedError() + + @property + def patch( + self, + ) -> Callable[ + [compute.PatchServiceAttachmentRequest], + Union[compute.Operation, Awaitable[compute.Operation]], + ]: + raise NotImplementedError() + + @property + def set_iam_policy( + self, + ) -> Callable[ + [compute.SetIamPolicyServiceAttachmentRequest], + Union[compute.Policy, Awaitable[compute.Policy]], + ]: + raise NotImplementedError() + + @property + def test_iam_permissions( + self, + ) -> Callable[ + [compute.TestIamPermissionsServiceAttachmentRequest], + Union[ + compute.TestPermissionsResponse, Awaitable[compute.TestPermissionsResponse] + ], + ]: + raise NotImplementedError() + + +__all__ = ("ServiceAttachmentsTransport",) diff --git a/google/cloud/compute_v1/services/service_attachments/transports/rest.py b/google/cloud/compute_v1/services/service_attachments/transports/rest.py new file mode 100644 index 000000000..36a5e93a0 --- /dev/null +++ b/google/cloud/compute_v1/services/service_attachments/transports/rest.py @@ -0,0 +1,746 @@ +# -*- coding: utf-8 -*- +# Copyright 2020 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +import warnings +from typing import Callable, Dict, Optional, Sequence, Tuple + +from google.api_core import gapic_v1 # type: ignore +from google.api_core import exceptions as core_exceptions # type: ignore +from google.auth import credentials as ga_credentials # type: ignore +from google.auth.transport.grpc import SslCredentials # type: ignore + +import grpc # type: ignore + +from google.auth.transport.requests import AuthorizedSession + +from google.cloud.compute_v1.types import compute + +from .base import ServiceAttachmentsTransport, DEFAULT_CLIENT_INFO + + +class ServiceAttachmentsRestTransport(ServiceAttachmentsTransport): + """REST backend transport for ServiceAttachments. + + The ServiceAttachments API. + + This class defines the same methods as the primary client, so the + primary client can load the underlying transport implementation + and call it. + + It sends JSON representations of protocol buffers over HTTP/1.1 + """ + + def __init__( + self, + *, + host: str = "compute.googleapis.com", + credentials: ga_credentials.Credentials = None, + credentials_file: str = None, + scopes: Sequence[str] = None, + client_cert_source_for_mtls: Callable[[], Tuple[bytes, bytes]] = None, + quota_project_id: Optional[str] = None, + client_info: gapic_v1.client_info.ClientInfo = DEFAULT_CLIENT_INFO, + always_use_jwt_access: Optional[bool] = False, + ) -> None: + """Instantiate the transport. + + Args: + host (Optional[str]): + The hostname to connect to. + credentials (Optional[google.auth.credentials.Credentials]): The + authorization credentials to attach to requests. These + credentials identify the application to the service; if none + are specified, the client will attempt to ascertain the + credentials from the environment. + + credentials_file (Optional[str]): A file with credentials that can + be loaded with :func:`google.auth.load_credentials_from_file`. + This argument is ignored if ``channel`` is provided. + scopes (Optional(Sequence[str])): A list of scopes. This argument is + ignored if ``channel`` is provided. + client_cert_source_for_mtls (Callable[[], Tuple[bytes, bytes]]): Client + certificate to configure mutual TLS HTTP channel. It is ignored + if ``channel`` is provided. + quota_project_id (Optional[str]): An optional project to use for billing + and quota. + client_info (google.api_core.gapic_v1.client_info.ClientInfo): + The client info used to send a user-agent string along with + API requests. If ``None``, then default info will be used. + Generally, you only need to set this if you're developing + your own client library. + """ + # Run the base constructor + # TODO(yon-mg): resolve other ctor params i.e. scopes, quota, etc. + # TODO: When custom host (api_endpoint) is set, `scopes` must *also* be set on the + # credentials object + super().__init__( + host=host, + credentials=credentials, + client_info=client_info, + always_use_jwt_access=always_use_jwt_access, + ) + self._session = AuthorizedSession( + self._credentials, default_host=self.DEFAULT_HOST + ) + if client_cert_source_for_mtls: + self._session.configure_mtls_channel(client_cert_source_for_mtls) + self._prep_wrapped_messages(client_info) + + def aggregated_list( + self, + request: compute.AggregatedListServiceAttachmentsRequest, + *, + metadata: Sequence[Tuple[str, str]] = (), + ) -> compute.ServiceAttachmentAggregatedList: + r"""Call the aggregated list method over HTTP. + + Args: + request (~.compute.AggregatedListServiceAttachmentsRequest): + The request object. A request message for + ServiceAttachments.AggregatedList. See + the method description for details. + + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + ~.compute.ServiceAttachmentAggregatedList: + Contains a list of + ServiceAttachmentsScopedList. + + """ + + # TODO(yon-mg): need to handle grpc transcoding and parse url correctly + # current impl assumes basic case of grpc transcoding + url = "https://{host}/compute/v1/projects/{project}/aggregated/serviceAttachments".format( + host=self._host, project=request.project, + ) + + # TODO(yon-mg): handle nested fields corerctly rather than using only top level fields + # not required for GCE + query_params = {} + if compute.AggregatedListServiceAttachmentsRequest.filter in request: + query_params["filter"] = request.filter + if ( + compute.AggregatedListServiceAttachmentsRequest.include_all_scopes + in request + ): + query_params["includeAllScopes"] = request.include_all_scopes + if compute.AggregatedListServiceAttachmentsRequest.max_results in request: + query_params["maxResults"] = request.max_results + if compute.AggregatedListServiceAttachmentsRequest.order_by in request: + query_params["orderBy"] = request.order_by + if compute.AggregatedListServiceAttachmentsRequest.page_token in request: + query_params["pageToken"] = request.page_token + if ( + compute.AggregatedListServiceAttachmentsRequest.return_partial_success + in request + ): + query_params["returnPartialSuccess"] = request.return_partial_success + + # Send the request + headers = dict(metadata) + headers["Content-Type"] = "application/json" + response = self._session.get(url, headers=headers, params=query_params,) + + # In case of error, raise the appropriate core_exceptions.GoogleAPICallError exception + # subclass. + if response.status_code >= 400: + raise core_exceptions.from_http_response(response) + + # Return the response + return compute.ServiceAttachmentAggregatedList.from_json( + response.content, ignore_unknown_fields=True + ) + + def delete( + self, + request: compute.DeleteServiceAttachmentRequest, + *, + metadata: Sequence[Tuple[str, str]] = (), + ) -> compute.Operation: + r"""Call the delete method over HTTP. + + Args: + request (~.compute.DeleteServiceAttachmentRequest): + The request object. A request message for + ServiceAttachments.Delete. See the + method description for details. + + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + ~.compute.Operation: + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. + + """ + + # TODO(yon-mg): need to handle grpc transcoding and parse url correctly + # current impl assumes basic case of grpc transcoding + url = "https://{host}/compute/v1/projects/{project}/regions/{region}/serviceAttachments/{service_attachment}".format( + host=self._host, + project=request.project, + region=request.region, + service_attachment=request.service_attachment, + ) + + # TODO(yon-mg): handle nested fields corerctly rather than using only top level fields + # not required for GCE + query_params = {} + if compute.DeleteServiceAttachmentRequest.request_id in request: + query_params["requestId"] = request.request_id + + # Send the request + headers = dict(metadata) + headers["Content-Type"] = "application/json" + response = self._session.delete(url, headers=headers, params=query_params,) + + # In case of error, raise the appropriate core_exceptions.GoogleAPICallError exception + # subclass. + if response.status_code >= 400: + raise core_exceptions.from_http_response(response) + + # Return the response + return compute.Operation.from_json(response.content, ignore_unknown_fields=True) + + def get( + self, + request: compute.GetServiceAttachmentRequest, + *, + metadata: Sequence[Tuple[str, str]] = (), + ) -> compute.ServiceAttachment: + r"""Call the get method over HTTP. + + Args: + request (~.compute.GetServiceAttachmentRequest): + The request object. A request message for + ServiceAttachments.Get. See the method + description for details. + + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + ~.compute.ServiceAttachment: + Represents a ServiceAttachment + resource. A service attachment + represents a service that a producer has + exposed. It encapsulates the load + balancer which fronts the service runs + and a list of NAT IP ranges that the + producers uses to represent the + consumers connecting to the service. + next tag = 20 + + """ + + # TODO(yon-mg): need to handle grpc transcoding and parse url correctly + # current impl assumes basic case of grpc transcoding + url = "https://{host}/compute/v1/projects/{project}/regions/{region}/serviceAttachments/{service_attachment}".format( + host=self._host, + project=request.project, + region=request.region, + service_attachment=request.service_attachment, + ) + + # TODO(yon-mg): handle nested fields corerctly rather than using only top level fields + # not required for GCE + query_params = {} + + # Send the request + headers = dict(metadata) + headers["Content-Type"] = "application/json" + response = self._session.get(url, headers=headers, params=query_params,) + + # In case of error, raise the appropriate core_exceptions.GoogleAPICallError exception + # subclass. + if response.status_code >= 400: + raise core_exceptions.from_http_response(response) + + # Return the response + return compute.ServiceAttachment.from_json( + response.content, ignore_unknown_fields=True + ) + + def get_iam_policy( + self, + request: compute.GetIamPolicyServiceAttachmentRequest, + *, + metadata: Sequence[Tuple[str, str]] = (), + ) -> compute.Policy: + r"""Call the get iam policy method over HTTP. + + Args: + request (~.compute.GetIamPolicyServiceAttachmentRequest): + The request object. A request message for + ServiceAttachments.GetIamPolicy. See the + method description for details. + + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + ~.compute.Policy: + An Identity and Access Management (IAM) policy, which + specifies access controls for Google Cloud resources. A + ``Policy`` is a collection of ``bindings``. A + ``binding`` binds one or more ``members`` to a single + ``role``. Members can be user accounts, service + accounts, Google groups, and domains (such as G Suite). + A ``role`` is a named list of permissions; each ``role`` + can be an IAM predefined role or a user-created custom + role. For some types of Google Cloud resources, a + ``binding`` can also specify a ``condition``, which is a + logical expression that allows access to a resource only + if the expression evaluates to ``true``. A condition can + add constraints based on attributes of the request, the + resource, or both. To learn which resources support + conditions in their IAM policies, see the `IAM + documentation `__. + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:mike@example.com - + group:admins@example.com - domain:google.com - + serviceAccount:my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the `IAM + documentation `__. + + """ + + # TODO(yon-mg): need to handle grpc transcoding and parse url correctly + # current impl assumes basic case of grpc transcoding + url = "https://{host}/compute/v1/projects/{project}/regions/{region}/serviceAttachments/{resource}/getIamPolicy".format( + host=self._host, + project=request.project, + region=request.region, + resource=request.resource, + ) + + # TODO(yon-mg): handle nested fields corerctly rather than using only top level fields + # not required for GCE + query_params = {} + if ( + compute.GetIamPolicyServiceAttachmentRequest.options_requested_policy_version + in request + ): + query_params[ + "optionsRequestedPolicyVersion" + ] = request.options_requested_policy_version + + # Send the request + headers = dict(metadata) + headers["Content-Type"] = "application/json" + response = self._session.get(url, headers=headers, params=query_params,) + + # In case of error, raise the appropriate core_exceptions.GoogleAPICallError exception + # subclass. + if response.status_code >= 400: + raise core_exceptions.from_http_response(response) + + # Return the response + return compute.Policy.from_json(response.content, ignore_unknown_fields=True) + + def insert( + self, + request: compute.InsertServiceAttachmentRequest, + *, + metadata: Sequence[Tuple[str, str]] = (), + ) -> compute.Operation: + r"""Call the insert method over HTTP. + + Args: + request (~.compute.InsertServiceAttachmentRequest): + The request object. A request message for + ServiceAttachments.Insert. See the + method description for details. + + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + ~.compute.Operation: + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. + + """ + + # Jsonify the request body + body = compute.ServiceAttachment.to_json( + request.service_attachment_resource, + including_default_value_fields=False, + use_integers_for_enums=False, + ) + + # TODO(yon-mg): need to handle grpc transcoding and parse url correctly + # current impl assumes basic case of grpc transcoding + url = "https://{host}/compute/v1/projects/{project}/regions/{region}/serviceAttachments".format( + host=self._host, project=request.project, region=request.region, + ) + + # TODO(yon-mg): handle nested fields corerctly rather than using only top level fields + # not required for GCE + query_params = {} + if compute.InsertServiceAttachmentRequest.request_id in request: + query_params["requestId"] = request.request_id + + # Send the request + headers = dict(metadata) + headers["Content-Type"] = "application/json" + response = self._session.post( + url, headers=headers, params=query_params, data=body, + ) + + # In case of error, raise the appropriate core_exceptions.GoogleAPICallError exception + # subclass. + if response.status_code >= 400: + raise core_exceptions.from_http_response(response) + + # Return the response + return compute.Operation.from_json(response.content, ignore_unknown_fields=True) + + def list( + self, + request: compute.ListServiceAttachmentsRequest, + *, + metadata: Sequence[Tuple[str, str]] = (), + ) -> compute.ServiceAttachmentList: + r"""Call the list method over HTTP. + + Args: + request (~.compute.ListServiceAttachmentsRequest): + The request object. A request message for + ServiceAttachments.List. See the method + description for details. + + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + ~.compute.ServiceAttachmentList: + + """ + + # TODO(yon-mg): need to handle grpc transcoding and parse url correctly + # current impl assumes basic case of grpc transcoding + url = "https://{host}/compute/v1/projects/{project}/regions/{region}/serviceAttachments".format( + host=self._host, project=request.project, region=request.region, + ) + + # TODO(yon-mg): handle nested fields corerctly rather than using only top level fields + # not required for GCE + query_params = {} + if compute.ListServiceAttachmentsRequest.filter in request: + query_params["filter"] = request.filter + if compute.ListServiceAttachmentsRequest.max_results in request: + query_params["maxResults"] = request.max_results + if compute.ListServiceAttachmentsRequest.order_by in request: + query_params["orderBy"] = request.order_by + if compute.ListServiceAttachmentsRequest.page_token in request: + query_params["pageToken"] = request.page_token + if compute.ListServiceAttachmentsRequest.return_partial_success in request: + query_params["returnPartialSuccess"] = request.return_partial_success + + # Send the request + headers = dict(metadata) + headers["Content-Type"] = "application/json" + response = self._session.get(url, headers=headers, params=query_params,) + + # In case of error, raise the appropriate core_exceptions.GoogleAPICallError exception + # subclass. + if response.status_code >= 400: + raise core_exceptions.from_http_response(response) + + # Return the response + return compute.ServiceAttachmentList.from_json( + response.content, ignore_unknown_fields=True + ) + + def patch( + self, + request: compute.PatchServiceAttachmentRequest, + *, + metadata: Sequence[Tuple[str, str]] = (), + ) -> compute.Operation: + r"""Call the patch method over HTTP. + + Args: + request (~.compute.PatchServiceAttachmentRequest): + The request object. A request message for + ServiceAttachments.Patch. See the method + description for details. + + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + ~.compute.Operation: + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. + + """ + + # Jsonify the request body + body = compute.ServiceAttachment.to_json( + request.service_attachment_resource, + including_default_value_fields=False, + use_integers_for_enums=False, + ) + + # TODO(yon-mg): need to handle grpc transcoding and parse url correctly + # current impl assumes basic case of grpc transcoding + url = "https://{host}/compute/v1/projects/{project}/regions/{region}/serviceAttachments/{service_attachment}".format( + host=self._host, + project=request.project, + region=request.region, + service_attachment=request.service_attachment, + ) + + # TODO(yon-mg): handle nested fields corerctly rather than using only top level fields + # not required for GCE + query_params = {} + if compute.PatchServiceAttachmentRequest.request_id in request: + query_params["requestId"] = request.request_id + + # Send the request + headers = dict(metadata) + headers["Content-Type"] = "application/json" + response = self._session.patch( + url, headers=headers, params=query_params, data=body, + ) + + # In case of error, raise the appropriate core_exceptions.GoogleAPICallError exception + # subclass. + if response.status_code >= 400: + raise core_exceptions.from_http_response(response) + + # Return the response + return compute.Operation.from_json(response.content, ignore_unknown_fields=True) + + def set_iam_policy( + self, + request: compute.SetIamPolicyServiceAttachmentRequest, + *, + metadata: Sequence[Tuple[str, str]] = (), + ) -> compute.Policy: + r"""Call the set iam policy method over HTTP. + + Args: + request (~.compute.SetIamPolicyServiceAttachmentRequest): + The request object. A request message for + ServiceAttachments.SetIamPolicy. See the + method description for details. + + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + ~.compute.Policy: + An Identity and Access Management (IAM) policy, which + specifies access controls for Google Cloud resources. A + ``Policy`` is a collection of ``bindings``. A + ``binding`` binds one or more ``members`` to a single + ``role``. Members can be user accounts, service + accounts, Google groups, and domains (such as G Suite). + A ``role`` is a named list of permissions; each ``role`` + can be an IAM predefined role or a user-created custom + role. For some types of Google Cloud resources, a + ``binding`` can also specify a ``condition``, which is a + logical expression that allows access to a resource only + if the expression evaluates to ``true``. A condition can + add constraints based on attributes of the request, the + resource, or both. To learn which resources support + conditions in their IAM policies, see the `IAM + documentation `__. + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:mike@example.com - + group:admins@example.com - domain:google.com - + serviceAccount:my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the `IAM + documentation `__. + + """ + + # Jsonify the request body + body = compute.RegionSetPolicyRequest.to_json( + request.region_set_policy_request_resource, + including_default_value_fields=False, + use_integers_for_enums=False, + ) + + # TODO(yon-mg): need to handle grpc transcoding and parse url correctly + # current impl assumes basic case of grpc transcoding + url = "https://{host}/compute/v1/projects/{project}/regions/{region}/serviceAttachments/{resource}/setIamPolicy".format( + host=self._host, + project=request.project, + region=request.region, + resource=request.resource, + ) + + # TODO(yon-mg): handle nested fields corerctly rather than using only top level fields + # not required for GCE + query_params = {} + + # Send the request + headers = dict(metadata) + headers["Content-Type"] = "application/json" + response = self._session.post( + url, headers=headers, params=query_params, data=body, + ) + + # In case of error, raise the appropriate core_exceptions.GoogleAPICallError exception + # subclass. + if response.status_code >= 400: + raise core_exceptions.from_http_response(response) + + # Return the response + return compute.Policy.from_json(response.content, ignore_unknown_fields=True) + + def test_iam_permissions( + self, + request: compute.TestIamPermissionsServiceAttachmentRequest, + *, + metadata: Sequence[Tuple[str, str]] = (), + ) -> compute.TestPermissionsResponse: + r"""Call the test iam permissions method over HTTP. + + Args: + request (~.compute.TestIamPermissionsServiceAttachmentRequest): + The request object. A request message for + ServiceAttachments.TestIamPermissions. + See the method description for details. + + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + ~.compute.TestPermissionsResponse: + + """ + + # Jsonify the request body + body = compute.TestPermissionsRequest.to_json( + request.test_permissions_request_resource, + including_default_value_fields=False, + use_integers_for_enums=False, + ) + + # TODO(yon-mg): need to handle grpc transcoding and parse url correctly + # current impl assumes basic case of grpc transcoding + url = "https://{host}/compute/v1/projects/{project}/regions/{region}/serviceAttachments/{resource}/testIamPermissions".format( + host=self._host, + project=request.project, + region=request.region, + resource=request.resource, + ) + + # TODO(yon-mg): handle nested fields corerctly rather than using only top level fields + # not required for GCE + query_params = {} + + # Send the request + headers = dict(metadata) + headers["Content-Type"] = "application/json" + response = self._session.post( + url, headers=headers, params=query_params, data=body, + ) + + # In case of error, raise the appropriate core_exceptions.GoogleAPICallError exception + # subclass. + if response.status_code >= 400: + raise core_exceptions.from_http_response(response) + + # Return the response + return compute.TestPermissionsResponse.from_json( + response.content, ignore_unknown_fields=True + ) + + +__all__ = ("ServiceAttachmentsRestTransport",) diff --git a/google/cloud/compute_v1/services/snapshots/client.py b/google/cloud/compute_v1/services/snapshots/client.py index 50a39cbfa..ff9d998df 100644 --- a/google/cloud/compute_v1/services/snapshots/client.py +++ b/google/cloud/compute_v1/services/snapshots/client.py @@ -341,7 +341,7 @@ def delete( delete all the data on that snapshot. If any data on the snapshot that is marked for deletion is needed for subsequent snapshots, the data will be moved to the next - corresponding snapshot. For more information, see + corresponding snapshot. For more information, see Deleting snapshots. Args: @@ -369,31 +369,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -466,12 +456,11 @@ def get( Returns: google.cloud.compute_v1.types.Snapshot: - Represents a Persistent Disk Snapshot resource. - - You can use snapshots to back up data on a regular - interval. For more information, read Creating - persistent disk snapshots. (== resource_for - {$api_version}.snapshots ==) + Represents a Persistent Disk Snapshot + resource. You can use snapshots to back + up data on a regular interval. For more + information, read Creating persistent + disk snapshots. """ # Create or coerce a protobuf request object. @@ -546,56 +535,44 @@ def get_iam_policy( Returns: google.cloud.compute_v1.types.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A Policy is a collection of bindings. A binding binds - one or more members to a single role. Members can be - user accounts, service accounts, Google groups, and - domains (such as G Suite). A role is a named list of - permissions; each role can be an IAM predefined role - or a user-created custom role. - - For some types of Google Cloud resources, a binding - can also specify a condition, which is a logical - expression that allows access to a resource only if - the expression evaluates to true. A condition can add - constraints based on attributes of the request, the - resource, or both. To learn which resources support - conditions in their IAM policies, see the [IAM - documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). - - **JSON example:** - - { "bindings": [ { "role": - "roles/resourcemanager.organizationAdmin", "members": - [ "user:mike@example.com", - "group:admins@example.com", "domain:google.com", - "serviceAccount:my-project-id@appspot.gserviceaccount.com" - ] }, { "role": - "roles/resourcemanager.organizationViewer", - "members": [ "user:eve@example.com" ], "condition": { - "title": "expirable access", "description": "Does not - grant access after Sep 2020", "expression": - "request.time < - timestamp('2020-10-01T00:00:00.000Z')", } } ], - "etag": "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - - bindings: - members: - user:\ mike@example.com - - group:\ admins@example.com - domain:google.com - - serviceAccount:\ my-project-id@appspot.gserviceaccount.com - role: roles/resourcemanager.organizationAdmin - - members: - user:\ eve@example.com role: - roles/resourcemanager.organizationViewer condition: - title: expirable access description: Does not grant - access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the - [IAM - documentation](\ https://cloud.google.com/iam/docs/). + specifies access controls for Google Cloud resources. A + Policy is a collection of bindings. A binding binds one + or more members to a single role. Members can be user + accounts, service accounts, Google groups, and domains + (such as G Suite). A role is a named list of + permissions; each role can be an IAM predefined role or + a user-created custom role. For some types of Google + Cloud resources, a binding can also specify a condition, + which is a logical expression that allows access to a + resource only if the expression evaluates to true. A + condition can add constraints based on attributes of the + request, the resource, or both. To learn which resources + support conditions in their IAM policies, see the [IAM + documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:\ mike@example.com - + group:\ admins@example.com - domain:google.com - + serviceAccount:\ my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:\ eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the [IAM + documentation](\ https://cloud.google.com/iam/docs/). """ # Create or coerce a protobuf request object. @@ -749,56 +726,44 @@ def set_iam_policy( Returns: google.cloud.compute_v1.types.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A Policy is a collection of bindings. A binding binds - one or more members to a single role. Members can be - user accounts, service accounts, Google groups, and - domains (such as G Suite). A role is a named list of - permissions; each role can be an IAM predefined role - or a user-created custom role. - - For some types of Google Cloud resources, a binding - can also specify a condition, which is a logical - expression that allows access to a resource only if - the expression evaluates to true. A condition can add - constraints based on attributes of the request, the - resource, or both. To learn which resources support - conditions in their IAM policies, see the [IAM - documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). - - **JSON example:** - - { "bindings": [ { "role": - "roles/resourcemanager.organizationAdmin", "members": - [ "user:mike@example.com", - "group:admins@example.com", "domain:google.com", - "serviceAccount:my-project-id@appspot.gserviceaccount.com" - ] }, { "role": - "roles/resourcemanager.organizationViewer", - "members": [ "user:eve@example.com" ], "condition": { - "title": "expirable access", "description": "Does not - grant access after Sep 2020", "expression": - "request.time < - timestamp('2020-10-01T00:00:00.000Z')", } } ], - "etag": "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - - bindings: - members: - user:\ mike@example.com - - group:\ admins@example.com - domain:google.com - - serviceAccount:\ my-project-id@appspot.gserviceaccount.com - role: roles/resourcemanager.organizationAdmin - - members: - user:\ eve@example.com role: - roles/resourcemanager.organizationViewer condition: - title: expirable access description: Does not grant - access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the - [IAM - documentation](\ https://cloud.google.com/iam/docs/). + specifies access controls for Google Cloud resources. A + Policy is a collection of bindings. A binding binds one + or more members to a single role. Members can be user + accounts, service accounts, Google groups, and domains + (such as G Suite). A role is a named list of + permissions; each role can be an IAM predefined role or + a user-created custom role. For some types of Google + Cloud resources, a binding can also specify a condition, + which is a logical expression that allows access to a + resource only if the expression evaluates to true. A + condition can add constraints based on attributes of the + request, the resource, or both. To learn which resources + support conditions in their IAM policies, see the [IAM + documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:\ mike@example.com - + group:\ admins@example.com - domain:google.com - + serviceAccount:\ my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:\ eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the [IAM + documentation](\ https://cloud.google.com/iam/docs/). """ # Create or coerce a protobuf request object. @@ -884,31 +849,21 @@ def set_labels( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/snapshots/transports/rest.py b/google/cloud/compute_v1/services/snapshots/transports/rest.py index b31df569e..339e6f105 100644 --- a/google/cloud/compute_v1/services/snapshots/transports/rest.py +++ b/google/cloud/compute_v1/services/snapshots/transports/rest.py @@ -117,34 +117,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -191,12 +178,11 @@ def get( Returns: ~.compute.Snapshot: - Represents a Persistent Disk Snapshot resource. - - You can use snapshots to back up data on a regular - interval. For more information, read Creating persistent - disk snapshots. (== resource_for - {$api_version}.snapshots ==) + Represents a Persistent Disk Snapshot + resource. You can use snapshots to back + up data on a regular interval. For more + information, read Creating persistent + disk snapshots. """ @@ -243,28 +229,22 @@ def get_iam_policy( Returns: ~.compute.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A ``Policy`` is a collection of ``bindings``. A + specifies access controls for Google Cloud resources. A + ``Policy`` is a collection of ``bindings``. A ``binding`` binds one or more ``members`` to a single ``role``. Members can be user accounts, service accounts, Google groups, and domains (such as G Suite). A ``role`` is a named list of permissions; each ``role`` can be an IAM predefined role or a user-created custom - role. - - For some types of Google Cloud resources, a ``binding`` - can also specify a ``condition``, which is a logical - expression that allows access to a resource only if the - expression evaluates to ``true``. A condition can add - constraints based on attributes of the request, the + role. For some types of Google Cloud resources, a + ``binding`` can also specify a ``condition``, which is a + logical expression that allows access to a resource only + if the expression evaluates to ``true``. A condition can + add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the `IAM documentation `__. - - **JSON example:** - - { "bindings": [ { "role": + **JSON example:** { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", @@ -275,10 +255,7 @@ def get_iam_policy( "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": - "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - + "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com @@ -287,10 +264,9 @@ def get_iam_policy( roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the `IAM + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the `IAM documentation `__. """ @@ -403,28 +379,22 @@ def set_iam_policy( Returns: ~.compute.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A ``Policy`` is a collection of ``bindings``. A + specifies access controls for Google Cloud resources. A + ``Policy`` is a collection of ``bindings``. A ``binding`` binds one or more ``members`` to a single ``role``. Members can be user accounts, service accounts, Google groups, and domains (such as G Suite). A ``role`` is a named list of permissions; each ``role`` can be an IAM predefined role or a user-created custom - role. - - For some types of Google Cloud resources, a ``binding`` - can also specify a ``condition``, which is a logical - expression that allows access to a resource only if the - expression evaluates to ``true``. A condition can add - constraints based on attributes of the request, the + role. For some types of Google Cloud resources, a + ``binding`` can also specify a ``condition``, which is a + logical expression that allows access to a resource only + if the expression evaluates to ``true``. A condition can + add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the `IAM documentation `__. - - **JSON example:** - - { "bindings": [ { "role": + **JSON example:** { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", @@ -435,10 +405,7 @@ def set_iam_policy( "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": - "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - + "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com @@ -447,10 +414,9 @@ def set_iam_policy( roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the `IAM + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the `IAM documentation `__. """ @@ -506,34 +472,21 @@ def set_labels( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/ssl_certificates/client.py b/google/cloud/compute_v1/services/ssl_certificates/client.py index 0ca175066..05cb05c94 100644 --- a/google/cloud/compute_v1/services/ssl_certificates/client.py +++ b/google/cloud/compute_v1/services/ssl_certificates/client.py @@ -439,31 +439,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -538,31 +528,22 @@ def get( Returns: google.cloud.compute_v1.types.SslCertificate: - Represents an SSL Certificate resource. - - Google Compute Engine has two SSL Certificate - resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/sslCertificates) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionSslCertificates) - - The sslCertificates are used by: - external HTTPS - load balancers - SSL proxy load balancers - - The regionSslCertificates are used by internal HTTPS - load balancers. - - Optionally, certificate file contents that you upload - can contain a set of up to five PEM-encoded - certificates. The API call creates an object - (sslCertificate) that holds this data. You can use - SSL keys and certificates to secure connections to a - load balancer. For more information, read Creating - and using SSL certificates, SSL certificates quotas - and limits, and Troubleshooting SSL certificates. (== - resource_for {$api_version}.sslCertificates ==) (== - resource_for {$api_version}.regionSslCertificates ==) + Represents an SSL Certificate resource. Google Compute + Engine has two SSL Certificate resources: \* + [Global](/compute/docs/reference/rest/v1/sslCertificates) + \* + [Regional](/compute/docs/reference/rest/v1/regionSslCertificates) + The sslCertificates are used by: - external HTTPS load + balancers - SSL proxy load balancers The + regionSslCertificates are used by internal HTTPS load + balancers. Optionally, certificate file contents that + you upload can contain a set of up to five PEM-encoded + certificates. The API call creates an object + (sslCertificate) that holds this data. You can use SSL + keys and certificates to secure connections to a load + balancer. For more information, read Creating and using + SSL certificates, SSL certificates quotas and limits, + and Troubleshooting SSL certificates. """ # Create or coerce a protobuf request object. @@ -634,31 +615,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/ssl_certificates/transports/rest.py b/google/cloud/compute_v1/services/ssl_certificates/transports/rest.py index b97e2857f..8988cc244 100644 --- a/google/cloud/compute_v1/services/ssl_certificates/transports/rest.py +++ b/google/cloud/compute_v1/services/ssl_certificates/transports/rest.py @@ -179,34 +179,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -256,32 +243,22 @@ def get( Returns: ~.compute.SslCertificate: - Represents an SSL Certificate resource. - - Google Compute Engine has two SSL Certificate resources: - - - `Global `__ - \* - `Regional `__ - - The sslCertificates are used by: - - - external HTTPS load balancers - - SSL proxy load balancers - - The regionSslCertificates are used by internal HTTPS - load balancers. - - Optionally, certificate file contents that you upload - can contain a set of up to five PEM-encoded + Represents an SSL Certificate resource. Google Compute + Engine has two SSL Certificate resources: \* + `Global `__ + \* + `Regional `__ + The sslCertificates are used by: - external HTTPS load + balancers - SSL proxy load balancers The + regionSslCertificates are used by internal HTTPS load + balancers. Optionally, certificate file contents that + you upload can contain a set of up to five PEM-encoded certificates. The API call creates an object (sslCertificate) that holds this data. You can use SSL keys and certificates to secure connections to a load balancer. For more information, read Creating and using SSL certificates, SSL certificates quotas and limits, - and Troubleshooting SSL certificates. (== resource_for - {$api_version}.sslCertificates ==) (== resource_for - {$api_version}.regionSslCertificates ==) + and Troubleshooting SSL certificates. """ @@ -331,34 +308,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/ssl_policies/client.py b/google/cloud/compute_v1/services/ssl_policies/client.py index 420837eb8..05d3f174d 100644 --- a/google/cloud/compute_v1/services/ssl_policies/client.py +++ b/google/cloud/compute_v1/services/ssl_policies/client.py @@ -366,31 +366,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -465,12 +455,11 @@ def get( Returns: google.cloud.compute_v1.types.SslPolicy: Represents an SSL Policy resource. - - Use SSL policies to control the SSL features, such as - versions and cipher suites, offered by an HTTPS or - SSL Proxy load balancer. For more information, read - SSL Policy Concepts. (== resource_for - {$api_version}.sslPolicies ==) + Use SSL policies to control the SSL + features, such as versions and cipher + suites, offered by an HTTPS or SSL Proxy + load balancer. For more information, + read SSL Policy Concepts. """ # Create or coerce a protobuf request object. @@ -543,31 +532,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -783,31 +762,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/ssl_policies/transports/rest.py b/google/cloud/compute_v1/services/ssl_policies/transports/rest.py index 7d2a941e6..df57d208e 100644 --- a/google/cloud/compute_v1/services/ssl_policies/transports/rest.py +++ b/google/cloud/compute_v1/services/ssl_policies/transports/rest.py @@ -117,34 +117,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -193,12 +180,11 @@ def get( Returns: ~.compute.SslPolicy: Represents an SSL Policy resource. - - Use SSL policies to control the SSL features, such as - versions and cipher suites, offered by an HTTPS or SSL - Proxy load balancer. For more information, read SSL - Policy Concepts. (== resource_for - {$api_version}.sslPolicies ==) + Use SSL policies to control the SSL + features, such as versions and cipher + suites, offered by an HTTPS or SSL Proxy + load balancer. For more information, + read SSL Policy Concepts. """ @@ -244,34 +230,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -445,34 +418,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/subnetworks/client.py b/google/cloud/compute_v1/services/subnetworks/client.py index bffcb1a39..be2c05a13 100644 --- a/google/cloud/compute_v1/services/subnetworks/client.py +++ b/google/cloud/compute_v1/services/subnetworks/client.py @@ -442,31 +442,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -556,31 +546,21 @@ def expand_ip_cidr_range( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -674,14 +654,13 @@ def get( Returns: google.cloud.compute_v1.types.Subnetwork: - Represents a Subnetwork resource. - - A subnetwork (also known as a subnet) is a logical - partition of a Virtual Private Cloud network with one - primary IP range and zero or more secondary IP - ranges. For more information, read Virtual Private - Cloud (VPC) Network. (== resource_for - {$api_version}.subnetworks ==) + Represents a Subnetwork resource. A + subnetwork (also known as a subnet) is a + logical partition of a Virtual Private + Cloud network with one primary IP range + and zero or more secondary IP ranges. + For more information, read Virtual + Private Cloud (VPC) Network. """ # Create or coerce a protobuf request object. @@ -766,56 +745,44 @@ def get_iam_policy( Returns: google.cloud.compute_v1.types.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A Policy is a collection of bindings. A binding binds - one or more members to a single role. Members can be - user accounts, service accounts, Google groups, and - domains (such as G Suite). A role is a named list of - permissions; each role can be an IAM predefined role - or a user-created custom role. - - For some types of Google Cloud resources, a binding - can also specify a condition, which is a logical - expression that allows access to a resource only if - the expression evaluates to true. A condition can add - constraints based on attributes of the request, the - resource, or both. To learn which resources support - conditions in their IAM policies, see the [IAM - documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). - - **JSON example:** - - { "bindings": [ { "role": - "roles/resourcemanager.organizationAdmin", "members": - [ "user:mike@example.com", - "group:admins@example.com", "domain:google.com", - "serviceAccount:my-project-id@appspot.gserviceaccount.com" - ] }, { "role": - "roles/resourcemanager.organizationViewer", - "members": [ "user:eve@example.com" ], "condition": { - "title": "expirable access", "description": "Does not - grant access after Sep 2020", "expression": - "request.time < - timestamp('2020-10-01T00:00:00.000Z')", } } ], - "etag": "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - - bindings: - members: - user:\ mike@example.com - - group:\ admins@example.com - domain:google.com - - serviceAccount:\ my-project-id@appspot.gserviceaccount.com - role: roles/resourcemanager.organizationAdmin - - members: - user:\ eve@example.com role: - roles/resourcemanager.organizationViewer condition: - title: expirable access description: Does not grant - access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the - [IAM - documentation](\ https://cloud.google.com/iam/docs/). + specifies access controls for Google Cloud resources. A + Policy is a collection of bindings. A binding binds one + or more members to a single role. Members can be user + accounts, service accounts, Google groups, and domains + (such as G Suite). A role is a named list of + permissions; each role can be an IAM predefined role or + a user-created custom role. For some types of Google + Cloud resources, a binding can also specify a condition, + which is a logical expression that allows access to a + resource only if the expression evaluates to true. A + condition can add constraints based on attributes of the + request, the resource, or both. To learn which resources + support conditions in their IAM policies, see the [IAM + documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:\ mike@example.com - + group:\ admins@example.com - domain:google.com - + serviceAccount:\ my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:\ eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the [IAM + documentation](\ https://cloud.google.com/iam/docs/). """ # Create or coerce a protobuf request object. @@ -897,31 +864,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1170,31 +1127,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1287,56 +1234,44 @@ def set_iam_policy( Returns: google.cloud.compute_v1.types.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A Policy is a collection of bindings. A binding binds - one or more members to a single role. Members can be - user accounts, service accounts, Google groups, and - domains (such as G Suite). A role is a named list of - permissions; each role can be an IAM predefined role - or a user-created custom role. - - For some types of Google Cloud resources, a binding - can also specify a condition, which is a logical - expression that allows access to a resource only if - the expression evaluates to true. A condition can add - constraints based on attributes of the request, the - resource, or both. To learn which resources support - conditions in their IAM policies, see the [IAM - documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). - - **JSON example:** - - { "bindings": [ { "role": - "roles/resourcemanager.organizationAdmin", "members": - [ "user:mike@example.com", - "group:admins@example.com", "domain:google.com", - "serviceAccount:my-project-id@appspot.gserviceaccount.com" - ] }, { "role": - "roles/resourcemanager.organizationViewer", - "members": [ "user:eve@example.com" ], "condition": { - "title": "expirable access", "description": "Does not - grant access after Sep 2020", "expression": - "request.time < - timestamp('2020-10-01T00:00:00.000Z')", } } ], - "etag": "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - - bindings: - members: - user:\ mike@example.com - - group:\ admins@example.com - domain:google.com - - serviceAccount:\ my-project-id@appspot.gserviceaccount.com - role: roles/resourcemanager.organizationAdmin - - members: - user:\ eve@example.com role: - roles/resourcemanager.organizationViewer condition: - title: expirable access description: Does not grant - access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the - [IAM - documentation](\ https://cloud.google.com/iam/docs/). + specifies access controls for Google Cloud resources. A + Policy is a collection of bindings. A binding binds one + or more members to a single role. Members can be user + accounts, service accounts, Google groups, and domains + (such as G Suite). A role is a named list of + permissions; each role can be an IAM predefined role or + a user-created custom role. For some types of Google + Cloud resources, a binding can also specify a condition, + which is a logical expression that allows access to a + resource only if the expression evaluates to true. A + condition can add constraints based on attributes of the + request, the resource, or both. To learn which resources + support conditions in their IAM policies, see the [IAM + documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" + ] }, { "role": + "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": + "expirable access", "description": "Does not grant + access after Sep 2020", "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** + bindings: - members: - user:\ mike@example.com - + group:\ admins@example.com - domain:google.com - + serviceAccount:\ my-project-id@appspot.gserviceaccount.com + role: roles/resourcemanager.organizationAdmin - members: + - user:\ eve@example.com role: + roles/resourcemanager.organizationViewer condition: + title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the [IAM + documentation](\ https://cloud.google.com/iam/docs/). """ # Create or coerce a protobuf request object. @@ -1431,31 +1366,21 @@ def set_private_ip_google_access( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/subnetworks/transports/rest.py b/google/cloud/compute_v1/services/subnetworks/transports/rest.py index 937372058..45ee9eb24 100644 --- a/google/cloud/compute_v1/services/subnetworks/transports/rest.py +++ b/google/cloud/compute_v1/services/subnetworks/transports/rest.py @@ -176,34 +176,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -254,34 +241,21 @@ def expand_ip_cidr_range( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -341,13 +315,13 @@ def get( Returns: ~.compute.Subnetwork: - Represents a Subnetwork resource. - - A subnetwork (also known as a subnet) is a logical - partition of a Virtual Private Cloud network with one - primary IP range and zero or more secondary IP ranges. - For more information, read Virtual Private Cloud (VPC) - Network. (== resource_for {$api_version}.subnetworks ==) + Represents a Subnetwork resource. A + subnetwork (also known as a subnet) is a + logical partition of a Virtual Private + Cloud network with one primary IP range + and zero or more secondary IP ranges. + For more information, read Virtual + Private Cloud (VPC) Network. """ @@ -399,28 +373,22 @@ def get_iam_policy( Returns: ~.compute.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A ``Policy`` is a collection of ``bindings``. A + specifies access controls for Google Cloud resources. A + ``Policy`` is a collection of ``bindings``. A ``binding`` binds one or more ``members`` to a single ``role``. Members can be user accounts, service accounts, Google groups, and domains (such as G Suite). A ``role`` is a named list of permissions; each ``role`` can be an IAM predefined role or a user-created custom - role. - - For some types of Google Cloud resources, a ``binding`` - can also specify a ``condition``, which is a logical - expression that allows access to a resource only if the - expression evaluates to ``true``. A condition can add - constraints based on attributes of the request, the + role. For some types of Google Cloud resources, a + ``binding`` can also specify a ``condition``, which is a + logical expression that allows access to a resource only + if the expression evaluates to ``true``. A condition can + add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the `IAM documentation `__. - - **JSON example:** - - { "bindings": [ { "role": + **JSON example:** { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", @@ -431,10 +399,7 @@ def get_iam_policy( "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": - "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - + "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com @@ -443,10 +408,9 @@ def get_iam_policy( roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the `IAM + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the `IAM documentation `__. """ @@ -503,34 +467,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -703,34 +654,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -793,28 +731,22 @@ def set_iam_policy( Returns: ~.compute.Policy: An Identity and Access Management (IAM) policy, which - specifies access controls for Google Cloud resources. - - A ``Policy`` is a collection of ``bindings``. A + specifies access controls for Google Cloud resources. A + ``Policy`` is a collection of ``bindings``. A ``binding`` binds one or more ``members`` to a single ``role``. Members can be user accounts, service accounts, Google groups, and domains (such as G Suite). A ``role`` is a named list of permissions; each ``role`` can be an IAM predefined role or a user-created custom - role. - - For some types of Google Cloud resources, a ``binding`` - can also specify a ``condition``, which is a logical - expression that allows access to a resource only if the - expression evaluates to ``true``. A condition can add - constraints based on attributes of the request, the + role. For some types of Google Cloud resources, a + ``binding`` can also specify a ``condition``, which is a + logical expression that allows access to a resource only + if the expression evaluates to ``true``. A condition can + add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the `IAM documentation `__. - - **JSON example:** - - { "bindings": [ { "role": + **JSON example:** { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", @@ -825,10 +757,7 @@ def set_iam_policy( "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": - "BwWWja0YfJA=", "version": 3 } - - **YAML example:** - + "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com @@ -837,10 +766,9 @@ def set_iam_policy( roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: - BwWWja0YfJA= - version: 3 - - For a description of IAM and its features, see the `IAM + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= + version: 3 For a description of IAM and its features, + see the `IAM documentation `__. """ @@ -900,34 +828,21 @@ def set_private_ip_google_access( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/target_grpc_proxies/client.py b/google/cloud/compute_v1/services/target_grpc_proxies/client.py index be1039403..5e29f91b1 100644 --- a/google/cloud/compute_v1/services/target_grpc_proxies/client.py +++ b/google/cloud/compute_v1/services/target_grpc_proxies/client.py @@ -368,31 +368,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -466,16 +456,13 @@ def get( Returns: google.cloud.compute_v1.types.TargetGrpcProxy: - Represents a Target gRPC Proxy resource. - - A target gRPC proxy is a component of load balancers - intended for load balancing gRPC traffic. Only global - forwarding rules with load balancing scheme - INTERNAL_SELF_MANAGED can reference a target gRPC - proxy. The target gRPC Proxy references a URL map - that specifies how traffic is routed to gRPC backend - services. (== resource_for - {$api_version}.targetGrpcProxies ==) + Represents a Target gRPC Proxy resource. A target gRPC + proxy is a component of load balancers intended for load + balancing gRPC traffic. Only global forwarding rules + with load balancing scheme INTERNAL_SELF_MANAGED can + reference a target gRPC proxy. The target gRPC Proxy + references a URL map that specifies how traffic is + routed to gRPC backend services. """ # Create or coerce a protobuf request object. @@ -548,31 +535,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -726,31 +703,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/target_grpc_proxies/transports/rest.py b/google/cloud/compute_v1/services/target_grpc_proxies/transports/rest.py index a28d8cc55..a494ff4b1 100644 --- a/google/cloud/compute_v1/services/target_grpc_proxies/transports/rest.py +++ b/google/cloud/compute_v1/services/target_grpc_proxies/transports/rest.py @@ -117,34 +117,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -194,16 +181,13 @@ def get( Returns: ~.compute.TargetGrpcProxy: - Represents a Target gRPC Proxy resource. - - A target gRPC proxy is a component of load balancers - intended for load balancing gRPC traffic. Only global - forwarding rules with load balancing scheme - INTERNAL_SELF_MANAGED can reference a target gRPC proxy. - The target gRPC Proxy references a URL map that - specifies how traffic is routed to gRPC backend - services. (== resource_for - {$api_version}.targetGrpcProxies ==) + Represents a Target gRPC Proxy resource. A target gRPC + proxy is a component of load balancers intended for load + balancing gRPC traffic. Only global forwarding rules + with load balancing scheme INTERNAL_SELF_MANAGED can + reference a target gRPC proxy. The target gRPC Proxy + references a URL map that specifies how traffic is + routed to gRPC backend services. """ @@ -253,34 +237,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -394,34 +365,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/target_http_proxies/client.py b/google/cloud/compute_v1/services/target_http_proxies/client.py index 80c89743c..d2ac7cbf0 100644 --- a/google/cloud/compute_v1/services/target_http_proxies/client.py +++ b/google/cloud/compute_v1/services/target_http_proxies/client.py @@ -441,31 +441,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -540,29 +530,19 @@ def get( Returns: google.cloud.compute_v1.types.TargetHttpProxy: - Represents a Target HTTP Proxy resource. - - Google Compute Engine has two Target HTTP Proxy - resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/targetHttpProxies) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionTargetHttpProxies) - - A target HTTP proxy is a component of GCP HTTP load - balancers. - - - targetHttpProxies are used by external HTTP load - balancers and Traffic Director. \* - regionTargetHttpProxies are used by internal HTTP - load balancers. - - Forwarding rules reference a target HTTP proxy, and - the target proxy then references a URL map. For more - information, read Using Target Proxies and Forwarding - rule concepts. (== resource_for - {$api_version}.targetHttpProxies ==) (== resource_for - {$api_version}.regionTargetHttpProxies ==) + Represents a Target HTTP Proxy resource. Google Compute + Engine has two Target HTTP Proxy resources: \* + [Global](/compute/docs/reference/rest/v1/targetHttpProxies) + \* + [Regional](/compute/docs/reference/rest/v1/regionTargetHttpProxies) + A target HTTP proxy is a component of GCP HTTP load + balancers. \* targetHttpProxies are used by external + HTTP load balancers and Traffic Director. \* + regionTargetHttpProxies are used by internal HTTP load + balancers. Forwarding rules reference a target HTTP + proxy, and the target proxy then references a URL map. + For more information, read Using Target Proxies and + Forwarding rule concepts. """ # Create or coerce a protobuf request object. @@ -634,31 +614,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -778,10 +748,10 @@ def patch( timeout: float = None, metadata: Sequence[Tuple[str, str]] = (), ) -> compute.Operation: - r"""Patches the specified TargetHttpProxy resource with the data - included in the request. This method supports PATCH semantics - and uses JSON merge patch format and processing rules. (== - suppress_warning http-rest-shadowed ==) + r"""Patches the specified TargetHttpProxy resource with + the data included in the request. This method supports + PATCH semantics and uses JSON merge patch format and + processing rules. Args: request (google.cloud.compute_v1.types.PatchTargetHttpProxyRequest): @@ -813,31 +783,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -920,31 +880,21 @@ def set_url_map( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/target_http_proxies/transports/rest.py b/google/cloud/compute_v1/services/target_http_proxies/transports/rest.py index 3926b166a..5e6fb576f 100644 --- a/google/cloud/compute_v1/services/target_http_proxies/transports/rest.py +++ b/google/cloud/compute_v1/services/target_http_proxies/transports/rest.py @@ -179,34 +179,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -256,29 +243,19 @@ def get( Returns: ~.compute.TargetHttpProxy: - Represents a Target HTTP Proxy resource. - - Google Compute Engine has two Target HTTP Proxy - resources: - - - `Global `__ - \* - `Regional `__ - + Represents a Target HTTP Proxy resource. Google Compute + Engine has two Target HTTP Proxy resources: \* + `Global `__ + \* + `Regional `__ A target HTTP proxy is a component of GCP HTTP load - balancers. - - - targetHttpProxies are used by external HTTP load - balancers and Traffic Director. \* - regionTargetHttpProxies are used by internal HTTP - load balancers. - - Forwarding rules reference a target HTTP proxy, and the - target proxy then references a URL map. For more - information, read Using Target Proxies and Forwarding - rule concepts. (== resource_for - {$api_version}.targetHttpProxies ==) (== resource_for - {$api_version}.regionTargetHttpProxies ==) + balancers. \* targetHttpProxies are used by external + HTTP load balancers and Traffic Director. \* + regionTargetHttpProxies are used by internal HTTP load + balancers. Forwarding rules reference a target HTTP + proxy, and the target proxy then references a URL map. + For more information, read Using Target Proxies and + Forwarding rule concepts. """ @@ -328,34 +305,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -469,34 +433,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -555,34 +506,21 @@ def set_url_map( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/target_https_proxies/client.py b/google/cloud/compute_v1/services/target_https_proxies/client.py index 87ccb296a..1dedef100 100644 --- a/google/cloud/compute_v1/services/target_https_proxies/client.py +++ b/google/cloud/compute_v1/services/target_https_proxies/client.py @@ -441,31 +441,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -540,29 +530,18 @@ def get( Returns: google.cloud.compute_v1.types.TargetHttpsProxy: - Represents a Target HTTPS Proxy resource. - - Google Compute Engine has two Target HTTPS Proxy - resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/targetHttpsProxies) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionTargetHttpsProxies) - - A target HTTPS proxy is a component of GCP HTTPS load - balancers. - - - targetHttpsProxies are used by external HTTPS load - balancers. \* regionTargetHttpsProxies are used by - internal HTTPS load balancers. - - Forwarding rules reference a target HTTPS proxy, and - the target proxy then references a URL map. For more - information, read Using Target Proxies and Forwarding - rule concepts. (== resource_for - {$api_version}.targetHttpsProxies ==) (== - resource_for {$api_version}.regionTargetHttpsProxies - ==) + Represents a Target HTTPS Proxy resource. Google Compute + Engine has two Target HTTPS Proxy resources: \* + [Global](/compute/docs/reference/rest/v1/targetHttpsProxies) + \* + [Regional](/compute/docs/reference/rest/v1/regionTargetHttpsProxies) + A target HTTPS proxy is a component of GCP HTTPS load + balancers. \* targetHttpsProxies are used by external + HTTPS load balancers. \* regionTargetHttpsProxies are + used by internal HTTPS load balancers. Forwarding rules + reference a target HTTPS proxy, and the target proxy + then references a URL map. For more information, read + Using Target Proxies and Forwarding rule concepts. """ # Create or coerce a protobuf request object. @@ -634,31 +613,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -779,10 +748,10 @@ def patch( timeout: float = None, metadata: Sequence[Tuple[str, str]] = (), ) -> compute.Operation: - r"""Patches the specified TargetHttpsProxy resource with the data - included in the request. This method supports PATCH semantics - and uses JSON merge patch format and processing rules. (== - suppress_warning http-rest-shadowed ==) + r"""Patches the specified TargetHttpsProxy resource with + the data included in the request. This method supports + PATCH semantics and uses JSON merge patch format and + processing rules. Args: request (google.cloud.compute_v1.types.PatchTargetHttpsProxyRequest): @@ -814,31 +783,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -922,31 +881,21 @@ def set_quic_override( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1035,31 +984,21 @@ def set_ssl_certificates( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1154,31 +1093,21 @@ def set_ssl_policy( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1261,31 +1190,21 @@ def set_url_map( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/target_https_proxies/transports/rest.py b/google/cloud/compute_v1/services/target_https_proxies/transports/rest.py index d247a2884..145f84287 100644 --- a/google/cloud/compute_v1/services/target_https_proxies/transports/rest.py +++ b/google/cloud/compute_v1/services/target_https_proxies/transports/rest.py @@ -182,34 +182,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -259,28 +246,18 @@ def get( Returns: ~.compute.TargetHttpsProxy: - Represents a Target HTTPS Proxy resource. - - Google Compute Engine has two Target HTTPS Proxy - resources: - - - `Global `__ - \* - `Regional `__ - + Represents a Target HTTPS Proxy resource. Google Compute + Engine has two Target HTTPS Proxy resources: \* + `Global `__ + \* + `Regional `__ A target HTTPS proxy is a component of GCP HTTPS load - balancers. - - - targetHttpsProxies are used by external HTTPS load - balancers. \* regionTargetHttpsProxies are used by - internal HTTPS load balancers. - - Forwarding rules reference a target HTTPS proxy, and the - target proxy then references a URL map. For more - information, read Using Target Proxies and Forwarding - rule concepts. (== resource_for - {$api_version}.targetHttpsProxies ==) (== resource_for - {$api_version}.regionTargetHttpsProxies ==) + balancers. \* targetHttpsProxies are used by external + HTTPS load balancers. \* regionTargetHttpsProxies are + used by internal HTTPS load balancers. Forwarding rules + reference a target HTTPS proxy, and the target proxy + then references a URL map. For more information, read + Using Target Proxies and Forwarding rule concepts. """ @@ -330,34 +307,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -473,34 +437,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -559,34 +510,21 @@ def set_quic_override( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -645,34 +583,21 @@ def set_ssl_certificates( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -731,34 +656,21 @@ def set_ssl_policy( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -817,34 +729,21 @@ def set_url_map( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/target_instances/client.py b/google/cloud/compute_v1/services/target_instances/client.py index 6c213d161..bde61e196 100644 --- a/google/cloud/compute_v1/services/target_instances/client.py +++ b/google/cloud/compute_v1/services/target_instances/client.py @@ -444,31 +444,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -553,14 +543,14 @@ def get( Returns: google.cloud.compute_v1.types.TargetInstance: - Represents a Target Instance resource. - - You can use a target instance to handle traffic for - one or more forwarding rules, which is ideal for - forwarding protocol traffic that is managed by a - single source. For example, ESP, AH, TCP, or UDP. For - more information, read Target instances. (== - resource_for {$api_version}.targetInstances ==) + Represents a Target Instance + resource. You can use a target instance + to handle traffic for one or more + forwarding rules, which is ideal for + forwarding protocol traffic that is + managed by a single source. For example, + ESP, AH, TCP, or UDP. For more + information, read Target instances. """ # Create or coerce a protobuf request object. @@ -642,31 +632,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/target_instances/transports/rest.py b/google/cloud/compute_v1/services/target_instances/transports/rest.py index 8268725ce..6c261ec8a 100644 --- a/google/cloud/compute_v1/services/target_instances/transports/rest.py +++ b/google/cloud/compute_v1/services/target_instances/transports/rest.py @@ -179,34 +179,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -257,14 +244,14 @@ def get( Returns: ~.compute.TargetInstance: - Represents a Target Instance resource. - - You can use a target instance to handle traffic for one - or more forwarding rules, which is ideal for forwarding - protocol traffic that is managed by a single source. For - example, ESP, AH, TCP, or UDP. For more information, - read Target instances. (== resource_for - {$api_version}.targetInstances ==) + Represents a Target Instance + resource. You can use a target instance + to handle traffic for one or more + forwarding rules, which is ideal for + forwarding protocol traffic that is + managed by a single source. For example, + ESP, AH, TCP, or UDP. For more + information, read Target instances. """ @@ -315,34 +302,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/target_pools/client.py b/google/cloud/compute_v1/services/target_pools/client.py index 370f46a40..9669e8b2d 100644 --- a/google/cloud/compute_v1/services/target_pools/client.py +++ b/google/cloud/compute_v1/services/target_pools/client.py @@ -377,31 +377,21 @@ def add_health_check( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -501,31 +491,21 @@ def add_instance( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -685,31 +665,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -793,13 +763,13 @@ def get( Returns: google.cloud.compute_v1.types.TargetPool: Represents a Target Pool resource. - - Target pools are used for network TCP/UDP load - balancing. A target pool references member instances, - an associated legacy HttpHealthCheck resource, and, - optionally, a backup target pool. For more - information, read Using target pools. (== - resource_for {$api_version}.targetPools ==) + Target pools are used for network + TCP/UDP load balancing. A target pool + references member instances, an + associated legacy HttpHealthCheck + resource, and, optionally, a backup + target pool. For more information, read + Using target pools. """ # Create or coerce a protobuf request object. @@ -975,31 +945,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1170,31 +1130,21 @@ def remove_health_check( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1294,31 +1244,21 @@ def remove_instance( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1418,31 +1358,21 @@ def set_backup( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/target_pools/transports/rest.py b/google/cloud/compute_v1/services/target_pools/transports/rest.py index 3aa89f507..c5cc3eb6c 100644 --- a/google/cloud/compute_v1/services/target_pools/transports/rest.py +++ b/google/cloud/compute_v1/services/target_pools/transports/rest.py @@ -117,34 +117,21 @@ def add_health_check( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -204,34 +191,21 @@ def add_instance( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -350,34 +324,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -429,13 +390,13 @@ def get( Returns: ~.compute.TargetPool: Represents a Target Pool resource. - - Target pools are used for network TCP/UDP load - balancing. A target pool references member instances, an - associated legacy HttpHealthCheck resource, and, - optionally, a backup target pool. For more information, - read Using target pools. (== resource_for - {$api_version}.targetPools ==) + Target pools are used for network + TCP/UDP load balancing. A target pool + references member instances, an + associated legacy HttpHealthCheck + resource, and, optionally, a backup + target pool. For more information, read + Using target pools. """ @@ -545,34 +506,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -688,34 +636,21 @@ def remove_health_check( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -775,34 +710,21 @@ def remove_instance( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -862,34 +784,21 @@ def set_backup( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/target_ssl_proxies/client.py b/google/cloud/compute_v1/services/target_ssl_proxies/client.py index e1f75e026..bcb4c4176 100644 --- a/google/cloud/compute_v1/services/target_ssl_proxies/client.py +++ b/google/cloud/compute_v1/services/target_ssl_proxies/client.py @@ -365,31 +365,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -464,14 +454,14 @@ def get( Returns: google.cloud.compute_v1.types.TargetSslProxy: - Represents a Target SSL Proxy resource. - - A target SSL proxy is a component of a SSL Proxy load - balancer. Global forwarding rules reference a target - SSL proxy, and the target proxy then references an - external backend service. For more information, read - Using Target Proxies. (== resource_for - {$api_version}.targetSslProxies ==) + Represents a Target SSL Proxy + resource. A target SSL proxy is a + component of a SSL Proxy load balancer. + Global forwarding rules reference a + target SSL proxy, and the target proxy + then references an external backend + service. For more information, read + Using Target Proxies. """ # Create or coerce a protobuf request object. @@ -543,31 +533,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -721,31 +701,21 @@ def set_backend_service( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -834,31 +804,21 @@ def set_proxy_header( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -948,31 +908,21 @@ def set_ssl_certificates( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1067,31 +1017,21 @@ def set_ssl_policy( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/target_ssl_proxies/transports/rest.py b/google/cloud/compute_v1/services/target_ssl_proxies/transports/rest.py index 8cbd9875a..38dc06094 100644 --- a/google/cloud/compute_v1/services/target_ssl_proxies/transports/rest.py +++ b/google/cloud/compute_v1/services/target_ssl_proxies/transports/rest.py @@ -117,34 +117,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -194,14 +181,14 @@ def get( Returns: ~.compute.TargetSslProxy: - Represents a Target SSL Proxy resource. - - A target SSL proxy is a component of a SSL Proxy load - balancer. Global forwarding rules reference a target SSL - proxy, and the target proxy then references an external - backend service. For more information, read Using Target - Proxies. (== resource_for - {$api_version}.targetSslProxies ==) + Represents a Target SSL Proxy + resource. A target SSL proxy is a + component of a SSL Proxy load balancer. + Global forwarding rules reference a + target SSL proxy, and the target proxy + then references an external backend + service. For more information, read + Using Target Proxies. """ @@ -251,34 +238,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -394,34 +368,21 @@ def set_backend_service( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -480,34 +441,21 @@ def set_proxy_header( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -566,34 +514,21 @@ def set_ssl_certificates( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -652,34 +587,21 @@ def set_ssl_policy( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/target_tcp_proxies/client.py b/google/cloud/compute_v1/services/target_tcp_proxies/client.py index bd3139fee..a0922b36c 100644 --- a/google/cloud/compute_v1/services/target_tcp_proxies/client.py +++ b/google/cloud/compute_v1/services/target_tcp_proxies/client.py @@ -365,31 +365,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -464,14 +454,14 @@ def get( Returns: google.cloud.compute_v1.types.TargetTcpProxy: - Represents a Target TCP Proxy resource. - - A target TCP proxy is a component of a TCP Proxy load - balancer. Global forwarding rules reference target - TCP proxy, and the target proxy then references an - external backend service. For more information, read - TCP Proxy Load Balancing overview. (== resource_for - {$api_version}.targetTcpProxies ==) + Represents a Target TCP Proxy + resource. A target TCP proxy is a + component of a TCP Proxy load balancer. + Global forwarding rules reference target + TCP proxy, and the target proxy then + references an external backend service. + For more information, read TCP Proxy + Load Balancing overview. """ # Create or coerce a protobuf request object. @@ -543,31 +533,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -721,31 +701,21 @@ def set_backend_service( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -834,31 +804,21 @@ def set_proxy_header( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/target_tcp_proxies/transports/rest.py b/google/cloud/compute_v1/services/target_tcp_proxies/transports/rest.py index 8476f9448..1813b0029 100644 --- a/google/cloud/compute_v1/services/target_tcp_proxies/transports/rest.py +++ b/google/cloud/compute_v1/services/target_tcp_proxies/transports/rest.py @@ -117,34 +117,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -194,14 +181,14 @@ def get( Returns: ~.compute.TargetTcpProxy: - Represents a Target TCP Proxy resource. - - A target TCP proxy is a component of a TCP Proxy load - balancer. Global forwarding rules reference target TCP - proxy, and the target proxy then references an external - backend service. For more information, read TCP Proxy - Load Balancing overview. (== resource_for - {$api_version}.targetTcpProxies ==) + Represents a Target TCP Proxy + resource. A target TCP proxy is a + component of a TCP Proxy load balancer. + Global forwarding rules reference target + TCP proxy, and the target proxy then + references an external backend service. + For more information, read TCP Proxy + Load Balancing overview. """ @@ -251,34 +238,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -394,34 +368,21 @@ def set_backend_service( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -480,34 +441,21 @@ def set_proxy_header( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/target_vpn_gateways/client.py b/google/cloud/compute_v1/services/target_vpn_gateways/client.py index ed98421d4..56408cf76 100644 --- a/google/cloud/compute_v1/services/target_vpn_gateways/client.py +++ b/google/cloud/compute_v1/services/target_vpn_gateways/client.py @@ -444,31 +444,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -551,12 +541,11 @@ def get( Returns: google.cloud.compute_v1.types.TargetVpnGateway: - Represents a Target VPN Gateway resource. - - The target VPN gateway resource represents a Classic - Cloud VPN gateway. For more information, read the the - Cloud VPN Overview. (== resource_for - {$api_version}.targetVpnGateways ==) + Represents a Target VPN Gateway + resource. The target VPN gateway + resource represents a Classic Cloud VPN + gateway. For more information, read the + the Cloud VPN Overview. """ # Create or coerce a protobuf request object. @@ -636,31 +625,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/target_vpn_gateways/transports/rest.py b/google/cloud/compute_v1/services/target_vpn_gateways/transports/rest.py index 498677658..489124f8d 100644 --- a/google/cloud/compute_v1/services/target_vpn_gateways/transports/rest.py +++ b/google/cloud/compute_v1/services/target_vpn_gateways/transports/rest.py @@ -179,34 +179,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -257,12 +244,11 @@ def get( Returns: ~.compute.TargetVpnGateway: - Represents a Target VPN Gateway resource. - - The target VPN gateway resource represents a Classic - Cloud VPN gateway. For more information, read the the - Cloud VPN Overview. (== resource_for - {$api_version}.targetVpnGateways ==) + Represents a Target VPN Gateway + resource. The target VPN gateway + resource represents a Classic Cloud VPN + gateway. For more information, read the + the Cloud VPN Overview. """ @@ -313,34 +299,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/url_maps/client.py b/google/cloud/compute_v1/services/url_maps/client.py index 10ee0eada..549efb047 100644 --- a/google/cloud/compute_v1/services/url_maps/client.py +++ b/google/cloud/compute_v1/services/url_maps/client.py @@ -436,31 +436,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -533,39 +523,27 @@ def get( Returns: google.cloud.compute_v1.types.UrlMap: - Represents a URL Map resource. - - Google Compute Engine has two URL Map resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/urlMaps) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionUrlMaps) - - A URL map resource is a component of certain types of - GCP load balancers and Traffic Director. - - - urlMaps are used by external HTTP(S) load - balancers and Traffic Director. \* regionUrlMaps - are used by internal HTTP(S) load balancers. - - For a list of supported URL map features by load - balancer type, see the Load balancing features: - Routing and traffic management table. - - For a list of supported URL map features for Traffic - Director, see the Traffic Director features: Routing - and traffic management table. - - This resource defines mappings from host names and - URL paths to either a backend service or a backend - bucket. - - To use the global urlMaps resource, the backend - service must have a loadBalancingScheme of either - EXTERNAL or INTERNAL_SELF_MANAGED. To use the - regionUrlMaps resource, the backend service must have - a loadBalancingScheme of INTERNAL_MANAGED. For more - information, read URL Map Concepts. + Represents a URL Map resource. Google Compute Engine has + two URL Map resources: \* + [Global](/compute/docs/reference/rest/v1/urlMaps) \* + [Regional](/compute/docs/reference/rest/v1/regionUrlMaps) + A URL map resource is a component of certain types of + GCP load balancers and Traffic Director. \* urlMaps are + used by external HTTP(S) load balancers and Traffic + Director. \* regionUrlMaps are used by internal HTTP(S) + load balancers. For a list of supported URL map features + by load balancer type, see the Load balancing features: + Routing and traffic management table. For a list of + supported URL map features for Traffic Director, see the + Traffic Director features: Routing and traffic + management table. This resource defines mappings from + host names and URL paths to either a backend service or + a backend bucket. To use the global urlMaps resource, + the backend service must have a loadBalancingScheme of + either EXTERNAL or INTERNAL_SELF_MANAGED. To use the + regionUrlMaps resource, the backend service must have a + loadBalancingScheme of INTERNAL_MANAGED. For more + information, read URL Map Concepts. """ # Create or coerce a protobuf request object. @@ -636,31 +614,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -708,9 +676,8 @@ def invalidate_cache( metadata: Sequence[Tuple[str, str]] = (), ) -> compute.Operation: r"""Initiates a cache invalidation operation, invalidating the - specified path, scoped to the specified UrlMap. - - For more information, see `Invalidating cached + specified path, scoped to the specified UrlMap. For more + information, see `Invalidating cached content `__. Args: @@ -743,31 +710,21 @@ def invalidate_cache( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -922,31 +879,21 @@ def patch( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -1027,31 +974,21 @@ def update( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/url_maps/transports/rest.py b/google/cloud/compute_v1/services/url_maps/transports/rest.py index a186a0105..9e39d99c8 100644 --- a/google/cloud/compute_v1/services/url_maps/transports/rest.py +++ b/google/cloud/compute_v1/services/url_maps/transports/rest.py @@ -175,34 +175,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -249,36 +236,25 @@ def get( Returns: ~.compute.UrlMap: - Represents a URL Map resource. - - Google Compute Engine has two URL Map resources: - - - `Global `__ - \* - `Regional `__ - + Represents a URL Map resource. Google Compute Engine has + two URL Map resources: \* + `Global `__ \* + `Regional `__ A URL map resource is a component of certain types of - GCP load balancers and Traffic Director. - - - urlMaps are used by external HTTP(S) load balancers - and Traffic Director. \* regionUrlMaps are used by - internal HTTP(S) load balancers. - - For a list of supported URL map features by load - balancer type, see the Load balancing features: Routing - and traffic management table. - - For a list of supported URL map features for Traffic - Director, see the Traffic Director features: Routing and - traffic management table. - - This resource defines mappings from host names and URL - paths to either a backend service or a backend bucket. - - To use the global urlMaps resource, the backend service - must have a loadBalancingScheme of either EXTERNAL or - INTERNAL_SELF_MANAGED. To use the regionUrlMaps - resource, the backend service must have a + GCP load balancers and Traffic Director. \* urlMaps are + used by external HTTP(S) load balancers and Traffic + Director. \* regionUrlMaps are used by internal HTTP(S) + load balancers. For a list of supported URL map features + by load balancer type, see the Load balancing features: + Routing and traffic management table. For a list of + supported URL map features for Traffic Director, see the + Traffic Director features: Routing and traffic + management table. This resource defines mappings from + host names and URL paths to either a backend service or + a backend bucket. To use the global urlMaps resource, + the backend service must have a loadBalancingScheme of + either EXTERNAL or INTERNAL_SELF_MANAGED. To use the + regionUrlMaps resource, the backend service must have a loadBalancingScheme of INTERNAL_MANAGED. For more information, read URL Map Concepts. @@ -325,34 +301,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -409,34 +372,21 @@ def invalidate_cache( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -548,34 +498,21 @@ def patch( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -631,34 +568,21 @@ def update( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/vpn_gateways/client.py b/google/cloud/compute_v1/services/vpn_gateways/client.py index 22ca1a123..8993c987b 100644 --- a/google/cloud/compute_v1/services/vpn_gateways/client.py +++ b/google/cloud/compute_v1/services/vpn_gateways/client.py @@ -438,31 +438,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -541,15 +531,15 @@ def get( Returns: google.cloud.compute_v1.types.VpnGateway: - Represents a HA VPN gateway. - - HA VPN is a high-availability (HA) Cloud VPN solution - that lets you securely connect your on-premises - network to your Google Cloud Virtual Private Cloud - network through an IPsec VPN connection in a single - region. For more information about Cloud HA VPN - solutions, see Cloud VPN topologies . (== - resource_for {$api_version}.vpnGateways ==) + Represents a HA VPN gateway. HA VPN + is a high-availability (HA) Cloud VPN + solution that lets you securely connect + your on-premises network to your Google + Cloud Virtual Private Cloud network + through an IPsec VPN connection in a + single region. For more information + about Cloud HA VPN solutions, see Cloud + VPN topologies . """ # Create or coerce a protobuf request object. @@ -707,31 +697,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -901,31 +881,21 @@ def set_labels( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/vpn_gateways/transports/rest.py b/google/cloud/compute_v1/services/vpn_gateways/transports/rest.py index bd80ef898..725709ac6 100644 --- a/google/cloud/compute_v1/services/vpn_gateways/transports/rest.py +++ b/google/cloud/compute_v1/services/vpn_gateways/transports/rest.py @@ -176,34 +176,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -254,15 +241,15 @@ def get( Returns: ~.compute.VpnGateway: - Represents a HA VPN gateway. - - HA VPN is a high-availability (HA) Cloud VPN solution - that lets you securely connect your on-premises network - to your Google Cloud Virtual Private Cloud network - through an IPsec VPN connection in a single region. For - more information about Cloud HA VPN solutions, see Cloud - VPN topologies . (== resource_for - {$api_version}.vpnGateways ==) + Represents a HA VPN gateway. HA VPN + is a high-availability (HA) Cloud VPN + solution that lets you securely connect + your on-premises network to your Google + Cloud Virtual Private Cloud network + through an IPsec VPN connection in a + single region. For more information + about Cloud HA VPN solutions, see Cloud + VPN topologies . """ @@ -363,34 +350,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -506,34 +480,21 @@ def set_labels( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/vpn_tunnels/client.py b/google/cloud/compute_v1/services/vpn_tunnels/client.py index f0a893b6f..1521275fb 100644 --- a/google/cloud/compute_v1/services/vpn_tunnels/client.py +++ b/google/cloud/compute_v1/services/vpn_tunnels/client.py @@ -440,31 +440,21 @@ def delete( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -545,11 +535,9 @@ def get( Returns: google.cloud.compute_v1.types.VpnTunnel: - Represents a Cloud VPN Tunnel resource. - - For more information about VPN, read the the Cloud - VPN Overview. (== resource_for - {$api_version}.vpnTunnels ==) + Represents a Cloud VPN Tunnel + resource. For more information about + VPN, read the the Cloud VPN Overview. """ # Create or coerce a protobuf request object. @@ -629,31 +617,21 @@ def insert( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/vpn_tunnels/transports/rest.py b/google/cloud/compute_v1/services/vpn_tunnels/transports/rest.py index a37cdabe0..aa4426a59 100644 --- a/google/cloud/compute_v1/services/vpn_tunnels/transports/rest.py +++ b/google/cloud/compute_v1/services/vpn_tunnels/transports/rest.py @@ -176,34 +176,21 @@ def delete( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -253,10 +240,9 @@ def get( Returns: ~.compute.VpnTunnel: - Represents a Cloud VPN Tunnel resource. - - For more information about VPN, read the the Cloud VPN - Overview. (== resource_for {$api_version}.vpnTunnels ==) + Represents a Cloud VPN Tunnel + resource. For more information about + VPN, read the the Cloud VPN Overview. """ @@ -305,34 +291,21 @@ def insert( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/zone_operations/client.py b/google/cloud/compute_v1/services/zone_operations/client.py index 993cad0a8..96c49a391 100644 --- a/google/cloud/compute_v1/services/zone_operations/client.py +++ b/google/cloud/compute_v1/services/zone_operations/client.py @@ -456,31 +456,21 @@ def get( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. @@ -613,19 +603,16 @@ def wait( ) -> compute.Operation: r"""Waits for the specified Operation resource to return as ``DONE`` or for the request to approach the 2 minute deadline, and - retrieves the specified Operation resource. This method differs - from the ``GET`` method in that it waits for no more than the - default deadline (2 minutes) and then returns the current state - of the operation, which might be ``DONE`` or still in progress. - - This method is called on a best-effort basis. Specifically: - - - In uncommon cases, when the server is overloaded, the request - might return before the default deadline is reached, or might - return after zero seconds. - - If the default deadline is reached, there is no guarantee - that the operation is actually done when the method returns. - Be prepared to retry if the operation is not ``DONE``. + retrieves the specified Operation resource. This method waits + for no more than the 2 minutes and then returns the current + state of the operation, which might be ``DONE`` or still in + progress. This method is called on a best-effort basis. + Specifically: - In uncommon cases, when the server is + overloaded, the request might return before the default deadline + is reached, or might return after zero seconds. - If the default + deadline is reached, there is no guarantee that the operation is + actually done when the method returns. Be prepared to retry if + the operation is not ``DONE``. Args: request (google.cloud.compute_v1.types.WaitZoneOperationRequest): @@ -657,31 +644,21 @@ def wait( Returns: google.cloud.compute_v1.types.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) - \* - [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) - \* - [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) - - You can use an operation resource to manage - asynchronous API requests. For more information, read - Handling API responses. - - Operations can be global, regional or zonal. - For - global operations, use the globalOperations resource. - - For regional operations, use the regionOperations - resource. - For zonal operations, use the - zonalOperations resource. - - For more information, read Global, Regional, and - Zonal Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + [Global](/compute/docs/reference/rest/v1/globalOperations) + \* + [Regional](/compute/docs/reference/rest/v1/regionOperations) + \* + [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + You can use an operation resource to manage asynchronous + API requests. For more information, read Handling API + responses. Operations can be global, regional or zonal. + - For global operations, use the globalOperations + resource. - For regional operations, use the + regionOperations resource. - For zonal operations, use + the zonalOperations resource. For more information, read + Global, Regional, and Zonal Resources. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/zone_operations/transports/rest.py b/google/cloud/compute_v1/services/zone_operations/transports/rest.py index fd18f16ab..6e1970eba 100644 --- a/google/cloud/compute_v1/services/zone_operations/transports/rest.py +++ b/google/cloud/compute_v1/services/zone_operations/transports/rest.py @@ -170,34 +170,21 @@ def get( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ @@ -305,34 +292,21 @@ def wait( Returns: ~.compute.Operation: - Represents an Operation resource. - - Google Compute Engine has three Operation resources: - - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ - + Represents an Operation resource. Google Compute Engine + has three Operation resources: \* + `Global `__ + \* + `Regional `__ + \* + `Zonal `__ You can use an operation resource to manage asynchronous API requests. For more information, read Handling API - responses. - - Operations can be global, regional or zonal. - - - For global operations, use the ``globalOperations`` - resource. - - For regional operations, use the ``regionOperations`` - resource. - - For zonal operations, use the ``zonalOperations`` - resource. - - For more information, read Global, Regional, and Zonal - Resources. (== resource_for - {$api_version}.globalOperations ==) (== resource_for - {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) + responses. Operations can be global, regional or zonal. + - For global operations, use the ``globalOperations`` + resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, + use the ``zonalOperations`` resource. For more + information, read Global, Regional, and Zonal Resources. """ diff --git a/google/cloud/compute_v1/services/zones/client.py b/google/cloud/compute_v1/services/zones/client.py index 7305b0a98..1264071d3 100644 --- a/google/cloud/compute_v1/services/zones/client.py +++ b/google/cloud/compute_v1/services/zones/client.py @@ -361,13 +361,12 @@ def get( Returns: google.cloud.compute_v1.types.Zone: - Represents a Zone resource. - - A zone is a deployment area. These deployment areas - are subsets of a region. For example the zone - us-east1-a is located in the us-east1 region. For - more information, read Regions and Zones. (== - resource_for {$api_version}.zones ==) + Represents a Zone resource. A zone is + a deployment area. These deployment + areas are subsets of a region. For + example the zone us-east1-a is located + in the us-east1 region. For more + information, read Regions and Zones. """ # Create or coerce a protobuf request object. diff --git a/google/cloud/compute_v1/services/zones/transports/rest.py b/google/cloud/compute_v1/services/zones/transports/rest.py index c3ad59ff5..1bc003f5f 100644 --- a/google/cloud/compute_v1/services/zones/transports/rest.py +++ b/google/cloud/compute_v1/services/zones/transports/rest.py @@ -116,13 +116,12 @@ def get( Returns: ~.compute.Zone: - Represents a Zone resource. - - A zone is a deployment area. These deployment areas are - subsets of a region. For example the zone us-east1-a is - located in the us-east1 region. For more information, - read Regions and Zones. (== resource_for - {$api_version}.zones ==) + Represents a Zone resource. A zone is + a deployment area. These deployment + areas are subsets of a region. For + example the zone us-east1-a is located + in the us-east1 region. For more + information, read Regions and Zones. """ diff --git a/google/cloud/compute_v1/types/__init__.py b/google/cloud/compute_v1/types/__init__.py index 5c242757f..6816dff8f 100644 --- a/google/cloud/compute_v1/types/__init__.py +++ b/google/cloud/compute_v1/types/__init__.py @@ -66,6 +66,7 @@ AggregatedListReservationsRequest, AggregatedListResourcePoliciesRequest, AggregatedListRoutersRequest, + AggregatedListServiceAttachmentsRequest, AggregatedListSslCertificatesRequest, AggregatedListSubnetworksRequest, AggregatedListTargetHttpProxiesRequest, @@ -204,6 +205,7 @@ DeleteRouteRequest, DeleteRouterRequest, DeleteSecurityPolicyRequest, + DeleteServiceAttachmentRequest, DeleteSignedUrlKeyBackendBucketRequest, DeleteSignedUrlKeyBackendServiceRequest, DeleteSnapshotRequest, @@ -315,8 +317,10 @@ GetIamPolicyRegionDiskRequest, GetIamPolicyReservationRequest, GetIamPolicyResourcePolicyRequest, + GetIamPolicyServiceAttachmentRequest, GetIamPolicySnapshotRequest, GetIamPolicySubnetworkRequest, + GetImageFamilyViewRequest, GetImageRequest, GetInstanceGroupManagerRequest, GetInstanceGroupRequest, @@ -365,6 +369,7 @@ GetScreenshotInstanceRequest, GetSecurityPolicyRequest, GetSerialPortOutputInstanceRequest, + GetServiceAttachmentRequest, GetShieldedInstanceIdentityInstanceRequest, GetSnapshotRequest, GetSslCertificateRequest, @@ -424,6 +429,7 @@ HttpRouteRuleMatch, HTTPSHealthCheck, Image, + ImageFamilyView, ImageList, InitialStateConfig, InsertAddressRequest, @@ -473,6 +479,7 @@ InsertRouteRequest, InsertRouterRequest, InsertSecurityPolicyRequest, + InsertServiceAttachmentRequest, InsertSslCertificateRequest, InsertSslPolicyRequest, InsertSubnetworkRequest, @@ -647,6 +654,7 @@ ListRoutersRequest, ListRoutesRequest, ListSecurityPoliciesRequest, + ListServiceAttachmentsRequest, ListSnapshotsRequest, ListSslCertificatesRequest, ListSslPoliciesRequest, @@ -780,6 +788,7 @@ PatchRuleFirewallPolicyRequest, PatchRuleSecurityPolicyRequest, PatchSecurityPolicyRequest, + PatchServiceAttachmentRequest, PatchSslPolicyRequest, PatchSubnetworkRequest, PatchTargetGrpcProxyRequest, @@ -885,22 +894,27 @@ ResourcePolicyWeeklyCycle, ResourcePolicyWeeklyCycleDayOfWeek, Route, + RouteAsPath, RouteList, Router, RouterAdvertisedIpRange, RouterAggregatedList, RouterBgp, RouterBgpPeer, + RouterBgpPeerBfd, RouterInterface, RouterList, RouterNat, RouterNatLogConfig, + RouterNatRule, + RouterNatRuleAction, RouterNatSubnetworkToNat, RoutersPreviewResponse, RoutersScopedList, RouterStatus, RouterStatusBgpPeerStatus, RouterStatusNatStatus, + RouterStatusNatStatusNatRuleStatus, RouterStatusResponse, Rule, ScalingScheduleStatus, @@ -911,15 +925,26 @@ SecurityPoliciesListPreconfiguredExpressionSetsResponse, SecurityPoliciesWafConfig, SecurityPolicy, + SecurityPolicyAdaptiveProtectionConfig, + SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig, + SecurityPolicyAdvancedOptionsConfig, SecurityPolicyList, SecurityPolicyReference, SecurityPolicyRule, SecurityPolicyRuleMatcher, SecurityPolicyRuleMatcherConfig, SecuritySettings, + SendDiagnosticInterruptInstanceRequest, + SendDiagnosticInterruptInstanceResponse, SerialPortOutput, ServerBinding, ServiceAccount, + ServiceAttachment, + ServiceAttachmentAggregatedList, + ServiceAttachmentConnectedEndpoint, + ServiceAttachmentConsumerProjectLimit, + ServiceAttachmentList, + ServiceAttachmentsScopedList, SetBackendServiceTargetSslProxyRequest, SetBackendServiceTargetTcpProxyRequest, SetBackupTargetPoolRequest, @@ -938,6 +963,7 @@ SetIamPolicyRegionDiskRequest, SetIamPolicyReservationRequest, SetIamPolicyResourcePolicyRequest, + SetIamPolicyServiceAttachmentRequest, SetIamPolicySnapshotRequest, SetIamPolicySubnetworkRequest, SetInstanceTemplateInstanceGroupManagerRequest, @@ -1015,6 +1041,7 @@ SubnetworksExpandIpCidrRangeRequest, SubnetworksScopedList, SubnetworksSetPrivateIpGoogleAccessRequest, + Subsetting, SwitchToCustomModeNetworkRequest, Tags, TargetGrpcProxy, @@ -1073,11 +1100,13 @@ TestIamPermissionsRegionDiskRequest, TestIamPermissionsReservationRequest, TestIamPermissionsResourcePolicyRequest, + TestIamPermissionsServiceAttachmentRequest, TestIamPermissionsSnapshotRequest, TestIamPermissionsSubnetworkRequest, TestIamPermissionsVpnGatewayRequest, TestPermissionsRequest, TestPermissionsResponse, + Uint128, UpdateAccessConfigInstanceRequest, UpdateAutoscalerRequest, UpdateBackendBucketRequest, @@ -1200,6 +1229,7 @@ "AggregatedListReservationsRequest", "AggregatedListResourcePoliciesRequest", "AggregatedListRoutersRequest", + "AggregatedListServiceAttachmentsRequest", "AggregatedListSslCertificatesRequest", "AggregatedListSubnetworksRequest", "AggregatedListTargetHttpProxiesRequest", @@ -1338,6 +1368,7 @@ "DeleteRouteRequest", "DeleteRouterRequest", "DeleteSecurityPolicyRequest", + "DeleteServiceAttachmentRequest", "DeleteSignedUrlKeyBackendBucketRequest", "DeleteSignedUrlKeyBackendServiceRequest", "DeleteSnapshotRequest", @@ -1449,8 +1480,10 @@ "GetIamPolicyRegionDiskRequest", "GetIamPolicyReservationRequest", "GetIamPolicyResourcePolicyRequest", + "GetIamPolicyServiceAttachmentRequest", "GetIamPolicySnapshotRequest", "GetIamPolicySubnetworkRequest", + "GetImageFamilyViewRequest", "GetImageRequest", "GetInstanceGroupManagerRequest", "GetInstanceGroupRequest", @@ -1499,6 +1532,7 @@ "GetScreenshotInstanceRequest", "GetSecurityPolicyRequest", "GetSerialPortOutputInstanceRequest", + "GetServiceAttachmentRequest", "GetShieldedInstanceIdentityInstanceRequest", "GetSnapshotRequest", "GetSslCertificateRequest", @@ -1558,6 +1592,7 @@ "HttpRouteRuleMatch", "HTTPSHealthCheck", "Image", + "ImageFamilyView", "ImageList", "InitialStateConfig", "InsertAddressRequest", @@ -1607,6 +1642,7 @@ "InsertRouteRequest", "InsertRouterRequest", "InsertSecurityPolicyRequest", + "InsertServiceAttachmentRequest", "InsertSslCertificateRequest", "InsertSslPolicyRequest", "InsertSubnetworkRequest", @@ -1781,6 +1817,7 @@ "ListRoutersRequest", "ListRoutesRequest", "ListSecurityPoliciesRequest", + "ListServiceAttachmentsRequest", "ListSnapshotsRequest", "ListSslCertificatesRequest", "ListSslPoliciesRequest", @@ -1914,6 +1951,7 @@ "PatchRuleFirewallPolicyRequest", "PatchRuleSecurityPolicyRequest", "PatchSecurityPolicyRequest", + "PatchServiceAttachmentRequest", "PatchSslPolicyRequest", "PatchSubnetworkRequest", "PatchTargetGrpcProxyRequest", @@ -2019,22 +2057,27 @@ "ResourcePolicyWeeklyCycle", "ResourcePolicyWeeklyCycleDayOfWeek", "Route", + "RouteAsPath", "RouteList", "Router", "RouterAdvertisedIpRange", "RouterAggregatedList", "RouterBgp", "RouterBgpPeer", + "RouterBgpPeerBfd", "RouterInterface", "RouterList", "RouterNat", "RouterNatLogConfig", + "RouterNatRule", + "RouterNatRuleAction", "RouterNatSubnetworkToNat", "RoutersPreviewResponse", "RoutersScopedList", "RouterStatus", "RouterStatusBgpPeerStatus", "RouterStatusNatStatus", + "RouterStatusNatStatusNatRuleStatus", "RouterStatusResponse", "Rule", "ScalingScheduleStatus", @@ -2045,15 +2088,26 @@ "SecurityPoliciesListPreconfiguredExpressionSetsResponse", "SecurityPoliciesWafConfig", "SecurityPolicy", + "SecurityPolicyAdaptiveProtectionConfig", + "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig", + "SecurityPolicyAdvancedOptionsConfig", "SecurityPolicyList", "SecurityPolicyReference", "SecurityPolicyRule", "SecurityPolicyRuleMatcher", "SecurityPolicyRuleMatcherConfig", "SecuritySettings", + "SendDiagnosticInterruptInstanceRequest", + "SendDiagnosticInterruptInstanceResponse", "SerialPortOutput", "ServerBinding", "ServiceAccount", + "ServiceAttachment", + "ServiceAttachmentAggregatedList", + "ServiceAttachmentConnectedEndpoint", + "ServiceAttachmentConsumerProjectLimit", + "ServiceAttachmentList", + "ServiceAttachmentsScopedList", "SetBackendServiceTargetSslProxyRequest", "SetBackendServiceTargetTcpProxyRequest", "SetBackupTargetPoolRequest", @@ -2072,6 +2126,7 @@ "SetIamPolicyRegionDiskRequest", "SetIamPolicyReservationRequest", "SetIamPolicyResourcePolicyRequest", + "SetIamPolicyServiceAttachmentRequest", "SetIamPolicySnapshotRequest", "SetIamPolicySubnetworkRequest", "SetInstanceTemplateInstanceGroupManagerRequest", @@ -2149,6 +2204,7 @@ "SubnetworksExpandIpCidrRangeRequest", "SubnetworksScopedList", "SubnetworksSetPrivateIpGoogleAccessRequest", + "Subsetting", "SwitchToCustomModeNetworkRequest", "Tags", "TargetGrpcProxy", @@ -2207,11 +2263,13 @@ "TestIamPermissionsRegionDiskRequest", "TestIamPermissionsReservationRequest", "TestIamPermissionsResourcePolicyRequest", + "TestIamPermissionsServiceAttachmentRequest", "TestIamPermissionsSnapshotRequest", "TestIamPermissionsSubnetworkRequest", "TestIamPermissionsVpnGatewayRequest", "TestPermissionsRequest", "TestPermissionsResponse", + "Uint128", "UpdateAccessConfigInstanceRequest", "UpdateAutoscalerRequest", "UpdateBackendBucketRequest", diff --git a/google/cloud/compute_v1/types/compute.py b/google/cloud/compute_v1/types/compute.py index 1729ee0a6..219e73044 100644 --- a/google/cloud/compute_v1/types/compute.py +++ b/google/cloud/compute_v1/types/compute.py @@ -19,376 +19,814 @@ __protobuf__ = proto.module( package="google.cloud.compute.v1", manifest={ + "AbandonInstancesInstanceGroupManagerRequest", + "AbandonInstancesRegionInstanceGroupManagerRequest", "AcceleratorConfig", - "DeprecationStatus", "AcceleratorType", - "AcceleratorTypesScopedList", - "Data", - "Warning", "AcceleratorTypeAggregatedList", "AcceleratorTypeList", + "AcceleratorTypesScopedList", + "Accelerators", "AccessConfig", + "AddAccessConfigInstanceRequest", + "AddAssociationFirewallPolicyRequest", + "AddHealthCheckTargetPoolRequest", + "AddInstanceTargetPoolRequest", + "AddInstancesInstanceGroupRequest", + "AddNodesNodeGroupRequest", + "AddPeeringNetworkRequest", + "AddResourcePoliciesDiskRequest", + "AddResourcePoliciesInstanceRequest", + "AddResourcePoliciesRegionDiskRequest", + "AddRuleFirewallPolicyRequest", + "AddRuleSecurityPolicyRequest", + "AddSignedUrlKeyBackendBucketRequest", + "AddSignedUrlKeyBackendServiceRequest", "Address", - "AddressesScopedList", "AddressAggregatedList", "AddressList", + "AddressesScopedList", "AdvancedMachineFeatures", + "AggregatedListAcceleratorTypesRequest", + "AggregatedListAddressesRequest", + "AggregatedListAutoscalersRequest", + "AggregatedListBackendServicesRequest", + "AggregatedListDiskTypesRequest", + "AggregatedListDisksRequest", + "AggregatedListForwardingRulesRequest", + "AggregatedListGlobalOperationsRequest", + "AggregatedListHealthChecksRequest", + "AggregatedListInstanceGroupManagersRequest", + "AggregatedListInstanceGroupsRequest", + "AggregatedListInstancesRequest", + "AggregatedListInterconnectAttachmentsRequest", + "AggregatedListMachineTypesRequest", + "AggregatedListNetworkEndpointGroupsRequest", + "AggregatedListNodeGroupsRequest", + "AggregatedListNodeTemplatesRequest", + "AggregatedListNodeTypesRequest", + "AggregatedListPacketMirroringsRequest", + "AggregatedListPublicDelegatedPrefixesRequest", + "AggregatedListRegionCommitmentsRequest", + "AggregatedListReservationsRequest", + "AggregatedListResourcePoliciesRequest", + "AggregatedListRoutersRequest", + "AggregatedListServiceAttachmentsRequest", + "AggregatedListSslCertificatesRequest", + "AggregatedListSubnetworksRequest", + "AggregatedListTargetHttpProxiesRequest", + "AggregatedListTargetHttpsProxiesRequest", + "AggregatedListTargetInstancesRequest", + "AggregatedListTargetPoolsRequest", + "AggregatedListTargetVpnGatewaysRequest", + "AggregatedListUrlMapsRequest", + "AggregatedListVpnGatewaysRequest", + "AggregatedListVpnTunnelsRequest", "AliasIpRange", "AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk", "AllocationSpecificSKUAllocationReservedInstanceProperties", "AllocationSpecificSKUReservation", - "CustomerEncryptionKey", - "GuestOsFeature", - "AttachedDiskInitializeParams", - "InitialStateConfig", + "Allowed", + "ApplyUpdatesToInstancesInstanceGroupManagerRequest", + "ApplyUpdatesToInstancesRegionInstanceGroupManagerRequest", + "AttachDiskInstanceRequest", + "AttachNetworkEndpointsGlobalNetworkEndpointGroupRequest", + "AttachNetworkEndpointsNetworkEndpointGroupRequest", "AttachedDisk", - "AuditLogConfig", + "AttachedDiskInitializeParams", "AuditConfig", + "AuditLogConfig", "AuthorizationLoggingOptions", - "AutoscalingPolicy", - "ScalingScheduleStatus", - "AutoscalerStatusDetails", "Autoscaler", - "AutoscalersScopedList", "AutoscalerAggregatedList", "AutoscalerList", + "AutoscalerStatusDetails", + "AutoscalersScopedList", + "AutoscalingPolicy", "AutoscalingPolicyCpuUtilization", "AutoscalingPolicyCustomMetricUtilization", "AutoscalingPolicyLoadBalancingUtilization", "AutoscalingPolicyScaleInControl", "AutoscalingPolicyScalingSchedule", - "FixedOrPercent", "Backend", - "BackendBucketCdnPolicy", "BackendBucket", + "BackendBucketCdnPolicy", "BackendBucketCdnPolicyBypassCacheOnRequestHeader", "BackendBucketCdnPolicyNegativeCachingPolicy", "BackendBucketList", - "BackendServiceCdnPolicy", - "CircuitBreakers", - "ConnectionDraining", - "ConsistentHashLoadBalancerSettings", - "BackendServiceFailoverPolicy", - "BackendServiceIAP", - "BackendServiceLogConfig", - "Duration", - "OutlierDetection", - "SecuritySettings", "BackendService", - "BackendServicesScopedList", "BackendServiceAggregatedList", + "BackendServiceCdnPolicy", "BackendServiceCdnPolicyBypassCacheOnRequestHeader", - "CacheKeyPolicy", "BackendServiceCdnPolicyNegativeCachingPolicy", - "HealthStatus", + "BackendServiceFailoverPolicy", "BackendServiceGroupHealth", + "BackendServiceIAP", "BackendServiceList", + "BackendServiceLogConfig", "BackendServiceReference", - "Expr", + "BackendServicesScopedList", "Binding", - "InstanceProperties", - "LocationPolicy", - "BulkInsertInstanceResourcePerInstanceProperties", + "BulkInsertInstanceRequest", "BulkInsertInstanceResource", + "BulkInsertInstanceResourcePerInstanceProperties", + "BulkInsertRegionInstanceRequest", "CacheInvalidationRule", - "LicenseResourceCommitment", - "Reservation", - "ResourceCommitment", + "CacheKeyPolicy", + "CircuitBreakers", + "CloneRulesFirewallPolicyRequest", "Commitment", - "CommitmentsScopedList", "CommitmentAggregatedList", "CommitmentList", + "CommitmentsScopedList", "Condition", "ConfidentialInstanceConfig", + "ConnectionDraining", + "ConsistentHashLoadBalancerSettings", "ConsistentHashLoadBalancerSettingsHttpCookie", "CorsPolicy", + "CreateInstancesInstanceGroupManagerRequest", + "CreateInstancesRegionInstanceGroupManagerRequest", + "CreateSnapshotDiskRequest", + "CreateSnapshotRegionDiskRequest", + "CustomerEncryptionKey", "CustomerEncryptionKeyProtectedDisk", + "Data", + "DeleteAccessConfigInstanceRequest", + "DeleteAddressRequest", + "DeleteAutoscalerRequest", + "DeleteBackendBucketRequest", + "DeleteBackendServiceRequest", + "DeleteDiskRequest", + "DeleteExternalVpnGatewayRequest", + "DeleteFirewallPolicyRequest", + "DeleteFirewallRequest", + "DeleteForwardingRuleRequest", + "DeleteGlobalAddressRequest", + "DeleteGlobalForwardingRuleRequest", + "DeleteGlobalNetworkEndpointGroupRequest", + "DeleteGlobalOperationRequest", + "DeleteGlobalOperationResponse", + "DeleteGlobalOrganizationOperationRequest", + "DeleteGlobalOrganizationOperationResponse", + "DeleteGlobalPublicDelegatedPrefixeRequest", + "DeleteHealthCheckRequest", + "DeleteImageRequest", + "DeleteInstanceGroupManagerRequest", + "DeleteInstanceGroupRequest", + "DeleteInstanceRequest", + "DeleteInstanceTemplateRequest", + "DeleteInstancesInstanceGroupManagerRequest", + "DeleteInstancesRegionInstanceGroupManagerRequest", + "DeleteInterconnectAttachmentRequest", + "DeleteInterconnectRequest", + "DeleteLicenseRequest", + "DeleteNetworkEndpointGroupRequest", + "DeleteNetworkRequest", + "DeleteNodeGroupRequest", + "DeleteNodeTemplateRequest", + "DeleteNodesNodeGroupRequest", + "DeletePacketMirroringRequest", + "DeletePerInstanceConfigsInstanceGroupManagerRequest", + "DeletePerInstanceConfigsRegionInstanceGroupManagerRequest", + "DeletePublicAdvertisedPrefixeRequest", + "DeletePublicDelegatedPrefixeRequest", + "DeleteRegionAutoscalerRequest", + "DeleteRegionBackendServiceRequest", + "DeleteRegionDiskRequest", + "DeleteRegionHealthCheckRequest", + "DeleteRegionHealthCheckServiceRequest", + "DeleteRegionInstanceGroupManagerRequest", + "DeleteRegionNetworkEndpointGroupRequest", + "DeleteRegionNotificationEndpointRequest", + "DeleteRegionOperationRequest", + "DeleteRegionOperationResponse", + "DeleteRegionSslCertificateRequest", + "DeleteRegionTargetHttpProxyRequest", + "DeleteRegionTargetHttpsProxyRequest", + "DeleteRegionUrlMapRequest", + "DeleteReservationRequest", + "DeleteResourcePolicyRequest", + "DeleteRouteRequest", + "DeleteRouterRequest", + "DeleteSecurityPolicyRequest", + "DeleteServiceAttachmentRequest", + "DeleteSignedUrlKeyBackendBucketRequest", + "DeleteSignedUrlKeyBackendServiceRequest", + "DeleteSnapshotRequest", + "DeleteSslCertificateRequest", + "DeleteSslPolicyRequest", + "DeleteSubnetworkRequest", + "DeleteTargetGrpcProxyRequest", + "DeleteTargetHttpProxyRequest", + "DeleteTargetHttpsProxyRequest", + "DeleteTargetInstanceRequest", + "DeleteTargetPoolRequest", + "DeleteTargetSslProxyRequest", + "DeleteTargetTcpProxyRequest", + "DeleteTargetVpnGatewayRequest", + "DeleteUrlMapRequest", + "DeleteVpnGatewayRequest", + "DeleteVpnTunnelRequest", + "DeleteZoneOperationRequest", + "DeleteZoneOperationResponse", + "Denied", + "DeprecateImageRequest", + "DeprecationStatus", + "DetachDiskInstanceRequest", + "DetachNetworkEndpointsGlobalNetworkEndpointGroupRequest", + "DetachNetworkEndpointsNetworkEndpointGroupRequest", + "DisableXpnHostProjectRequest", + "DisableXpnResourceProjectRequest", "Disk", - "DisksScopedList", "DiskAggregatedList", "DiskInstantiationConfig", "DiskList", "DiskMoveRequest", "DiskType", - "DiskTypesScopedList", "DiskTypeAggregatedList", "DiskTypeList", + "DiskTypesScopedList", "DisksAddResourcePoliciesRequest", "DisksRemoveResourcePoliciesRequest", "DisksResizeRequest", + "DisksScopedList", "DisplayDevice", - "DistributionPolicyZoneConfiguration", "DistributionPolicy", + "DistributionPolicyZoneConfiguration", + "Duration", + "EnableXpnHostProjectRequest", + "EnableXpnResourceProjectRequest", + "Error", + "Errors", "ExchangedPeeringRoute", "ExchangedPeeringRoutesList", - "ExternalVpnGatewayInterface", + "ExpandIpCidrRangeSubnetworkRequest", + "Expr", "ExternalVpnGateway", + "ExternalVpnGatewayInterface", "ExternalVpnGatewayList", "FileContentBuffer", - "Allowed", - "Denied", - "FirewallLogConfig", "Firewall", "FirewallList", - "FirewallPolicyAssociation", + "FirewallLogConfig", "FirewallPoliciesListAssociationsResponse", - "FirewallPolicyRule", "FirewallPolicy", + "FirewallPolicyAssociation", "FirewallPolicyList", + "FirewallPolicyRule", "FirewallPolicyRuleMatcher", "FirewallPolicyRuleMatcherLayer4Config", - "MetadataFilter", - "ForwardingRuleServiceDirectoryRegistration", + "FixedOrPercent", "ForwardingRule", - "ForwardingRulesScopedList", "ForwardingRuleAggregatedList", "ForwardingRuleList", "ForwardingRuleReference", + "ForwardingRuleServiceDirectoryRegistration", + "ForwardingRulesScopedList", "GRPCHealthCheck", - "NetworkEndpoint", + "GetAcceleratorTypeRequest", + "GetAddressRequest", + "GetAssociationFirewallPolicyRequest", + "GetAutoscalerRequest", + "GetBackendBucketRequest", + "GetBackendServiceRequest", + "GetDiagnosticsInterconnectRequest", + "GetDiskRequest", + "GetDiskTypeRequest", + "GetEffectiveFirewallsInstanceRequest", + "GetEffectiveFirewallsNetworkRequest", + "GetExternalVpnGatewayRequest", + "GetFirewallPolicyRequest", + "GetFirewallRequest", + "GetForwardingRuleRequest", + "GetFromFamilyImageRequest", + "GetGlobalAddressRequest", + "GetGlobalForwardingRuleRequest", + "GetGlobalNetworkEndpointGroupRequest", + "GetGlobalOperationRequest", + "GetGlobalOrganizationOperationRequest", + "GetGlobalPublicDelegatedPrefixeRequest", + "GetGuestAttributesInstanceRequest", + "GetHealthBackendServiceRequest", + "GetHealthCheckRequest", + "GetHealthRegionBackendServiceRequest", + "GetHealthTargetPoolRequest", + "GetIamPolicyDiskRequest", + "GetIamPolicyFirewallPolicyRequest", + "GetIamPolicyImageRequest", + "GetIamPolicyInstanceRequest", + "GetIamPolicyInstanceTemplateRequest", + "GetIamPolicyLicenseRequest", + "GetIamPolicyNodeGroupRequest", + "GetIamPolicyNodeTemplateRequest", + "GetIamPolicyRegionDiskRequest", + "GetIamPolicyReservationRequest", + "GetIamPolicyResourcePolicyRequest", + "GetIamPolicyServiceAttachmentRequest", + "GetIamPolicySnapshotRequest", + "GetIamPolicySubnetworkRequest", + "GetImageFamilyViewRequest", + "GetImageRequest", + "GetInstanceGroupManagerRequest", + "GetInstanceGroupRequest", + "GetInstanceRequest", + "GetInstanceTemplateRequest", + "GetInterconnectAttachmentRequest", + "GetInterconnectLocationRequest", + "GetInterconnectRequest", + "GetLicenseCodeRequest", + "GetLicenseRequest", + "GetMachineTypeRequest", + "GetNatMappingInfoRoutersRequest", + "GetNetworkEndpointGroupRequest", + "GetNetworkRequest", + "GetNodeGroupRequest", + "GetNodeTemplateRequest", + "GetNodeTypeRequest", + "GetPacketMirroringRequest", + "GetProjectRequest", + "GetPublicAdvertisedPrefixeRequest", + "GetPublicDelegatedPrefixeRequest", + "GetRegionAutoscalerRequest", + "GetRegionBackendServiceRequest", + "GetRegionCommitmentRequest", + "GetRegionDiskRequest", + "GetRegionDiskTypeRequest", + "GetRegionHealthCheckRequest", + "GetRegionHealthCheckServiceRequest", + "GetRegionInstanceGroupManagerRequest", + "GetRegionInstanceGroupRequest", + "GetRegionNetworkEndpointGroupRequest", + "GetRegionNotificationEndpointRequest", + "GetRegionOperationRequest", + "GetRegionRequest", + "GetRegionSslCertificateRequest", + "GetRegionTargetHttpProxyRequest", + "GetRegionTargetHttpsProxyRequest", + "GetRegionUrlMapRequest", + "GetReservationRequest", + "GetResourcePolicyRequest", + "GetRouteRequest", + "GetRouterRequest", + "GetRouterStatusRouterRequest", + "GetRuleFirewallPolicyRequest", + "GetRuleSecurityPolicyRequest", + "GetScreenshotInstanceRequest", + "GetSecurityPolicyRequest", + "GetSerialPortOutputInstanceRequest", + "GetServiceAttachmentRequest", + "GetShieldedInstanceIdentityInstanceRequest", + "GetSnapshotRequest", + "GetSslCertificateRequest", + "GetSslPolicyRequest", + "GetStatusVpnGatewayRequest", + "GetSubnetworkRequest", + "GetTargetGrpcProxyRequest", + "GetTargetHttpProxyRequest", + "GetTargetHttpsProxyRequest", + "GetTargetInstanceRequest", + "GetTargetPoolRequest", + "GetTargetSslProxyRequest", + "GetTargetTcpProxyRequest", + "GetTargetVpnGatewayRequest", + "GetUrlMapRequest", + "GetVpnGatewayRequest", + "GetVpnTunnelRequest", + "GetXpnHostProjectRequest", + "GetXpnResourcesProjectsRequest", + "GetZoneOperationRequest", + "GetZoneRequest", "GlobalNetworkEndpointGroupsAttachEndpointsRequest", "GlobalNetworkEndpointGroupsDetachEndpointsRequest", - "Policy", "GlobalOrganizationSetPolicyRequest", "GlobalSetLabelsRequest", "GlobalSetPolicyRequest", - "GuestAttributesValue", "GuestAttributes", "GuestAttributesEntry", + "GuestAttributesValue", + "GuestOsFeature", "HTTP2HealthCheck", "HTTPHealthCheck", "HTTPSHealthCheck", - "HealthCheckLogConfig", - "SSLHealthCheck", - "TCPHealthCheck", "HealthCheck", "HealthCheckList", + "HealthCheckLogConfig", "HealthCheckReference", "HealthCheckService", "HealthCheckServiceReference", "HealthCheckServicesList", - "HealthChecksScopedList", "HealthChecksAggregatedList", + "HealthChecksScopedList", + "HealthStatus", "HealthStatusForNetworkEndpoint", "HostRule", "HttpFaultAbort", "HttpFaultDelay", "HttpFaultInjection", - "HttpHeaderOption", "HttpHeaderAction", - "Int64RangeMatch", "HttpHeaderMatch", + "HttpHeaderOption", "HttpQueryParameterMatch", "HttpRedirectAction", "HttpRetryPolicy", - "RequestMirrorPolicy", - "UrlRewrite", - "WeightedBackendService", "HttpRouteAction", - "HttpRouteRuleMatch", "HttpRouteRule", - "RawDisk", + "HttpRouteRuleMatch", "Image", + "ImageFamilyView", "ImageList", - "Metadata", - "NetworkInterface", - "ReservationAffinity", - "Scheduling", - "ServiceAccount", - "ShieldedInstanceConfig", - "ShieldedInstanceIntegrityPolicy", - "Tags", + "InitialStateConfig", + "InsertAddressRequest", + "InsertAutoscalerRequest", + "InsertBackendBucketRequest", + "InsertBackendServiceRequest", + "InsertDiskRequest", + "InsertExternalVpnGatewayRequest", + "InsertFirewallPolicyRequest", + "InsertFirewallRequest", + "InsertForwardingRuleRequest", + "InsertGlobalAddressRequest", + "InsertGlobalForwardingRuleRequest", + "InsertGlobalNetworkEndpointGroupRequest", + "InsertGlobalPublicDelegatedPrefixeRequest", + "InsertHealthCheckRequest", + "InsertImageRequest", + "InsertInstanceGroupManagerRequest", + "InsertInstanceGroupRequest", + "InsertInstanceRequest", + "InsertInstanceTemplateRequest", + "InsertInterconnectAttachmentRequest", + "InsertInterconnectRequest", + "InsertLicenseRequest", + "InsertNetworkEndpointGroupRequest", + "InsertNetworkRequest", + "InsertNodeGroupRequest", + "InsertNodeTemplateRequest", + "InsertPacketMirroringRequest", + "InsertPublicAdvertisedPrefixeRequest", + "InsertPublicDelegatedPrefixeRequest", + "InsertRegionAutoscalerRequest", + "InsertRegionBackendServiceRequest", + "InsertRegionCommitmentRequest", + "InsertRegionDiskRequest", + "InsertRegionHealthCheckRequest", + "InsertRegionHealthCheckServiceRequest", + "InsertRegionInstanceGroupManagerRequest", + "InsertRegionNetworkEndpointGroupRequest", + "InsertRegionNotificationEndpointRequest", + "InsertRegionSslCertificateRequest", + "InsertRegionTargetHttpProxyRequest", + "InsertRegionTargetHttpsProxyRequest", + "InsertRegionUrlMapRequest", + "InsertReservationRequest", + "InsertResourcePolicyRequest", + "InsertRouteRequest", + "InsertRouterRequest", + "InsertSecurityPolicyRequest", + "InsertServiceAttachmentRequest", + "InsertSslCertificateRequest", + "InsertSslPolicyRequest", + "InsertSubnetworkRequest", + "InsertTargetGrpcProxyRequest", + "InsertTargetHttpProxyRequest", + "InsertTargetHttpsProxyRequest", + "InsertTargetInstanceRequest", + "InsertTargetPoolRequest", + "InsertTargetSslProxyRequest", + "InsertTargetTcpProxyRequest", + "InsertTargetVpnGatewayRequest", + "InsertUrlMapRequest", + "InsertVpnGatewayRequest", + "InsertVpnTunnelRequest", "Instance", - "InstancesScopedList", "InstanceAggregatedList", - "NamedPort", "InstanceGroup", - "InstanceGroupsScopedList", "InstanceGroupAggregatedList", "InstanceGroupList", - "InstanceGroupManagerAutoHealingPolicy", - "InstanceGroupManagerActionsSummary", - "StatefulPolicy", - "InstanceGroupManagerStatus", - "InstanceGroupManagerUpdatePolicy", - "InstanceGroupManagerVersion", "InstanceGroupManager", - "InstanceGroupManagersScopedList", + "InstanceGroupManagerActionsSummary", "InstanceGroupManagerAggregatedList", + "InstanceGroupManagerAutoHealingPolicy", "InstanceGroupManagerList", + "InstanceGroupManagerStatus", "InstanceGroupManagerStatusStateful", - "InstanceGroupManagerStatusVersionTarget", "InstanceGroupManagerStatusStatefulPerInstanceConfigs", + "InstanceGroupManagerStatusVersionTarget", + "InstanceGroupManagerUpdatePolicy", + "InstanceGroupManagerVersion", "InstanceGroupManagersAbandonInstancesRequest", "InstanceGroupManagersApplyUpdatesRequest", - "PerInstanceConfig", "InstanceGroupManagersCreateInstancesRequest", "InstanceGroupManagersDeleteInstancesRequest", "InstanceGroupManagersDeletePerInstanceConfigsReq", - "InstanceManagedByIgmError", "InstanceGroupManagersListErrorsResponse", - "ManagedInstance", "InstanceGroupManagersListManagedInstancesResponse", "InstanceGroupManagersListPerInstanceConfigsResp", "InstanceGroupManagersPatchPerInstanceConfigsReq", "InstanceGroupManagersRecreateInstancesRequest", + "InstanceGroupManagersScopedList", "InstanceGroupManagersSetInstanceTemplateRequest", "InstanceGroupManagersSetTargetPoolsRequest", "InstanceGroupManagersUpdatePerInstanceConfigsReq", - "InstanceReference", "InstanceGroupsAddInstancesRequest", - "InstanceWithNamedPorts", "InstanceGroupsListInstances", "InstanceGroupsListInstancesRequest", "InstanceGroupsRemoveInstancesRequest", + "InstanceGroupsScopedList", "InstanceGroupsSetNamedPortsRequest", "InstanceList", - "Reference", "InstanceListReferrers", - "InstanceManagedByIgmErrorManagedInstanceError", + "InstanceManagedByIgmError", "InstanceManagedByIgmErrorInstanceActionDetails", - "ManagedInstanceVersion", + "InstanceManagedByIgmErrorManagedInstanceError", "InstanceMoveRequest", - "SourceInstanceParams", + "InstanceProperties", + "InstanceReference", "InstanceTemplate", "InstanceTemplateList", + "InstanceWithNamedPorts", "InstancesAddResourcePoliciesRequest", - "InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy", "InstancesGetEffectiveFirewallsResponse", + "InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy", "InstancesRemoveResourcePoliciesRequest", + "InstancesScopedList", "InstancesSetLabelsRequest", "InstancesSetMachineResourcesRequest", "InstancesSetMachineTypeRequest", "InstancesSetMinCpuPlatformRequest", "InstancesSetServiceAccountRequest", "InstancesStartWithEncryptionKeyRequest", - "InterconnectCircuitInfo", - "InterconnectOutageNotification", + "Int64RangeMatch", "Interconnect", - "InterconnectAttachmentPartnerMetadata", - "InterconnectAttachmentPrivateInfo", "InterconnectAttachment", - "InterconnectAttachmentsScopedList", "InterconnectAttachmentAggregatedList", "InterconnectAttachmentList", - "InterconnectDiagnosticsARPEntry", - "InterconnectDiagnosticsLinkStatus", + "InterconnectAttachmentPartnerMetadata", + "InterconnectAttachmentPrivateInfo", + "InterconnectAttachmentsScopedList", + "InterconnectCircuitInfo", "InterconnectDiagnostics", + "InterconnectDiagnosticsARPEntry", "InterconnectDiagnosticsLinkLACPStatus", "InterconnectDiagnosticsLinkOpticalPower", + "InterconnectDiagnosticsLinkStatus", "InterconnectList", - "InterconnectLocationRegionInfo", "InterconnectLocation", "InterconnectLocationList", + "InterconnectLocationRegionInfo", + "InterconnectOutageNotification", "InterconnectsGetDiagnosticsResponse", - "LicenseResourceRequirements", + "InvalidateCacheUrlMapRequest", + "Items", "License", - "LicenseCodeLicenseAlias", "LicenseCode", + "LicenseCodeLicenseAlias", + "LicenseResourceCommitment", + "LicenseResourceRequirements", "LicensesListResponse", - "LocalDisk", - "LocationPolicyLocation", - "LogConfigCloudAuditOptions", - "LogConfigCounterOptions", - "LogConfigDataAccessOptions", - "LogConfig", - "LogConfigCounterOptionsCustomField", - "Accelerators", - "ScratchDisks", - "MachineType", - "MachineTypesScopedList", - "MachineTypeAggregatedList", - "MachineTypeList", - "ManagedInstanceInstanceHealth", - "ManagedInstanceLastAttempt", - "PreservedState", - "Errors", - "Items", + "ListAcceleratorTypesRequest", + "ListAddressesRequest", + "ListAssociationsFirewallPolicyRequest", + "ListAutoscalersRequest", + "ListAvailableFeaturesSslPoliciesRequest", + "ListBackendBucketsRequest", + "ListBackendServicesRequest", + "ListDiskTypesRequest", + "ListDisksRequest", + "ListErrorsInstanceGroupManagersRequest", + "ListErrorsRegionInstanceGroupManagersRequest", + "ListExternalVpnGatewaysRequest", + "ListFirewallPoliciesRequest", + "ListFirewallsRequest", + "ListForwardingRulesRequest", + "ListGlobalAddressesRequest", + "ListGlobalForwardingRulesRequest", + "ListGlobalNetworkEndpointGroupsRequest", + "ListGlobalOperationsRequest", + "ListGlobalOrganizationOperationsRequest", + "ListGlobalPublicDelegatedPrefixesRequest", + "ListHealthChecksRequest", + "ListImagesRequest", + "ListInstanceGroupManagersRequest", + "ListInstanceGroupsRequest", + "ListInstanceTemplatesRequest", + "ListInstancesInstanceGroupsRequest", + "ListInstancesRegionInstanceGroupsRequest", + "ListInstancesRequest", + "ListInterconnectAttachmentsRequest", + "ListInterconnectLocationsRequest", + "ListInterconnectsRequest", + "ListLicensesRequest", + "ListMachineTypesRequest", + "ListManagedInstancesInstanceGroupManagersRequest", + "ListManagedInstancesRegionInstanceGroupManagersRequest", + "ListNetworkEndpointGroupsRequest", + "ListNetworkEndpointsGlobalNetworkEndpointGroupsRequest", + "ListNetworkEndpointsNetworkEndpointGroupsRequest", + "ListNetworksRequest", + "ListNodeGroupsRequest", + "ListNodeTemplatesRequest", + "ListNodeTypesRequest", + "ListNodesNodeGroupsRequest", + "ListPacketMirroringsRequest", + "ListPeeringRoutesNetworksRequest", + "ListPerInstanceConfigsInstanceGroupManagersRequest", + "ListPerInstanceConfigsRegionInstanceGroupManagersRequest", + "ListPreconfiguredExpressionSetsSecurityPoliciesRequest", + "ListPublicAdvertisedPrefixesRequest", + "ListPublicDelegatedPrefixesRequest", + "ListReferrersInstancesRequest", + "ListRegionAutoscalersRequest", + "ListRegionBackendServicesRequest", + "ListRegionCommitmentsRequest", + "ListRegionDiskTypesRequest", + "ListRegionDisksRequest", + "ListRegionHealthCheckServicesRequest", + "ListRegionHealthChecksRequest", + "ListRegionInstanceGroupManagersRequest", + "ListRegionInstanceGroupsRequest", + "ListRegionNetworkEndpointGroupsRequest", + "ListRegionNotificationEndpointsRequest", + "ListRegionOperationsRequest", + "ListRegionSslCertificatesRequest", + "ListRegionTargetHttpProxiesRequest", + "ListRegionTargetHttpsProxiesRequest", + "ListRegionUrlMapsRequest", + "ListRegionsRequest", + "ListReservationsRequest", + "ListResourcePoliciesRequest", + "ListRoutersRequest", + "ListRoutesRequest", + "ListSecurityPoliciesRequest", + "ListServiceAttachmentsRequest", + "ListSnapshotsRequest", + "ListSslCertificatesRequest", + "ListSslPoliciesRequest", + "ListSubnetworksRequest", + "ListTargetGrpcProxiesRequest", + "ListTargetHttpProxiesRequest", + "ListTargetHttpsProxiesRequest", + "ListTargetInstancesRequest", + "ListTargetPoolsRequest", + "ListTargetSslProxiesRequest", + "ListTargetTcpProxiesRequest", + "ListTargetVpnGatewaysRequest", + "ListUrlMapsRequest", + "ListUsableSubnetworksRequest", + "ListVpnGatewaysRequest", + "ListVpnTunnelsRequest", + "ListXpnHostsProjectsRequest", + "ListZoneOperationsRequest", + "ListZonesRequest", + "LocalDisk", + "LocationPolicy", + "LocationPolicyLocation", + "LogConfig", + "LogConfigCloudAuditOptions", + "LogConfigCounterOptions", + "LogConfigCounterOptionsCustomField", + "LogConfigDataAccessOptions", + "MachineType", + "MachineTypeAggregatedList", + "MachineTypeList", + "MachineTypesScopedList", + "ManagedInstance", + "ManagedInstanceInstanceHealth", + "ManagedInstanceLastAttempt", + "ManagedInstanceVersion", + "Metadata", + "MetadataFilter", "MetadataFilterLabelMatch", - "NetworkPeering", - "NetworkRoutingConfig", + "MoveDiskProjectRequest", + "MoveFirewallPolicyRequest", + "MoveInstanceProjectRequest", + "NamedPort", "Network", + "NetworkEndpoint", + "NetworkEndpointGroup", + "NetworkEndpointGroupAggregatedList", "NetworkEndpointGroupAppEngine", "NetworkEndpointGroupCloudFunction", "NetworkEndpointGroupCloudRun", - "NetworkEndpointGroup", - "NetworkEndpointGroupsScopedList", - "NetworkEndpointGroupAggregatedList", "NetworkEndpointGroupList", "NetworkEndpointGroupsAttachEndpointsRequest", "NetworkEndpointGroupsDetachEndpointsRequest", "NetworkEndpointGroupsListEndpointsRequest", - "NetworkEndpointWithHealthStatus", "NetworkEndpointGroupsListNetworkEndpoints", + "NetworkEndpointGroupsScopedList", + "NetworkEndpointWithHealthStatus", + "NetworkInterface", "NetworkList", + "NetworkPeering", + "NetworkRoutingConfig", "NetworksAddPeeringRequest", - "NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy", "NetworksGetEffectiveFirewallsResponse", + "NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy", "NetworksRemovePeeringRequest", "NetworksUpdatePeeringRequest", - "NodeGroupAutoscalingPolicy", - "NodeGroupMaintenanceWindow", "NodeGroup", - "NodeGroupsScopedList", "NodeGroupAggregatedList", + "NodeGroupAutoscalingPolicy", "NodeGroupList", - "ServerBinding", + "NodeGroupMaintenanceWindow", "NodeGroupNode", "NodeGroupsAddNodesRequest", "NodeGroupsDeleteNodesRequest", "NodeGroupsListNodes", + "NodeGroupsScopedList", "NodeGroupsSetNodeTemplateRequest", - "NodeTemplateNodeTypeFlexibility", "NodeTemplate", - "NodeTemplatesScopedList", "NodeTemplateAggregatedList", "NodeTemplateList", + "NodeTemplateNodeTypeFlexibility", + "NodeTemplatesScopedList", "NodeType", - "NodeTypesScopedList", "NodeTypeAggregatedList", "NodeTypeList", - "NotificationEndpointGrpcSettings", + "NodeTypesScopedList", "NotificationEndpoint", + "NotificationEndpointGrpcSettings", "NotificationEndpointList", - "Error", - "Warnings", "Operation", - "OperationsScopedList", "OperationAggregatedList", "OperationList", - "PacketMirroringForwardingRuleInfo", - "PacketMirroringFilter", - "PacketMirroringMirroredResourceInfo", - "PacketMirroringNetworkInfo", + "OperationsScopedList", + "OutlierDetection", "PacketMirroring", - "PacketMirroringsScopedList", "PacketMirroringAggregatedList", + "PacketMirroringFilter", + "PacketMirroringForwardingRuleInfo", "PacketMirroringList", + "PacketMirroringMirroredResourceInfo", "PacketMirroringMirroredResourceInfoInstanceInfo", "PacketMirroringMirroredResourceInfoSubnetInfo", - "PathRule", + "PacketMirroringNetworkInfo", + "PacketMirroringsScopedList", + "PatchAutoscalerRequest", + "PatchBackendBucketRequest", + "PatchBackendServiceRequest", + "PatchFirewallPolicyRequest", + "PatchFirewallRequest", + "PatchForwardingRuleRequest", + "PatchGlobalForwardingRuleRequest", + "PatchGlobalPublicDelegatedPrefixeRequest", + "PatchHealthCheckRequest", + "PatchImageRequest", + "PatchInstanceGroupManagerRequest", + "PatchInterconnectAttachmentRequest", + "PatchInterconnectRequest", + "PatchNetworkRequest", + "PatchNodeGroupRequest", + "PatchPacketMirroringRequest", + "PatchPerInstanceConfigsInstanceGroupManagerRequest", + "PatchPerInstanceConfigsRegionInstanceGroupManagerRequest", + "PatchPublicAdvertisedPrefixeRequest", + "PatchPublicDelegatedPrefixeRequest", + "PatchRegionAutoscalerRequest", + "PatchRegionBackendServiceRequest", + "PatchRegionHealthCheckRequest", + "PatchRegionHealthCheckServiceRequest", + "PatchRegionInstanceGroupManagerRequest", + "PatchRegionUrlMapRequest", + "PatchRouterRequest", + "PatchRuleFirewallPolicyRequest", + "PatchRuleSecurityPolicyRequest", + "PatchSecurityPolicyRequest", + "PatchServiceAttachmentRequest", + "PatchSslPolicyRequest", + "PatchSubnetworkRequest", + "PatchTargetGrpcProxyRequest", + "PatchTargetHttpProxyRequest", + "PatchTargetHttpsProxyRequest", + "PatchUrlMapRequest", "PathMatcher", - "Rule", - "WafExpressionSet", + "PathRule", + "PerInstanceConfig", + "Policy", "PreconfiguredWafSet", + "PreservedState", "PreservedStatePreservedDisk", - "Quota", - "UsageExportLocation", + "PreviewRouterRequest", "Project", - "XpnResourceId", "ProjectsDisableXpnResourceRequest", "ProjectsEnableXpnResourceRequest", "ProjectsGetXpnResources", "ProjectsListXpnHostsRequest", "ProjectsSetDefaultNetworkTierRequest", - "PublicAdvertisedPrefixPublicDelegatedPrefix", "PublicAdvertisedPrefix", "PublicAdvertisedPrefixList", - "PublicDelegatedPrefixPublicDelegatedSubPrefix", + "PublicAdvertisedPrefixPublicDelegatedPrefix", "PublicDelegatedPrefix", - "PublicDelegatedPrefixesScopedList", "PublicDelegatedPrefixAggregatedList", "PublicDelegatedPrefixList", + "PublicDelegatedPrefixPublicDelegatedSubPrefix", + "PublicDelegatedPrefixesScopedList", + "Quota", + "RawDisk", + "RecreateInstancesInstanceGroupManagerRequest", + "RecreateInstancesRegionInstanceGroupManagerRequest", + "Reference", "Region", "RegionAutoscalerList", "RegionDiskTypeList", @@ -417,102 +855,218 @@ "RegionSetLabelsRequest", "RegionSetPolicyRequest", "RegionTargetHttpsProxiesSetSslCertificatesRequest", - "UrlMap", "RegionUrlMapsValidateRequest", - "ReservationsScopedList", + "RemoveAssociationFirewallPolicyRequest", + "RemoveHealthCheckTargetPoolRequest", + "RemoveInstanceTargetPoolRequest", + "RemoveInstancesInstanceGroupRequest", + "RemovePeeringNetworkRequest", + "RemoveResourcePoliciesDiskRequest", + "RemoveResourcePoliciesInstanceRequest", + "RemoveResourcePoliciesRegionDiskRequest", + "RemoveRuleFirewallPolicyRequest", + "RemoveRuleSecurityPolicyRequest", + "RequestMirrorPolicy", + "Reservation", + "ReservationAffinity", "ReservationAggregatedList", "ReservationList", "ReservationsResizeRequest", + "ReservationsScopedList", + "ResetInstanceRequest", + "ResizeDiskRequest", + "ResizeInstanceGroupManagerRequest", + "ResizeRegionDiskRequest", + "ResizeRegionInstanceGroupManagerRequest", + "ResizeReservationRequest", + "ResourceCommitment", "ResourceGroupReference", - "ResourcePolicy", "ResourcePoliciesScopedList", - "ResourcePolicyGroupPlacementPolicy", - "ResourcePolicyInstanceSchedulePolicy", - "ResourcePolicyResourceStatus", - "ResourcePolicySnapshotSchedulePolicy", + "ResourcePolicy", "ResourcePolicyAggregatedList", "ResourcePolicyDailyCycle", + "ResourcePolicyGroupPlacementPolicy", "ResourcePolicyHourlyCycle", + "ResourcePolicyInstanceSchedulePolicy", "ResourcePolicyInstanceSchedulePolicySchedule", "ResourcePolicyList", + "ResourcePolicyResourceStatus", "ResourcePolicyResourceStatusInstanceSchedulePolicyStatus", + "ResourcePolicySnapshotSchedulePolicy", "ResourcePolicySnapshotSchedulePolicyRetentionPolicy", "ResourcePolicySnapshotSchedulePolicySchedule", "ResourcePolicySnapshotSchedulePolicySnapshotProperties", "ResourcePolicyWeeklyCycle", "ResourcePolicyWeeklyCycleDayOfWeek", "Route", + "RouteAsPath", "RouteList", - "RouterBgp", - "RouterBgpPeer", - "RouterInterface", - "RouterNat", "Router", "RouterAdvertisedIpRange", - "RoutersScopedList", "RouterAggregatedList", + "RouterBgp", + "RouterBgpPeer", + "RouterBgpPeerBfd", + "RouterInterface", "RouterList", + "RouterNat", "RouterNatLogConfig", + "RouterNatRule", + "RouterNatRuleAction", "RouterNatSubnetworkToNat", + "RouterStatus", "RouterStatusBgpPeerStatus", "RouterStatusNatStatus", - "RouterStatus", + "RouterStatusNatStatusNatRuleStatus", "RouterStatusResponse", "RoutersPreviewResponse", + "RoutersScopedList", + "Rule", + "SSLHealthCheck", + "ScalingScheduleStatus", + "Scheduling", "SchedulingNodeAffinity", + "ScratchDisks", "Screenshot", - "SecurityPoliciesWafConfig", "SecurityPoliciesListPreconfiguredExpressionSetsResponse", - "SecurityPolicyRule", + "SecurityPoliciesWafConfig", "SecurityPolicy", + "SecurityPolicyAdaptiveProtectionConfig", + "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig", + "SecurityPolicyAdvancedOptionsConfig", "SecurityPolicyList", "SecurityPolicyReference", + "SecurityPolicyRule", "SecurityPolicyRuleMatcher", "SecurityPolicyRuleMatcherConfig", + "SecuritySettings", + "SendDiagnosticInterruptInstanceRequest", + "SendDiagnosticInterruptInstanceResponse", "SerialPortOutput", - "ShieldedInstanceIdentityEntry", + "ServerBinding", + "ServiceAccount", + "ServiceAttachment", + "ServiceAttachmentAggregatedList", + "ServiceAttachmentConnectedEndpoint", + "ServiceAttachmentConsumerProjectLimit", + "ServiceAttachmentList", + "ServiceAttachmentsScopedList", + "SetBackendServiceTargetSslProxyRequest", + "SetBackendServiceTargetTcpProxyRequest", + "SetBackupTargetPoolRequest", + "SetCommonInstanceMetadataProjectRequest", + "SetDefaultNetworkTierProjectRequest", + "SetDeletionProtectionInstanceRequest", + "SetDiskAutoDeleteInstanceRequest", + "SetIamPolicyDiskRequest", + "SetIamPolicyFirewallPolicyRequest", + "SetIamPolicyImageRequest", + "SetIamPolicyInstanceRequest", + "SetIamPolicyInstanceTemplateRequest", + "SetIamPolicyLicenseRequest", + "SetIamPolicyNodeGroupRequest", + "SetIamPolicyNodeTemplateRequest", + "SetIamPolicyRegionDiskRequest", + "SetIamPolicyReservationRequest", + "SetIamPolicyResourcePolicyRequest", + "SetIamPolicyServiceAttachmentRequest", + "SetIamPolicySnapshotRequest", + "SetIamPolicySubnetworkRequest", + "SetInstanceTemplateInstanceGroupManagerRequest", + "SetInstanceTemplateRegionInstanceGroupManagerRequest", + "SetLabelsDiskRequest", + "SetLabelsExternalVpnGatewayRequest", + "SetLabelsForwardingRuleRequest", + "SetLabelsGlobalForwardingRuleRequest", + "SetLabelsImageRequest", + "SetLabelsInstanceRequest", + "SetLabelsRegionDiskRequest", + "SetLabelsSnapshotRequest", + "SetLabelsVpnGatewayRequest", + "SetMachineResourcesInstanceRequest", + "SetMachineTypeInstanceRequest", + "SetMetadataInstanceRequest", + "SetMinCpuPlatformInstanceRequest", + "SetNamedPortsInstanceGroupRequest", + "SetNamedPortsRegionInstanceGroupRequest", + "SetNodeTemplateNodeGroupRequest", + "SetPrivateIpGoogleAccessSubnetworkRequest", + "SetProxyHeaderTargetSslProxyRequest", + "SetProxyHeaderTargetTcpProxyRequest", + "SetQuicOverrideTargetHttpsProxyRequest", + "SetSchedulingInstanceRequest", + "SetSecurityPolicyBackendServiceRequest", + "SetServiceAccountInstanceRequest", + "SetShieldedInstanceIntegrityPolicyInstanceRequest", + "SetSslCertificatesRegionTargetHttpsProxyRequest", + "SetSslCertificatesTargetHttpsProxyRequest", + "SetSslCertificatesTargetSslProxyRequest", + "SetSslPolicyTargetHttpsProxyRequest", + "SetSslPolicyTargetSslProxyRequest", + "SetTagsInstanceRequest", + "SetTargetForwardingRuleRequest", + "SetTargetGlobalForwardingRuleRequest", + "SetTargetPoolsInstanceGroupManagerRequest", + "SetTargetPoolsRegionInstanceGroupManagerRequest", + "SetUrlMapRegionTargetHttpProxyRequest", + "SetUrlMapRegionTargetHttpsProxyRequest", + "SetUrlMapTargetHttpProxyRequest", + "SetUrlMapTargetHttpsProxyRequest", + "SetUsageExportBucketProjectRequest", + "ShieldedInstanceConfig", "ShieldedInstanceIdentity", + "ShieldedInstanceIdentityEntry", + "ShieldedInstanceIntegrityPolicy", "SignedUrlKey", + "SimulateMaintenanceEventInstanceRequest", "Snapshot", "SnapshotList", - "SslCertificateManagedSslCertificate", - "SslCertificateSelfManagedSslCertificate", + "SourceInstanceParams", "SslCertificate", - "SslCertificatesScopedList", "SslCertificateAggregatedList", "SslCertificateList", - "SslPolicy", + "SslCertificateManagedSslCertificate", + "SslCertificateSelfManagedSslCertificate", + "SslCertificatesScopedList", "SslPoliciesList", "SslPoliciesListAvailableFeaturesResponse", + "SslPolicy", "SslPolicyReference", + "StartInstanceRequest", + "StartWithEncryptionKeyInstanceRequest", + "StatefulPolicy", "StatefulPolicyPreservedState", "StatefulPolicyPreservedStateDiskDevice", - "SubnetworkLogConfig", - "SubnetworkSecondaryRange", + "StopInstanceRequest", "Subnetwork", - "SubnetworksScopedList", "SubnetworkAggregatedList", "SubnetworkList", + "SubnetworkLogConfig", + "SubnetworkSecondaryRange", "SubnetworksExpandIpCidrRangeRequest", + "SubnetworksScopedList", "SubnetworksSetPrivateIpGoogleAccessRequest", + "Subsetting", + "SwitchToCustomModeNetworkRequest", + "TCPHealthCheck", + "Tags", "TargetGrpcProxy", "TargetGrpcProxyList", - "TargetHttpProxy", "TargetHttpProxiesScopedList", + "TargetHttpProxy", "TargetHttpProxyAggregatedList", "TargetHttpProxyList", - "TargetHttpsProxy", "TargetHttpsProxiesScopedList", "TargetHttpsProxiesSetQuicOverrideRequest", "TargetHttpsProxiesSetSslCertificatesRequest", + "TargetHttpsProxy", "TargetHttpsProxyAggregatedList", "TargetHttpsProxyList", "TargetInstance", - "TargetInstancesScopedList", "TargetInstanceAggregatedList", "TargetInstanceList", + "TargetInstancesScopedList", "TargetPool", - "TargetPoolsScopedList", "TargetPoolAggregatedList", "TargetPoolInstanceHealth", "TargetPoolList", @@ -520,6 +1074,7 @@ "TargetPoolsAddInstanceRequest", "TargetPoolsRemoveHealthCheckRequest", "TargetPoolsRemoveInstanceRequest", + "TargetPoolsScopedList", "TargetReference", "TargetSslProxiesSetBackendServiceRequest", "TargetSslProxiesSetProxyHeaderRequest", @@ -531,2392 +1086,1226 @@ "TargetTcpProxy", "TargetTcpProxyList", "TargetVpnGateway", - "TargetVpnGatewaysScopedList", "TargetVpnGatewayAggregatedList", "TargetVpnGatewayList", - "UrlMapTestHeader", + "TargetVpnGatewaysScopedList", "TestFailure", + "TestIamPermissionsDiskRequest", + "TestIamPermissionsExternalVpnGatewayRequest", + "TestIamPermissionsFirewallPolicyRequest", + "TestIamPermissionsImageRequest", + "TestIamPermissionsInstanceRequest", + "TestIamPermissionsInstanceTemplateRequest", + "TestIamPermissionsLicenseCodeRequest", + "TestIamPermissionsLicenseRequest", + "TestIamPermissionsNetworkEndpointGroupRequest", + "TestIamPermissionsNodeGroupRequest", + "TestIamPermissionsNodeTemplateRequest", + "TestIamPermissionsPacketMirroringRequest", + "TestIamPermissionsRegionDiskRequest", + "TestIamPermissionsReservationRequest", + "TestIamPermissionsResourcePolicyRequest", + "TestIamPermissionsServiceAttachmentRequest", + "TestIamPermissionsSnapshotRequest", + "TestIamPermissionsSubnetworkRequest", + "TestIamPermissionsVpnGatewayRequest", "TestPermissionsRequest", "TestPermissionsResponse", - "UrlMapTest", + "Uint128", + "UpdateAccessConfigInstanceRequest", + "UpdateAutoscalerRequest", + "UpdateBackendBucketRequest", + "UpdateBackendServiceRequest", + "UpdateDisplayDeviceInstanceRequest", + "UpdateFirewallRequest", + "UpdateHealthCheckRequest", + "UpdateInstanceRequest", + "UpdateNetworkInterfaceInstanceRequest", + "UpdatePeeringNetworkRequest", + "UpdatePerInstanceConfigsInstanceGroupManagerRequest", + "UpdatePerInstanceConfigsRegionInstanceGroupManagerRequest", + "UpdateRegionAutoscalerRequest", + "UpdateRegionBackendServiceRequest", + "UpdateRegionHealthCheckRequest", + "UpdateRegionUrlMapRequest", + "UpdateRouterRequest", + "UpdateShieldedInstanceConfigInstanceRequest", + "UpdateUrlMapRequest", + "UrlMap", "UrlMapList", "UrlMapReference", + "UrlMapTest", + "UrlMapTestHeader", "UrlMapValidationResult", - "UrlMapsScopedList", "UrlMapsAggregatedList", + "UrlMapsScopedList", "UrlMapsValidateRequest", "UrlMapsValidateResponse", - "UsableSubnetworkSecondaryRange", + "UrlRewrite", "UsableSubnetwork", + "UsableSubnetworkSecondaryRange", "UsableSubnetworksAggregatedList", - "VmEndpointNatMappingsInterfaceNatMappings", + "UsageExportLocation", + "ValidateRegionUrlMapRequest", + "ValidateUrlMapRequest", "VmEndpointNatMappings", + "VmEndpointNatMappingsInterfaceNatMappings", "VmEndpointNatMappingsList", - "VpnGatewayVpnGatewayInterface", "VpnGateway", - "VpnGatewaysScopedList", "VpnGatewayAggregatedList", "VpnGatewayList", - "VpnGatewayStatusVpnConnection", "VpnGatewayStatus", "VpnGatewayStatusHighAvailabilityRequirementState", "VpnGatewayStatusTunnel", + "VpnGatewayStatusVpnConnection", + "VpnGatewayVpnGatewayInterface", "VpnGatewaysGetStatusResponse", + "VpnGatewaysScopedList", "VpnTunnel", - "VpnTunnelsScopedList", "VpnTunnelAggregatedList", "VpnTunnelList", + "VpnTunnelsScopedList", + "WafExpressionSet", "WafExpressionSetExpression", + "WaitGlobalOperationRequest", + "WaitRegionOperationRequest", + "WaitZoneOperationRequest", + "Warning", + "Warnings", + "WeightedBackendService", "XpnHostList", + "XpnResourceId", "Zone", "ZoneList", "ZoneSetLabelsRequest", "ZoneSetPolicyRequest", - "AggregatedListAcceleratorTypesRequest", - "GetAcceleratorTypeRequest", - "ListAcceleratorTypesRequest", - "AggregatedListAddressesRequest", - "DeleteAddressRequest", - "GetAddressRequest", - "InsertAddressRequest", - "ListAddressesRequest", - "AggregatedListAutoscalersRequest", - "DeleteAutoscalerRequest", - "GetAutoscalerRequest", - "InsertAutoscalerRequest", - "ListAutoscalersRequest", - "PatchAutoscalerRequest", - "UpdateAutoscalerRequest", - "AddSignedUrlKeyBackendBucketRequest", - "DeleteBackendBucketRequest", - "DeleteSignedUrlKeyBackendBucketRequest", - "GetBackendBucketRequest", - "InsertBackendBucketRequest", - "ListBackendBucketsRequest", - "PatchBackendBucketRequest", - "UpdateBackendBucketRequest", - "AddSignedUrlKeyBackendServiceRequest", - "AggregatedListBackendServicesRequest", - "DeleteBackendServiceRequest", - "DeleteSignedUrlKeyBackendServiceRequest", - "GetBackendServiceRequest", - "GetHealthBackendServiceRequest", - "InsertBackendServiceRequest", - "ListBackendServicesRequest", - "PatchBackendServiceRequest", - "SetSecurityPolicyBackendServiceRequest", - "UpdateBackendServiceRequest", - "AggregatedListDiskTypesRequest", - "GetDiskTypeRequest", - "ListDiskTypesRequest", - "AddResourcePoliciesDiskRequest", - "AggregatedListDisksRequest", - "CreateSnapshotDiskRequest", - "DeleteDiskRequest", - "GetDiskRequest", - "GetIamPolicyDiskRequest", - "InsertDiskRequest", - "ListDisksRequest", - "RemoveResourcePoliciesDiskRequest", - "ResizeDiskRequest", - "SetIamPolicyDiskRequest", - "SetLabelsDiskRequest", - "TestIamPermissionsDiskRequest", - "DeleteExternalVpnGatewayRequest", - "GetExternalVpnGatewayRequest", - "InsertExternalVpnGatewayRequest", - "ListExternalVpnGatewaysRequest", - "SetLabelsExternalVpnGatewayRequest", - "TestIamPermissionsExternalVpnGatewayRequest", - "AddAssociationFirewallPolicyRequest", - "AddRuleFirewallPolicyRequest", - "CloneRulesFirewallPolicyRequest", - "DeleteFirewallPolicyRequest", - "GetFirewallPolicyRequest", - "GetAssociationFirewallPolicyRequest", - "GetIamPolicyFirewallPolicyRequest", - "GetRuleFirewallPolicyRequest", - "InsertFirewallPolicyRequest", - "ListFirewallPoliciesRequest", - "ListAssociationsFirewallPolicyRequest", - "MoveFirewallPolicyRequest", - "PatchFirewallPolicyRequest", - "PatchRuleFirewallPolicyRequest", - "RemoveAssociationFirewallPolicyRequest", - "RemoveRuleFirewallPolicyRequest", - "SetIamPolicyFirewallPolicyRequest", - "TestIamPermissionsFirewallPolicyRequest", - "DeleteFirewallRequest", - "GetFirewallRequest", - "InsertFirewallRequest", - "ListFirewallsRequest", - "PatchFirewallRequest", - "UpdateFirewallRequest", - "AggregatedListForwardingRulesRequest", - "DeleteForwardingRuleRequest", - "GetForwardingRuleRequest", - "InsertForwardingRuleRequest", - "ListForwardingRulesRequest", - "PatchForwardingRuleRequest", - "SetLabelsForwardingRuleRequest", - "SetTargetForwardingRuleRequest", - "DeleteGlobalAddressRequest", - "GetGlobalAddressRequest", - "InsertGlobalAddressRequest", - "ListGlobalAddressesRequest", - "DeleteGlobalForwardingRuleRequest", - "GetGlobalForwardingRuleRequest", - "InsertGlobalForwardingRuleRequest", - "ListGlobalForwardingRulesRequest", - "PatchGlobalForwardingRuleRequest", - "SetLabelsGlobalForwardingRuleRequest", - "SetTargetGlobalForwardingRuleRequest", - "AttachNetworkEndpointsGlobalNetworkEndpointGroupRequest", - "DeleteGlobalNetworkEndpointGroupRequest", - "DetachNetworkEndpointsGlobalNetworkEndpointGroupRequest", - "GetGlobalNetworkEndpointGroupRequest", - "InsertGlobalNetworkEndpointGroupRequest", - "ListGlobalNetworkEndpointGroupsRequest", - "ListNetworkEndpointsGlobalNetworkEndpointGroupsRequest", - "AggregatedListGlobalOperationsRequest", - "DeleteGlobalOperationRequest", - "DeleteGlobalOperationResponse", - "GetGlobalOperationRequest", - "ListGlobalOperationsRequest", - "WaitGlobalOperationRequest", - "DeleteGlobalOrganizationOperationRequest", - "DeleteGlobalOrganizationOperationResponse", - "GetGlobalOrganizationOperationRequest", - "ListGlobalOrganizationOperationsRequest", - "DeleteGlobalPublicDelegatedPrefixeRequest", - "GetGlobalPublicDelegatedPrefixeRequest", - "InsertGlobalPublicDelegatedPrefixeRequest", - "ListGlobalPublicDelegatedPrefixesRequest", - "PatchGlobalPublicDelegatedPrefixeRequest", - "AggregatedListHealthChecksRequest", - "DeleteHealthCheckRequest", - "GetHealthCheckRequest", - "InsertHealthCheckRequest", - "ListHealthChecksRequest", - "PatchHealthCheckRequest", - "UpdateHealthCheckRequest", - "DeleteImageRequest", - "DeprecateImageRequest", - "GetImageRequest", - "GetFromFamilyImageRequest", - "GetIamPolicyImageRequest", - "InsertImageRequest", - "ListImagesRequest", - "PatchImageRequest", - "SetIamPolicyImageRequest", - "SetLabelsImageRequest", - "TestIamPermissionsImageRequest", - "AbandonInstancesInstanceGroupManagerRequest", - "AggregatedListInstanceGroupManagersRequest", - "ApplyUpdatesToInstancesInstanceGroupManagerRequest", - "CreateInstancesInstanceGroupManagerRequest", - "DeleteInstanceGroupManagerRequest", - "DeleteInstancesInstanceGroupManagerRequest", - "DeletePerInstanceConfigsInstanceGroupManagerRequest", - "GetInstanceGroupManagerRequest", - "InsertInstanceGroupManagerRequest", - "ListInstanceGroupManagersRequest", - "ListErrorsInstanceGroupManagersRequest", - "ListManagedInstancesInstanceGroupManagersRequest", - "ListPerInstanceConfigsInstanceGroupManagersRequest", - "PatchInstanceGroupManagerRequest", - "PatchPerInstanceConfigsInstanceGroupManagerRequest", - "RecreateInstancesInstanceGroupManagerRequest", - "ResizeInstanceGroupManagerRequest", - "SetInstanceTemplateInstanceGroupManagerRequest", - "SetTargetPoolsInstanceGroupManagerRequest", - "UpdatePerInstanceConfigsInstanceGroupManagerRequest", - "AddInstancesInstanceGroupRequest", - "AggregatedListInstanceGroupsRequest", - "DeleteInstanceGroupRequest", - "GetInstanceGroupRequest", - "InsertInstanceGroupRequest", - "ListInstanceGroupsRequest", - "ListInstancesInstanceGroupsRequest", - "RemoveInstancesInstanceGroupRequest", - "SetNamedPortsInstanceGroupRequest", - "DeleteInstanceTemplateRequest", - "GetInstanceTemplateRequest", - "GetIamPolicyInstanceTemplateRequest", - "InsertInstanceTemplateRequest", - "ListInstanceTemplatesRequest", - "SetIamPolicyInstanceTemplateRequest", - "TestIamPermissionsInstanceTemplateRequest", - "AddAccessConfigInstanceRequest", - "AddResourcePoliciesInstanceRequest", - "AggregatedListInstancesRequest", - "AttachDiskInstanceRequest", - "BulkInsertInstanceRequest", - "DeleteInstanceRequest", - "DeleteAccessConfigInstanceRequest", - "DetachDiskInstanceRequest", - "GetInstanceRequest", - "GetEffectiveFirewallsInstanceRequest", - "GetGuestAttributesInstanceRequest", - "GetIamPolicyInstanceRequest", - "GetScreenshotInstanceRequest", - "GetSerialPortOutputInstanceRequest", - "GetShieldedInstanceIdentityInstanceRequest", - "InsertInstanceRequest", - "ListInstancesRequest", - "ListReferrersInstancesRequest", - "RemoveResourcePoliciesInstanceRequest", - "ResetInstanceRequest", - "SetDeletionProtectionInstanceRequest", - "SetDiskAutoDeleteInstanceRequest", - "SetIamPolicyInstanceRequest", - "SetLabelsInstanceRequest", - "SetMachineResourcesInstanceRequest", - "SetMachineTypeInstanceRequest", - "SetMetadataInstanceRequest", - "SetMinCpuPlatformInstanceRequest", - "SetSchedulingInstanceRequest", - "SetServiceAccountInstanceRequest", - "SetShieldedInstanceIntegrityPolicyInstanceRequest", - "SetTagsInstanceRequest", - "SimulateMaintenanceEventInstanceRequest", - "StartInstanceRequest", - "StartWithEncryptionKeyInstanceRequest", - "StopInstanceRequest", - "TestIamPermissionsInstanceRequest", - "UpdateInstanceRequest", - "UpdateAccessConfigInstanceRequest", - "UpdateDisplayDeviceInstanceRequest", - "UpdateNetworkInterfaceInstanceRequest", - "UpdateShieldedInstanceConfigInstanceRequest", - "AggregatedListInterconnectAttachmentsRequest", - "DeleteInterconnectAttachmentRequest", - "GetInterconnectAttachmentRequest", - "InsertInterconnectAttachmentRequest", - "ListInterconnectAttachmentsRequest", - "PatchInterconnectAttachmentRequest", - "GetInterconnectLocationRequest", - "ListInterconnectLocationsRequest", - "DeleteInterconnectRequest", - "GetInterconnectRequest", - "GetDiagnosticsInterconnectRequest", - "InsertInterconnectRequest", - "ListInterconnectsRequest", - "PatchInterconnectRequest", - "GetLicenseCodeRequest", - "TestIamPermissionsLicenseCodeRequest", - "DeleteLicenseRequest", - "GetLicenseRequest", - "GetIamPolicyLicenseRequest", - "InsertLicenseRequest", - "ListLicensesRequest", - "SetIamPolicyLicenseRequest", - "TestIamPermissionsLicenseRequest", - "AggregatedListMachineTypesRequest", - "GetMachineTypeRequest", - "ListMachineTypesRequest", - "AggregatedListNetworkEndpointGroupsRequest", - "AttachNetworkEndpointsNetworkEndpointGroupRequest", - "DeleteNetworkEndpointGroupRequest", - "DetachNetworkEndpointsNetworkEndpointGroupRequest", - "GetNetworkEndpointGroupRequest", - "InsertNetworkEndpointGroupRequest", - "ListNetworkEndpointGroupsRequest", - "ListNetworkEndpointsNetworkEndpointGroupsRequest", - "TestIamPermissionsNetworkEndpointGroupRequest", - "AddPeeringNetworkRequest", - "DeleteNetworkRequest", - "GetNetworkRequest", - "GetEffectiveFirewallsNetworkRequest", - "InsertNetworkRequest", - "ListNetworksRequest", - "ListPeeringRoutesNetworksRequest", - "PatchNetworkRequest", - "RemovePeeringNetworkRequest", - "SwitchToCustomModeNetworkRequest", - "UpdatePeeringNetworkRequest", - "AddNodesNodeGroupRequest", - "AggregatedListNodeGroupsRequest", - "DeleteNodeGroupRequest", - "DeleteNodesNodeGroupRequest", - "GetNodeGroupRequest", - "GetIamPolicyNodeGroupRequest", - "InsertNodeGroupRequest", - "ListNodeGroupsRequest", - "ListNodesNodeGroupsRequest", - "PatchNodeGroupRequest", - "SetIamPolicyNodeGroupRequest", - "SetNodeTemplateNodeGroupRequest", - "TestIamPermissionsNodeGroupRequest", - "AggregatedListNodeTemplatesRequest", - "DeleteNodeTemplateRequest", - "GetNodeTemplateRequest", - "GetIamPolicyNodeTemplateRequest", - "InsertNodeTemplateRequest", - "ListNodeTemplatesRequest", - "SetIamPolicyNodeTemplateRequest", - "TestIamPermissionsNodeTemplateRequest", - "AggregatedListNodeTypesRequest", - "GetNodeTypeRequest", - "ListNodeTypesRequest", - "AggregatedListPacketMirroringsRequest", - "DeletePacketMirroringRequest", - "GetPacketMirroringRequest", - "InsertPacketMirroringRequest", - "ListPacketMirroringsRequest", - "PatchPacketMirroringRequest", - "TestIamPermissionsPacketMirroringRequest", - "DisableXpnHostProjectRequest", - "DisableXpnResourceProjectRequest", - "EnableXpnHostProjectRequest", - "EnableXpnResourceProjectRequest", - "GetProjectRequest", - "GetXpnHostProjectRequest", - "GetXpnResourcesProjectsRequest", - "ListXpnHostsProjectsRequest", - "MoveDiskProjectRequest", - "MoveInstanceProjectRequest", - "SetCommonInstanceMetadataProjectRequest", - "SetDefaultNetworkTierProjectRequest", - "SetUsageExportBucketProjectRequest", - "DeletePublicAdvertisedPrefixeRequest", - "GetPublicAdvertisedPrefixeRequest", - "InsertPublicAdvertisedPrefixeRequest", - "ListPublicAdvertisedPrefixesRequest", - "PatchPublicAdvertisedPrefixeRequest", - "AggregatedListPublicDelegatedPrefixesRequest", - "DeletePublicDelegatedPrefixeRequest", - "GetPublicDelegatedPrefixeRequest", - "InsertPublicDelegatedPrefixeRequest", - "ListPublicDelegatedPrefixesRequest", - "PatchPublicDelegatedPrefixeRequest", - "DeleteRegionAutoscalerRequest", - "GetRegionAutoscalerRequest", - "InsertRegionAutoscalerRequest", - "ListRegionAutoscalersRequest", - "PatchRegionAutoscalerRequest", - "UpdateRegionAutoscalerRequest", - "DeleteRegionBackendServiceRequest", - "GetRegionBackendServiceRequest", - "GetHealthRegionBackendServiceRequest", - "InsertRegionBackendServiceRequest", - "ListRegionBackendServicesRequest", - "PatchRegionBackendServiceRequest", - "UpdateRegionBackendServiceRequest", - "AggregatedListRegionCommitmentsRequest", - "GetRegionCommitmentRequest", - "InsertRegionCommitmentRequest", - "ListRegionCommitmentsRequest", - "GetRegionDiskTypeRequest", - "ListRegionDiskTypesRequest", - "AddResourcePoliciesRegionDiskRequest", - "CreateSnapshotRegionDiskRequest", - "DeleteRegionDiskRequest", - "GetRegionDiskRequest", - "GetIamPolicyRegionDiskRequest", - "InsertRegionDiskRequest", - "ListRegionDisksRequest", - "RemoveResourcePoliciesRegionDiskRequest", - "ResizeRegionDiskRequest", - "SetIamPolicyRegionDiskRequest", - "SetLabelsRegionDiskRequest", - "TestIamPermissionsRegionDiskRequest", - "DeleteRegionHealthCheckServiceRequest", - "GetRegionHealthCheckServiceRequest", - "InsertRegionHealthCheckServiceRequest", - "ListRegionHealthCheckServicesRequest", - "PatchRegionHealthCheckServiceRequest", - "DeleteRegionHealthCheckRequest", - "GetRegionHealthCheckRequest", - "InsertRegionHealthCheckRequest", - "ListRegionHealthChecksRequest", - "PatchRegionHealthCheckRequest", - "UpdateRegionHealthCheckRequest", - "AbandonInstancesRegionInstanceGroupManagerRequest", - "ApplyUpdatesToInstancesRegionInstanceGroupManagerRequest", - "CreateInstancesRegionInstanceGroupManagerRequest", - "DeleteRegionInstanceGroupManagerRequest", - "DeleteInstancesRegionInstanceGroupManagerRequest", - "DeletePerInstanceConfigsRegionInstanceGroupManagerRequest", - "GetRegionInstanceGroupManagerRequest", - "InsertRegionInstanceGroupManagerRequest", - "ListRegionInstanceGroupManagersRequest", - "ListErrorsRegionInstanceGroupManagersRequest", - "ListManagedInstancesRegionInstanceGroupManagersRequest", - "ListPerInstanceConfigsRegionInstanceGroupManagersRequest", - "PatchRegionInstanceGroupManagerRequest", - "PatchPerInstanceConfigsRegionInstanceGroupManagerRequest", - "RecreateInstancesRegionInstanceGroupManagerRequest", - "ResizeRegionInstanceGroupManagerRequest", - "SetInstanceTemplateRegionInstanceGroupManagerRequest", - "SetTargetPoolsRegionInstanceGroupManagerRequest", - "UpdatePerInstanceConfigsRegionInstanceGroupManagerRequest", - "GetRegionInstanceGroupRequest", - "ListRegionInstanceGroupsRequest", - "ListInstancesRegionInstanceGroupsRequest", - "SetNamedPortsRegionInstanceGroupRequest", - "BulkInsertRegionInstanceRequest", - "DeleteRegionNetworkEndpointGroupRequest", - "GetRegionNetworkEndpointGroupRequest", - "InsertRegionNetworkEndpointGroupRequest", - "ListRegionNetworkEndpointGroupsRequest", - "DeleteRegionNotificationEndpointRequest", - "GetRegionNotificationEndpointRequest", - "InsertRegionNotificationEndpointRequest", - "ListRegionNotificationEndpointsRequest", - "DeleteRegionOperationRequest", - "DeleteRegionOperationResponse", - "GetRegionOperationRequest", - "ListRegionOperationsRequest", - "WaitRegionOperationRequest", - "DeleteRegionSslCertificateRequest", - "GetRegionSslCertificateRequest", - "InsertRegionSslCertificateRequest", - "ListRegionSslCertificatesRequest", - "DeleteRegionTargetHttpProxyRequest", - "GetRegionTargetHttpProxyRequest", - "InsertRegionTargetHttpProxyRequest", - "ListRegionTargetHttpProxiesRequest", - "SetUrlMapRegionTargetHttpProxyRequest", - "DeleteRegionTargetHttpsProxyRequest", - "GetRegionTargetHttpsProxyRequest", - "InsertRegionTargetHttpsProxyRequest", - "ListRegionTargetHttpsProxiesRequest", - "SetSslCertificatesRegionTargetHttpsProxyRequest", - "SetUrlMapRegionTargetHttpsProxyRequest", - "DeleteRegionUrlMapRequest", - "GetRegionUrlMapRequest", - "InsertRegionUrlMapRequest", - "ListRegionUrlMapsRequest", - "PatchRegionUrlMapRequest", - "UpdateRegionUrlMapRequest", - "ValidateRegionUrlMapRequest", - "GetRegionRequest", - "ListRegionsRequest", - "AggregatedListReservationsRequest", - "DeleteReservationRequest", - "GetReservationRequest", - "GetIamPolicyReservationRequest", - "InsertReservationRequest", - "ListReservationsRequest", - "ResizeReservationRequest", - "SetIamPolicyReservationRequest", - "TestIamPermissionsReservationRequest", - "AggregatedListResourcePoliciesRequest", - "DeleteResourcePolicyRequest", - "GetResourcePolicyRequest", - "GetIamPolicyResourcePolicyRequest", - "InsertResourcePolicyRequest", - "ListResourcePoliciesRequest", - "SetIamPolicyResourcePolicyRequest", - "TestIamPermissionsResourcePolicyRequest", - "AggregatedListRoutersRequest", - "DeleteRouterRequest", - "GetRouterRequest", - "GetNatMappingInfoRoutersRequest", - "GetRouterStatusRouterRequest", - "InsertRouterRequest", - "ListRoutersRequest", - "PatchRouterRequest", - "PreviewRouterRequest", - "UpdateRouterRequest", - "DeleteRouteRequest", - "GetRouteRequest", - "InsertRouteRequest", - "ListRoutesRequest", - "AddRuleSecurityPolicyRequest", - "DeleteSecurityPolicyRequest", - "GetSecurityPolicyRequest", - "GetRuleSecurityPolicyRequest", - "InsertSecurityPolicyRequest", - "ListSecurityPoliciesRequest", - "ListPreconfiguredExpressionSetsSecurityPoliciesRequest", - "PatchSecurityPolicyRequest", - "PatchRuleSecurityPolicyRequest", - "RemoveRuleSecurityPolicyRequest", - "DeleteSnapshotRequest", - "GetSnapshotRequest", - "GetIamPolicySnapshotRequest", - "ListSnapshotsRequest", - "SetIamPolicySnapshotRequest", - "SetLabelsSnapshotRequest", - "TestIamPermissionsSnapshotRequest", - "AggregatedListSslCertificatesRequest", - "DeleteSslCertificateRequest", - "GetSslCertificateRequest", - "InsertSslCertificateRequest", - "ListSslCertificatesRequest", - "DeleteSslPolicyRequest", - "GetSslPolicyRequest", - "InsertSslPolicyRequest", - "ListSslPoliciesRequest", - "ListAvailableFeaturesSslPoliciesRequest", - "PatchSslPolicyRequest", - "AggregatedListSubnetworksRequest", - "DeleteSubnetworkRequest", - "ExpandIpCidrRangeSubnetworkRequest", - "GetSubnetworkRequest", - "GetIamPolicySubnetworkRequest", - "InsertSubnetworkRequest", - "ListSubnetworksRequest", - "ListUsableSubnetworksRequest", - "PatchSubnetworkRequest", - "SetIamPolicySubnetworkRequest", - "SetPrivateIpGoogleAccessSubnetworkRequest", - "TestIamPermissionsSubnetworkRequest", - "DeleteTargetGrpcProxyRequest", - "GetTargetGrpcProxyRequest", - "InsertTargetGrpcProxyRequest", - "ListTargetGrpcProxiesRequest", - "PatchTargetGrpcProxyRequest", - "AggregatedListTargetHttpProxiesRequest", - "DeleteTargetHttpProxyRequest", - "GetTargetHttpProxyRequest", - "InsertTargetHttpProxyRequest", - "ListTargetHttpProxiesRequest", - "PatchTargetHttpProxyRequest", - "SetUrlMapTargetHttpProxyRequest", - "AggregatedListTargetHttpsProxiesRequest", - "DeleteTargetHttpsProxyRequest", - "GetTargetHttpsProxyRequest", - "InsertTargetHttpsProxyRequest", - "ListTargetHttpsProxiesRequest", - "PatchTargetHttpsProxyRequest", - "SetQuicOverrideTargetHttpsProxyRequest", - "SetSslCertificatesTargetHttpsProxyRequest", - "SetSslPolicyTargetHttpsProxyRequest", - "SetUrlMapTargetHttpsProxyRequest", - "AggregatedListTargetInstancesRequest", - "DeleteTargetInstanceRequest", - "GetTargetInstanceRequest", - "InsertTargetInstanceRequest", - "ListTargetInstancesRequest", - "AddHealthCheckTargetPoolRequest", - "AddInstanceTargetPoolRequest", - "AggregatedListTargetPoolsRequest", - "DeleteTargetPoolRequest", - "GetTargetPoolRequest", - "GetHealthTargetPoolRequest", - "InsertTargetPoolRequest", - "ListTargetPoolsRequest", - "RemoveHealthCheckTargetPoolRequest", - "RemoveInstanceTargetPoolRequest", - "SetBackupTargetPoolRequest", - "DeleteTargetSslProxyRequest", - "GetTargetSslProxyRequest", - "InsertTargetSslProxyRequest", - "ListTargetSslProxiesRequest", - "SetBackendServiceTargetSslProxyRequest", - "SetProxyHeaderTargetSslProxyRequest", - "SetSslCertificatesTargetSslProxyRequest", - "SetSslPolicyTargetSslProxyRequest", - "DeleteTargetTcpProxyRequest", - "GetTargetTcpProxyRequest", - "InsertTargetTcpProxyRequest", - "ListTargetTcpProxiesRequest", - "SetBackendServiceTargetTcpProxyRequest", - "SetProxyHeaderTargetTcpProxyRequest", - "AggregatedListTargetVpnGatewaysRequest", - "DeleteTargetVpnGatewayRequest", - "GetTargetVpnGatewayRequest", - "InsertTargetVpnGatewayRequest", - "ListTargetVpnGatewaysRequest", - "AggregatedListUrlMapsRequest", - "DeleteUrlMapRequest", - "GetUrlMapRequest", - "InsertUrlMapRequest", - "InvalidateCacheUrlMapRequest", - "ListUrlMapsRequest", - "PatchUrlMapRequest", - "UpdateUrlMapRequest", - "ValidateUrlMapRequest", - "AggregatedListVpnGatewaysRequest", - "DeleteVpnGatewayRequest", - "GetVpnGatewayRequest", - "GetStatusVpnGatewayRequest", - "InsertVpnGatewayRequest", - "ListVpnGatewaysRequest", - "SetLabelsVpnGatewayRequest", - "TestIamPermissionsVpnGatewayRequest", - "AggregatedListVpnTunnelsRequest", - "DeleteVpnTunnelRequest", - "GetVpnTunnelRequest", - "InsertVpnTunnelRequest", - "ListVpnTunnelsRequest", - "DeleteZoneOperationRequest", - "DeleteZoneOperationResponse", - "GetZoneOperationRequest", - "ListZoneOperationsRequest", - "WaitZoneOperationRequest", - "GetZoneRequest", - "ListZonesRequest", }, ) -class AcceleratorConfig(proto.Message): +class AbandonInstancesInstanceGroupManagerRequest(proto.Message): r"""Messages - A specification of the type and number of accelerator cards - attached to the instance. - - Attributes: - accelerator_count (int): - The number of the guest accelerator cards - exposed to this instance. - accelerator_type (str): - Full or partial URL of the accelerator type - resource to attach to this instance. For - example: projects/my-project/zones/us- - central1-c/acceleratorTypes/nvidia-tesla-p100 If - you are creating an instance template, specify - only the accelerator name. See GPUs on Compute - Engine for a full list of accelerator types. - """ - - accelerator_count = proto.Field(proto.INT32, number=504879675, optional=True,) - accelerator_type = proto.Field(proto.STRING, number=138031246, optional=True,) - - -class DeprecationStatus(proto.Message): - r"""Deprecation status for a public resource. - Attributes: - deleted (str): - An optional RFC3339 timestamp on or after - which the state of this resource is intended to - change to DELETED. This is only informational - and the status will not change unless the client - explicitly changes it. - deprecated (str): - An optional RFC3339 timestamp on or after - which the state of this resource is intended to - change to DEPRECATED. This is only informational - and the status will not change unless the client - explicitly changes it. - obsolete (str): - An optional RFC3339 timestamp on or after - which the state of this resource is intended to - change to OBSOLETE. This is only informational - and the status will not change unless the client - explicitly changes it. - replacement (str): - The URL of the suggested replacement for a - deprecated resource. The suggested replacement - resource must be the same kind of resource as - the deprecated resource. - state (google.cloud.compute_v1.types.DeprecationStatus.State): - The deprecation state of this resource. This - can be ACTIVE, DEPRECATED, OBSOLETE, or DELETED. - Operations which communicate the end of life - date for an image, can use ACTIVE. Operations - which create a new resource using a DEPRECATED - resource will return successfully, but with a - warning indicating the deprecated resource and - recommending its replacement. Operations which - use OBSOLETE or DELETED resources will be - rejected and result in an error. - """ - - class State(proto.Enum): - r"""The deprecation state of this resource. This can be ACTIVE, - DEPRECATED, OBSOLETE, or DELETED. Operations which communicate - the end of life date for an image, can use ACTIVE. Operations - which create a new resource using a DEPRECATED resource will - return successfully, but with a warning indicating the - deprecated resource and recommending its replacement. Operations - which use OBSOLETE or DELETED resources will be rejected and - result in an error. - """ - UNDEFINED_STATE = 0 - ACTIVE = 314733318 - DELETED = 120962041 - DEPRECATED = 463360435 - OBSOLETE = 66532761 - - deleted = proto.Field(proto.STRING, number=476721177, optional=True,) - deprecated = proto.Field(proto.STRING, number=515138995, optional=True,) - obsolete = proto.Field(proto.STRING, number=357647769, optional=True,) - replacement = proto.Field(proto.STRING, number=430919186, optional=True,) - state = proto.Field(proto.ENUM, number=109757585, optional=True, enum=State,) - - -class AcceleratorType(proto.Message): - r"""Represents an Accelerator Type resource. - - Google Cloud Platform provides graphics processing units - (accelerators) that you can add to VM instances to improve or - accelerate performance when working with intensive workloads. For - more information, read GPUs on Compute Engine. (== resource_for - {$api_version}.acceleratorTypes ==) - - Attributes: - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - deprecated (google.cloud.compute_v1.types.DeprecationStatus): - [Output Only] The deprecation status associated with this - accelerator type. - description (str): - [Output Only] An optional textual description of the - resource. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - kind (str): - [Output Only] The type of the resource. Always - compute#acceleratorType for accelerator types. - maximum_cards_per_instance (int): - [Output Only] Maximum number of accelerator cards allowed - per instance. - name (str): - [Output Only] Name of the resource. - self_link (str): - [Output Only] Server-defined, fully qualified URL for this - resource. - zone (str): - [Output Only] The name of the zone where the accelerator - type resides, such as us-central1-a. You must specify this - field as part of the HTTP request URL. It is not settable as - a field in the request body. - """ - - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - deprecated = proto.Field( - proto.MESSAGE, number=515138995, optional=True, message="DeprecationStatus", - ) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - maximum_cards_per_instance = proto.Field( - proto.INT32, number=263814482, optional=True, - ) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - zone = proto.Field(proto.STRING, number=3744684, optional=True,) - - -class AcceleratorTypesScopedList(proto.Message): - r""" - Attributes: - accelerator_types (Sequence[google.cloud.compute_v1.types.AcceleratorType]): - [Output Only] A list of accelerator types contained in this - scope. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] An informational warning that appears when the - accelerator types list is empty. - """ - - accelerator_types = proto.RepeatedField( - proto.MESSAGE, number=520872357, message="AcceleratorType", - ) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) - - -class Data(proto.Message): - r""" - Attributes: - key (str): - [Output Only] A key that provides more detail on the warning - being returned. For example, for warnings where there are no - results in a list request for a particular zone, this key - might be scope and the key value might be the zone name. - Other examples might be a key indicating a deprecated - resource and a suggested replacement, or a warning about - invalid network settings (for example, if an instance - attempts to perform IP forwarding but is not enabled for IP - forwarding). - value (str): - [Output Only] A warning data value corresponding to the key. - """ - - key = proto.Field(proto.STRING, number=106079, optional=True,) - value = proto.Field(proto.STRING, number=111972721, optional=True,) - - -class Warning(proto.Message): - r"""[Output Only] Informational warning message. - Attributes: - code (google.cloud.compute_v1.types.Warning.Code): - [Output Only] A warning code, if applicable. For example, - Compute Engine returns NO_RESULTS_ON_PAGE if there are no - results in the response. - data (Sequence[google.cloud.compute_v1.types.Data]): - [Output Only] Metadata about this warning in key: value - format. For example: "data": [ { "key": "scope", "value": - "zones/us-east1-d" } - message (str): - [Output Only] A human-readable description of the warning - code. - """ - - class Code(proto.Enum): - r"""[Output Only] A warning code, if applicable. For example, Compute - Engine returns NO_RESULTS_ON_PAGE if there are no results in the - response. - """ - UNDEFINED_CODE = 0 - CLEANUP_FAILED = 150308440 - DEPRECATED_RESOURCE_USED = 391835586 - DEPRECATED_TYPE_USED = 346526230 - DISK_SIZE_LARGER_THAN_IMAGE_SIZE = 369442967 - EXPERIMENTAL_TYPE_USED = 451954443 - EXTERNAL_API_WARNING = 175546307 - FIELD_VALUE_OVERRIDEN = 329669423 - INJECTED_KERNELS_DEPRECATED = 417377419 - LARGE_DEPLOYMENT_WARNING = 481440678 - MISSING_TYPE_DEPENDENCY = 344505463 - NEXT_HOP_ADDRESS_NOT_ASSIGNED = 324964999 - NEXT_HOP_CANNOT_IP_FORWARD = 383382887 - NEXT_HOP_INSTANCE_NOT_FOUND = 464250446 - NEXT_HOP_INSTANCE_NOT_ON_NETWORK = 243758146 - NEXT_HOP_NOT_RUNNING = 417081265 - NOT_CRITICAL_ERROR = 105763924 - NO_RESULTS_ON_PAGE = 30036744 - PARTIAL_SUCCESS = 39966469 - REQUIRED_TOS_AGREEMENT = 3745539 - RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING = 496728641 - RESOURCE_NOT_DELETED = 168598460 - SCHEMA_VALIDATION_IGNORED = 275245642 - SINGLE_INSTANCE_PROPERTY_TEMPLATE = 268305617 - UNDECLARED_PROPERTIES = 390513439 - UNREACHABLE = 13328052 - - code = proto.Field(proto.ENUM, number=3059181, optional=True, enum=Code,) - data = proto.RepeatedField(proto.MESSAGE, number=3076010, message="Data",) - message = proto.Field(proto.STRING, number=418054151, optional=True,) - - -class AcceleratorTypeAggregatedList(proto.Message): - r""" - Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.AcceleratorTypeAggregatedList.ItemsEntry]): - A list of AcceleratorTypesScopedList - resources. - kind (str): - [Output Only] Type of resource. Always - compute#acceleratorTypeAggregatedList for aggregated lists - of accelerator types. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - unreachables (Sequence[str]): - [Output Only] Unreachable resources. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. - """ - - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.MapField( - proto.STRING, - proto.MESSAGE, - number=100526016, - message="AcceleratorTypesScopedList", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - unreachables = proto.RepeatedField(proto.STRING, number=243372063,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) - + A request message for InstanceGroupManagers.AbandonInstances. + See the method description for details. -class AcceleratorTypeList(proto.Message): - r"""Contains a list of accelerator types. Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.AcceleratorType]): - A list of AcceleratorType resources. - kind (str): - [Output Only] Type of resource. Always - compute#acceleratorTypeList for lists of accelerator types. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + instance_group_manager (str): + The name of the managed instance group. + instance_group_managers_abandon_instances_request_resource (google.cloud.compute_v1.types.InstanceGroupManagersAbandonInstancesRequest): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone where the managed + instance group is located. """ - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="AcceleratorType", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + instance_group_manager = proto.Field(proto.STRING, number=249363395,) + instance_group_managers_abandon_instances_request_resource = proto.Field( + proto.MESSAGE, + number=320929016, + message="InstanceGroupManagersAbandonInstancesRequest", ) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class AccessConfig(proto.Message): - r"""An access configuration attached to an instance's network - interface. Only one access config per instance is supported. +class AbandonInstancesRegionInstanceGroupManagerRequest(proto.Message): + r"""A request message for + RegionInstanceGroupManagers.AbandonInstances. See the method + description for details. Attributes: - kind (str): - [Output Only] Type of the resource. Always - compute#accessConfig for access configs. - name (str): - The name of this access configuration. The - default and recommended name is External NAT, - but you can use any arbitrary string, such as My - external IP or Network Access. - nat_i_p (str): - An external IP address associated with this - instance. Specify an unused static external IP - address available to the project or leave this - field undefined to use an IP from a shared - ephemeral IP address pool. If you specify a - static external IP address, it must live in the - same region as the zone of the instance. - network_tier (google.cloud.compute_v1.types.AccessConfig.NetworkTier): - This signifies the networking tier used for - configuring this access configuration and can - only take the following values: PREMIUM, - STANDARD. If an AccessConfig is specified - without a valid external IP address, an - ephemeral IP will be created with this - networkTier. - If an AccessConfig with a valid external IP - address is specified, it must match that of the - networkTier associated with the Address resource - owning that IP. - public_ptr_domain_name (str): - The DNS domain name for the public PTR record. You can set - this field only if the ``setPublicPtr`` field is enabled. - set_public_ptr (bool): - Specifies whether a public DNS 'PTR' record - should be created to map the external IP address - of the instance to a DNS domain name. - type_ (google.cloud.compute_v1.types.AccessConfig.Type): - The type of configuration. The default and only option is - ONE_TO_ONE_NAT. + instance_group_manager (str): + Name of the managed instance group. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + region_instance_group_managers_abandon_instances_request_resource (google.cloud.compute_v1.types.RegionInstanceGroupManagersAbandonInstancesRequest): + The body resource for this request + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - class NetworkTier(proto.Enum): - r"""This signifies the networking tier used for configuring this - access configuration and can only take the following values: - PREMIUM, STANDARD. If an AccessConfig is specified without a - valid external IP address, an ephemeral IP will be created with - this networkTier. - If an AccessConfig with a valid external IP address is - specified, it must match that of the networkTier associated with - the Address resource owning that IP. - """ - UNDEFINED_NETWORK_TIER = 0 - PREMIUM = 399530551 - STANDARD = 484642493 - - class Type(proto.Enum): - r"""The type of configuration. The default and only option is - ONE_TO_ONE_NAT. - """ - UNDEFINED_TYPE = 0 - ONE_TO_ONE_NAT = 84090205 - - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - nat_i_p = proto.Field(proto.STRING, number=117634556, optional=True,) - network_tier = proto.Field( - proto.ENUM, number=517397843, optional=True, enum=NetworkTier, + instance_group_manager = proto.Field(proto.STRING, number=249363395,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + region_instance_group_managers_abandon_instances_request_resource = proto.Field( + proto.MESSAGE, + number=488499491, + message="RegionInstanceGroupManagersAbandonInstancesRequest", ) - public_ptr_domain_name = proto.Field(proto.STRING, number=316599167, optional=True,) - set_public_ptr = proto.Field(proto.BOOL, number=523870229, optional=True,) - type_ = proto.Field(proto.ENUM, number=3575610, optional=True, enum=Type,) - - -class Address(proto.Message): - r"""Use global external addresses for GFE-based external HTTP(S) load - balancers in Premium Tier. - - Use global internal addresses for reserved peering network range. + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - Use regional external addresses for the following resources: - - External IP addresses for VM instances - Regional external - forwarding rules - Cloud NAT external IP addresses - GFE based - LBs in Standard Tier - Network LBs in Premium or Standard Tier - - Cloud VPN gateways (both Classic and HA) +class AcceleratorConfig(proto.Message): + r"""A specification of the type and number of accelerator cards + attached to the instance. - Use regional internal IP addresses for subnet IP ranges (primary and - secondary). This includes: + Attributes: + accelerator_count (int): + The number of the guest accelerator cards + exposed to this instance. + accelerator_type (str): + Full or partial URL of the accelerator type + resource to attach to this instance. For + example: projects/my-project/zones/us- + central1-c/acceleratorTypes/nvidia-tesla-p100 If + you are creating an instance template, specify + only the accelerator name. See GPUs on Compute + Engine for a full list of accelerator types. + """ - - Internal IP addresses for VM instances - Alias IP ranges of VM - instances (/32 only) - Regional internal forwarding rules - - Internal TCP/UDP load balancer addresses - Internal HTTP(S) load - balancer addresses - Cloud DNS inbound forwarding IP addresses + accelerator_count = proto.Field(proto.INT32, number=504879675, optional=True,) + accelerator_type = proto.Field(proto.STRING, number=138031246, optional=True,) - For more information, read reserved IP address. - (== resource_for {$api_version}.addresses ==) (== resource_for - {$api_version}.globalAddresses ==) +class AcceleratorType(proto.Message): + r"""Represents an Accelerator Type resource. Google Cloud + Platform provides graphics processing units (accelerators) that + you can add to VM instances to improve or accelerate performance + when working with intensive workloads. For more information, + read GPUs on Compute Engine. Attributes: - address (str): - The static IP address represented by this - resource. - address_type (google.cloud.compute_v1.types.Address.AddressType): - The type of address to reserve, either - INTERNAL or EXTERNAL. If unspecified, defaults - to EXTERNAL. creation_timestamp (str): [Output Only] Creation timestamp in RFC3339 text format. + deprecated (google.cloud.compute_v1.types.DeprecationStatus): + [Output Only] The deprecation status associated with this + accelerator type. description (str): - An optional description of this resource. - Provide this field when you create the resource. + [Output Only] An optional textual description of the + resource. id (int): [Output Only] The unique identifier for the resource. This identifier is defined by the server. - ip_version (google.cloud.compute_v1.types.Address.IpVersion): - The IP version that will be used by this - address. Valid options are IPV4 or IPV6. This - can only be specified for a global address. kind (str): - [Output Only] Type of the resource. Always compute#address - for addresses. + [Output Only] The type of the resource. Always + compute#acceleratorType for accelerator types. + maximum_cards_per_instance (int): + [Output Only] Maximum number of accelerator cards allowed + per instance. name (str): - Name of the resource. Provided by the client when the - resource is created. The name must be 1-63 characters long, - and comply with RFC1035. Specifically, the name must be 1-63 - characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?``. The first character must be - a lowercase letter, and all following characters (except for - the last character) must be a dash, lowercase letter, or - digit. The last character must be a lowercase letter or - digit. - network (str): - The URL of the network in which to reserve the address. This - field can only be used with INTERNAL type with the - VPC_PEERING purpose. - network_tier (google.cloud.compute_v1.types.Address.NetworkTier): - This signifies the networking tier used for - configuring this address and can only take the - following values: PREMIUM or STANDARD. Global - forwarding rules can only be Premium Tier. - Regional forwarding rules can be either Premium - or Standard Tier. Standard Tier addresses - applied to regional forwarding rules can be used - with any external load balancer. Regional - forwarding rules in Premium Tier can only be - used with a network load balancer. If this - field is not specified, it is assumed to be - PREMIUM. - prefix_length (int): - The prefix length if the resource represents - an IP range. - purpose (google.cloud.compute_v1.types.Address.Purpose): - The purpose of this resource, which can be one of the - following values: - - - ``GCE_ENDPOINT`` for addresses that are used by VM - instances, alias IP ranges, internal load balancers, and - similar resources. - - ``DNS_RESOLVER`` for a DNS resolver address in a - subnetwork - - ``VPC_PEERING`` for addresses that are reserved for VPC - peer networks. - - ``NAT_AUTO`` for addresses that are external IP addresses - automatically reserved for Cloud NAT. - - ``IPSEC_INTERCONNECT`` for addresses created from a - private IP range that are reserved for a VLAN attachment - in an IPsec-encrypted Cloud Interconnect configuration. - These addresses are regional resources. - region (str): - [Output Only] The URL of the region where a regional address - resides. For regional addresses, you must specify the region - as a path parameter in the HTTP request URL. This field is - not applicable to global addresses. - self_link (str): - [Output Only] Server-defined URL for the resource. - status (google.cloud.compute_v1.types.Address.Status): - [Output Only] The status of the address, which can be one of - RESERVING, RESERVED, or IN_USE. An address that is RESERVING - is currently in the process of being reserved. A RESERVED - address is currently reserved and available to use. An - IN_USE address is currently being used by another resource - and is not available. - subnetwork (str): - The URL of the subnetwork in which to reserve the address. - If an IP address is specified, it must be within the - subnetwork's IP range. This field can only be used with - INTERNAL type with a GCE_ENDPOINT or DNS_RESOLVER purpose. - users (Sequence[str]): - [Output Only] The URLs of the resources that are using this - address. - """ - - class AddressType(proto.Enum): - r"""The type of address to reserve, either INTERNAL or EXTERNAL. - If unspecified, defaults to EXTERNAL. - """ - UNDEFINED_ADDRESS_TYPE = 0 - EXTERNAL = 35607499 - INTERNAL = 279295677 - UNSPECIFIED_TYPE = 53933922 - - class IpVersion(proto.Enum): - r"""The IP version that will be used by this address. Valid - options are IPV4 or IPV6. This can only be specified for a - global address. - """ - UNDEFINED_IP_VERSION = 0 - IPV4 = 2254341 - IPV6 = 2254343 - UNSPECIFIED_VERSION = 21850000 - - class NetworkTier(proto.Enum): - r"""This signifies the networking tier used for configuring this - address and can only take the following values: PREMIUM or - STANDARD. Global forwarding rules can only be Premium Tier. - Regional forwarding rules can be either Premium or Standard - Tier. Standard Tier addresses applied to regional forwarding - rules can be used with any external load balancer. Regional - forwarding rules in Premium Tier can only be used with a network - load balancer. If this field is not specified, it is assumed to - be PREMIUM. - """ - UNDEFINED_NETWORK_TIER = 0 - PREMIUM = 399530551 - STANDARD = 484642493 - - class Purpose(proto.Enum): - r"""The purpose of this resource, which can be one of the following - values: - - - ``GCE_ENDPOINT`` for addresses that are used by VM instances, - alias IP ranges, internal load balancers, and similar resources. - - ``DNS_RESOLVER`` for a DNS resolver address in a subnetwork - - ``VPC_PEERING`` for addresses that are reserved for VPC peer - networks. - - ``NAT_AUTO`` for addresses that are external IP addresses - automatically reserved for Cloud NAT. - - ``IPSEC_INTERCONNECT`` for addresses created from a private IP - range that are reserved for a VLAN attachment in an - IPsec-encrypted Cloud Interconnect configuration. These addresses - are regional resources. - """ - UNDEFINED_PURPOSE = 0 - DNS_RESOLVER = 476114556 - GCE_ENDPOINT = 230515243 - IPSEC_INTERCONNECT = 340437251 - NAT_AUTO = 163666477 - PRIVATE_SERVICE_CONNECT = 48134724 - SHARED_LOADBALANCER_VIP = 294447572 - VPC_PEERING = 400800170 - - class Status(proto.Enum): - r"""[Output Only] The status of the address, which can be one of - RESERVING, RESERVED, or IN_USE. An address that is RESERVING is - currently in the process of being reserved. A RESERVED address is - currently reserved and available to use. An IN_USE address is - currently being used by another resource and is not available. - """ - UNDEFINED_STATUS = 0 - IN_USE = 17393485 - RESERVED = 432241448 - RESERVING = 514587225 - - address = proto.Field(proto.STRING, number=462920692, optional=True,) - address_type = proto.Field( - proto.ENUM, number=264307877, optional=True, enum=AddressType, - ) - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - ip_version = proto.Field( - proto.ENUM, number=294959552, optional=True, enum=IpVersion, - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - network = proto.Field(proto.STRING, number=232872494, optional=True,) - network_tier = proto.Field( - proto.ENUM, number=517397843, optional=True, enum=NetworkTier, - ) - prefix_length = proto.Field(proto.INT32, number=453565747, optional=True,) - purpose = proto.Field(proto.ENUM, number=316407070, optional=True, enum=Purpose,) - region = proto.Field(proto.STRING, number=138946292, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) - subnetwork = proto.Field(proto.STRING, number=307827694, optional=True,) - users = proto.RepeatedField(proto.STRING, number=111578632,) - - -class AddressesScopedList(proto.Message): - r""" - Attributes: - addresses (Sequence[google.cloud.compute_v1.types.Address]): - [Output Only] A list of addresses contained in this scope. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning which replaces the list - of addresses when the list is empty. - """ - - addresses = proto.RepeatedField(proto.MESSAGE, number=337673122, message="Address",) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) - - -class AddressAggregatedList(proto.Message): - r""" - Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.AddressAggregatedList.ItemsEntry]): - A list of AddressesScopedList resources. - kind (str): - [Output Only] Type of resource. Always - compute#addressAggregatedList for aggregated lists of - addresses. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - unreachables (Sequence[str]): - [Output Only] Unreachable resources. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. - """ - - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.MapField( - proto.STRING, proto.MESSAGE, number=100526016, message="AddressesScopedList", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - unreachables = proto.RepeatedField(proto.STRING, number=243372063,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) - - -class AddressList(proto.Message): - r"""Contains a list of addresses. - Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.Address]): - A list of Address resources. - kind (str): - [Output Only] Type of resource. Always compute#addressList - for lists of addresses. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. + [Output Only] Name of the resource. self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. - """ - - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Address",) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) - - -class AdvancedMachineFeatures(proto.Message): - r"""Specifies options for controlling advanced machine features. - Options that would traditionally be configured in a BIOS belong - here. Features that require operating system support may have - corresponding entries in the GuestOsFeatures of an Image (e.g., - whether or not the OS in the Image supports nested - virtualization being enabled or disabled). - - Attributes: - enable_nested_virtualization (bool): - Whether to enable nested virtualization or - not (default is false). - threads_per_core (int): - The number of threads per physical core. To - disable simultaneous multithreading (SMT) set - this to 1. If unset, the maximum number of - threads supported per core by the underlying - processor is assumed. - """ - - enable_nested_virtualization = proto.Field( - proto.BOOL, number=16639365, optional=True, - ) - threads_per_core = proto.Field(proto.INT32, number=352611671, optional=True,) - - -class AliasIpRange(proto.Message): - r"""An alias IP range attached to an instance's network - interface. - - Attributes: - ip_cidr_range (str): - The IP alias ranges to allocate for this - interface. This IP CIDR range must belong to the - specified subnetwork and cannot contain IP - addresses reserved by system or used by other - network interfaces. This range may be a single - IP address (such as 10.2.3.4), a netmask (such - as /24) or a CIDR-formatted string (such as - 10.1.2.0/24). - subnetwork_range_name (str): - The name of a subnetwork secondary IP range - from which to allocate an IP alias range. If not - specified, the primary range of the subnetwork - is used. - """ - - ip_cidr_range = proto.Field(proto.STRING, number=98117322, optional=True,) - subnetwork_range_name = proto.Field(proto.STRING, number=387995966, optional=True,) - - -class AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk( - proto.Message -): - r""" - Attributes: - disk_size_gb (int): - Specifies the size of the disk in base-2 GB. - interface (google.cloud.compute_v1.types.AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk.Interface): - Specifies the disk interface to use for - attaching this disk, which is either SCSI or - NVME. The default is SCSI. For performance - characteristics of SCSI over NVMe, see Local SSD - performance. - """ - - class Interface(proto.Enum): - r"""Specifies the disk interface to use for attaching this disk, - which is either SCSI or NVME. The default is SCSI. For - performance characteristics of SCSI over NVMe, see Local SSD - performance. - """ - UNDEFINED_INTERFACE = 0 - NVME = 2408800 - SCSI = 2539686 - - disk_size_gb = proto.Field(proto.INT64, number=316263735, optional=True,) - interface = proto.Field( - proto.ENUM, number=502623545, optional=True, enum=Interface, - ) - - -class AllocationSpecificSKUAllocationReservedInstanceProperties(proto.Message): - r"""Properties of the SKU instances being reserved. Next ID: 9 - Attributes: - guest_accelerators (Sequence[google.cloud.compute_v1.types.AcceleratorConfig]): - Specifies accelerator type and count. - local_ssds (Sequence[google.cloud.compute_v1.types.AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk]): - Specifies amount of local ssd to reserve with - each instance. The type of disk is local-ssd. - location_hint (str): - An opaque location hint used to place the - allocation close to other resources. This field - is for use by internal tools that use the public - API. - machine_type (str): - Specifies type of machine (name only) which has fixed number - of vCPUs and fixed amount of memory. This also includes - specifying custom machine type following - custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern. - min_cpu_platform (str): - Minimum cpu platform the reservation. - """ - - guest_accelerators = proto.RepeatedField( - proto.MESSAGE, number=463595119, message="AcceleratorConfig", - ) - local_ssds = proto.RepeatedField( - proto.MESSAGE, - number=229951299, - message="AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk", - ) - location_hint = proto.Field(proto.STRING, number=350519505, optional=True,) - machine_type = proto.Field(proto.STRING, number=227711026, optional=True,) - min_cpu_platform = proto.Field(proto.STRING, number=242912759, optional=True,) - - -class AllocationSpecificSKUReservation(proto.Message): - r"""This reservation type allows to pre allocate specific - instance configuration. - - Attributes: - count (int): - Specifies the number of resources that are - allocated. - in_use_count (int): - [Output Only] Indicates how many instances are in use. - instance_properties (google.cloud.compute_v1.types.AllocationSpecificSKUAllocationReservedInstanceProperties): - The instance properties for the reservation. + [Output Only] Server-defined, fully qualified URL for this + resource. + zone (str): + [Output Only] The name of the zone where the accelerator + type resides, such as us-central1-a. You must specify this + field as part of the HTTP request URL. It is not settable as + a field in the request body. """ - count = proto.Field(proto.INT64, number=94851343, optional=True,) - in_use_count = proto.Field(proto.INT64, number=493458877, optional=True,) - instance_properties = proto.Field( - proto.MESSAGE, - number=215355165, - optional=True, - message="AllocationSpecificSKUAllocationReservedInstanceProperties", + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + deprecated = proto.Field( + proto.MESSAGE, number=515138995, optional=True, message="DeprecationStatus", + ) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + maximum_cards_per_instance = proto.Field( + proto.INT32, number=263814482, optional=True, ) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + zone = proto.Field(proto.STRING, number=3744684, optional=True,) -class CustomerEncryptionKey(proto.Message): +class AcceleratorTypeAggregatedList(proto.Message): r""" Attributes: - kms_key_name (str): - The name of the encryption key that is stored - in Google Cloud KMS. - kms_key_service_account (str): - The service account being used for the - encryption request for the given KMS key. If - absent, the Compute Engine default service - account is used. - raw_key (str): - Specifies a 256-bit customer-supplied - encryption key, encoded in RFC 4648 base64 to - either encrypt or decrypt this resource. - sha256 (str): - [Output only] The RFC 4648 base64 encoded SHA-256 hash of - the customer-supplied encryption key that protects this - resource. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.AcceleratorTypeAggregatedList.ItemsEntry]): + A list of AcceleratorTypesScopedList + resources. + kind (str): + [Output Only] Type of resource. Always + compute#acceleratorTypeAggregatedList for aggregated lists + of accelerator types. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - kms_key_name = proto.Field(proto.STRING, number=484373913, optional=True,) - kms_key_service_account = proto.Field( - proto.STRING, number=209986261, optional=True, + @property + def raw_page(self): + return self + + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.MapField( + proto.STRING, + proto.MESSAGE, + number=100526016, + message="AcceleratorTypesScopedList", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", ) - raw_key = proto.Field(proto.STRING, number=449196488, optional=True,) - sha256 = proto.Field(proto.STRING, number=170112551, optional=True,) -class GuestOsFeature(proto.Message): - r"""Guest OS features. +class AcceleratorTypeList(proto.Message): + r"""Contains a list of accelerator types. Attributes: - type_ (google.cloud.compute_v1.types.GuestOsFeature.Type): - The ID of a supported feature. Read Enabling - guest operating system features to see a list of - available options. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.AcceleratorType]): + A list of AcceleratorType resources. + kind (str): + [Output Only] Type of resource. Always + compute#acceleratorTypeList for lists of accelerator types. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - class Type(proto.Enum): - r"""The ID of a supported feature. Read Enabling guest operating - system features to see a list of available options. - """ - UNDEFINED_TYPE = 0 - FEATURE_TYPE_UNSPECIFIED = 531767259 - GVNIC = 68209305 - MULTI_IP_SUBNET = 151776719 - SECURE_BOOT = 376811194 - SEV_CAPABLE = 87083793 - UEFI_COMPATIBLE = 195865408 - VIRTIO_SCSI_MULTIQUEUE = 201597069 - WINDOWS = 456863331 - - type_ = proto.Field(proto.ENUM, number=3575610, optional=True, enum=Type,) - + @property + def raw_page(self): + return self -class AttachedDiskInitializeParams(proto.Message): - r"""[Input Only] Specifies the parameters for a new disk that will be - created alongside the new instance. Use initialization parameters to - create boot disks or local SSDs attached to the new instance. + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="AcceleratorType", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) - This property is mutually exclusive with the source property; you - can only define one or the other, but not both. +class AcceleratorTypesScopedList(proto.Message): + r""" Attributes: - description (str): - An optional description. Provide this - property when creating the disk. - disk_name (str): - Specifies the disk name. If not specified, - the default is to use the name of the instance. - If a disk with the same name already exists in - the given region, the existing disk is attached - to the new instance and the new disk is not - created. - disk_size_gb (int): - Specifies the size of the disk in base-2 GB. - The size must be at least 10 GB. If you specify - a sourceImage, which is required for boot disks, - the default size is the size of the sourceImage. - If you do not specify a sourceImage, the default - disk size is 500 GB. - disk_type (str): - Specifies the disk type to use to create the - instance. If not specified, the default is pd- - standard, specified using the full URL. For - example: - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/pd- - standard - - Other values include pd-ssd and local-ssd. If - you define this field, you can provide either - the full or partial URL. For example, the - following are valid values: - - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType - - projects/project/zones/zone/diskTypes/diskType - - zones/zone/diskTypes/diskType Note that for - InstanceTemplate, this is the name of the disk - type, not URL. - labels (Sequence[google.cloud.compute_v1.types.AttachedDiskInitializeParams.LabelsEntry]): - Labels to apply to this disk. These can be - later modified by the disks.setLabels method. - This field is only applicable for persistent - disks. - on_update_action (google.cloud.compute_v1.types.AttachedDiskInitializeParams.OnUpdateAction): - Specifies which action to take on instance - update with this disk. Default is to use the - existing disk. - provisioned_iops (int): - Indicates how many IOPS must be provisioned - for the disk. - resource_policies (Sequence[str]): - Resource policies applied to this disk for - automatic snapshot creations. Specified using - the full or partial URL. For instance template, - specify only the resource policy name. - source_image (str): - The source image to create this disk. When - creating a new instance, one of - initializeParams.sourceImage or - initializeParams.sourceSnapshot or disks.source - is required except for local SSD. To create a - disk with one of the public operating system - images, specify the image by its family name. - For example, specify family/debian-9 to use the - latest Debian 9 image: projects/debian- - cloud/global/images/family/debian-9 - - Alternatively, use a specific version of a - public operating system image: projects/debian- - cloud/global/images/debian-9-stretch-vYYYYMMDD - - To create a disk with a custom image that you - created, specify the image name in the following - format: global/images/my-custom-image - - You can also specify a custom image by its image - family, which returns the latest version of the - image in that family. Replace the image name - with family/family-name: - global/images/family/my-image-family - - If the source image is deleted later, this field - will not be set. - source_image_encryption_key (google.cloud.compute_v1.types.CustomerEncryptionKey): - The customer-supplied encryption key of the - source image. Required if the source image is - protected by a customer-supplied encryption key. - Instance templates do not store customer- - supplied encryption keys, so you cannot create - disks for instances in a managed instance group - if the source images are encrypted with your own - keys. - source_snapshot (str): - The source snapshot to create this disk. When - creating a new instance, one of - initializeParams.sourceSnapshot or - initializeParams.sourceImage or disks.source is - required except for local SSD. To create a disk - with a snapshot that you created, specify the - snapshot name in the following format: - global/snapshots/my-backup - - If the source snapshot is deleted later, this - field will not be set. - source_snapshot_encryption_key (google.cloud.compute_v1.types.CustomerEncryptionKey): - The customer-supplied encryption key of the - source snapshot. + accelerator_types (Sequence[google.cloud.compute_v1.types.AcceleratorType]): + [Output Only] A list of accelerator types contained in this + scope. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] An informational warning that appears when the + accelerator types list is empty. """ - class OnUpdateAction(proto.Enum): - r"""Specifies which action to take on instance update with this - disk. Default is to use the existing disk. - """ - UNDEFINED_ON_UPDATE_ACTION = 0 - RECREATE_DISK = 494767853 - RECREATE_DISK_IF_SOURCE_CHANGED = 398099712 - USE_EXISTING_DISK = 232682233 - - description = proto.Field(proto.STRING, number=422937596, optional=True,) - disk_name = proto.Field(proto.STRING, number=92807149, optional=True,) - disk_size_gb = proto.Field(proto.INT64, number=316263735, optional=True,) - disk_type = proto.Field(proto.STRING, number=93009052, optional=True,) - labels = proto.MapField(proto.STRING, proto.STRING, number=500195327,) - on_update_action = proto.Field( - proto.ENUM, number=202451980, optional=True, enum=OnUpdateAction, - ) - provisioned_iops = proto.Field(proto.INT64, number=186769108, optional=True,) - resource_policies = proto.RepeatedField(proto.STRING, number=22220385,) - source_image = proto.Field(proto.STRING, number=50443319, optional=True,) - source_image_encryption_key = proto.Field( - proto.MESSAGE, number=381503659, optional=True, message="CustomerEncryptionKey", + accelerator_types = proto.RepeatedField( + proto.MESSAGE, number=520872357, message="AcceleratorType", ) - source_snapshot = proto.Field(proto.STRING, number=126061928, optional=True,) - source_snapshot_encryption_key = proto.Field( - proto.MESSAGE, number=303679322, optional=True, message="CustomerEncryptionKey", + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", ) -class InitialStateConfig(proto.Message): - r"""Initial State for shielded instance, these are public keys - which are safe to store in public - +class Accelerators(proto.Message): + r""" Attributes: - dbs (Sequence[google.cloud.compute_v1.types.FileContentBuffer]): - The Key Database (db). - dbxs (Sequence[google.cloud.compute_v1.types.FileContentBuffer]): - The forbidden key database (dbx). - keks (Sequence[google.cloud.compute_v1.types.FileContentBuffer]): - The Key Exchange Key (KEK). - pk (google.cloud.compute_v1.types.FileContentBuffer): - The Platform Key (PK). + guest_accelerator_count (int): + Number of accelerator cards exposed to the + guest. + guest_accelerator_type (str): + The accelerator type resource name, not a + full URL, e.g. 'nvidia-tesla-k80'. """ - dbs = proto.RepeatedField(proto.MESSAGE, number=99253, message="FileContentBuffer",) - dbxs = proto.RepeatedField( - proto.MESSAGE, number=3077113, message="FileContentBuffer", - ) - keks = proto.RepeatedField( - proto.MESSAGE, number=3288130, message="FileContentBuffer", - ) - pk = proto.Field( - proto.MESSAGE, number=3579, optional=True, message="FileContentBuffer", - ) - + guest_accelerator_count = proto.Field(proto.INT32, number=479079316, optional=True,) + guest_accelerator_type = proto.Field(proto.STRING, number=293064725, optional=True,) -class AttachedDisk(proto.Message): - r"""An instance-attached disk resource. - Attributes: - auto_delete (bool): - Specifies whether the disk will be auto- - eleted when the instance is deleted (but not - when the disk is detached from the instance). - boot (bool): - Indicates that this is a boot disk. The - virtual machine will use the first partition of - the disk for its root filesystem. - device_name (str): - Specifies a unique device name of your choice that is - reflected into the /dev/disk/by-id/google-\* tree of a Linux - operating system running within the instance. This name can - be used to reference the device for mounting, resizing, and - so on, from within the instance. - If not specified, the server chooses a default device name - to apply to this disk, in the form persistent-disk-x, where - x is a number assigned by Google Compute Engine. This field - is only applicable for persistent disks. - disk_encryption_key (google.cloud.compute_v1.types.CustomerEncryptionKey): - Encrypts or decrypts a disk using a customer- - upplied encryption key. - If you are creating a new disk, this field - encrypts the new disk using an encryption key - that you provide. If you are attaching an - existing disk that is already encrypted, this - field decrypts the disk using the customer- - supplied encryption key. - If you encrypt a disk using a customer-supplied - key, you must provide the same key again when - you attempt to use this resource at a later - time. For example, you must provide the key when - you create a snapshot or an image from the disk - or when you attach the disk to a virtual machine - instance. - If you do not provide an encryption key, then - the disk will be encrypted using an - automatically generated key and you do not need - to provide a key to use the disk later. - Instance templates do not store customer- - supplied encryption keys, so you cannot use your - own keys to encrypt disks in a managed instance - group. - disk_size_gb (int): - The size of the disk in GB. - guest_os_features (Sequence[google.cloud.compute_v1.types.GuestOsFeature]): - A list of features to enable on the guest - operating system. Applicable only for bootable - images. Read Enabling guest operating system - features to see a list of available options. - index (int): - [Output Only] A zero-based index to this disk, where 0 is - reserved for the boot disk. If you have many disks attached - to an instance, each disk would have a unique index number. - initialize_params (google.cloud.compute_v1.types.AttachedDiskInitializeParams): - [Input Only] Specifies the parameters for a new disk that - will be created alongside the new instance. Use - initialization parameters to create boot disks or local SSDs - attached to the new instance. +class AccessConfig(proto.Message): + r"""An access configuration attached to an instance's network + interface. Only one access config per instance is supported. - This property is mutually exclusive with the source - property; you can only define one or the other, but not - both. - interface (google.cloud.compute_v1.types.AttachedDisk.Interface): - Specifies the disk interface to use for - attaching this disk, which is either SCSI or - NVME. The default is SCSI. Persistent disks must - always use SCSI and the request will fail if you - attempt to attach a persistent disk in any other - format than SCSI. Local SSDs can use either NVME - or SCSI. For performance characteristics of SCSI - over NVMe, see Local SSD performance. + Attributes: + external_ipv6 (str): + [Output Only] The first IPv6 address of the external IPv6 + range associated with this instance, prefix length is stored + in externalIpv6PrefixLength in ipv6AccessConfig. The field + is output only, an IPv6 address from a subnetwork associated + with the instance will be allocated dynamically. + external_ipv6_prefix_length (int): + [Output Only] The prefix length of the external IPv6 range. kind (str): [Output Only] Type of the resource. Always - compute#attachedDisk for attached disks. - licenses (Sequence[str]): - [Output Only] Any valid publicly visible licenses. - mode (google.cloud.compute_v1.types.AttachedDisk.Mode): - The mode in which to attach this disk, either READ_WRITE or - READ_ONLY. If not specified, the default is to attach the - disk in READ_WRITE mode. - shielded_instance_initial_state (google.cloud.compute_v1.types.InitialStateConfig): - [Output Only] shielded vm initial state stored on disk - source (str): - Specifies a valid partial or full URL to an - existing Persistent Disk resource. When creating - a new instance, one of - initializeParams.sourceImage or - initializeParams.sourceSnapshot or disks.source - is required except for local SSD. If desired, - you can also attach existing non-root persistent - disks using this property. This field is only - applicable for persistent disks. - Note that for InstanceTemplate, specify the disk - name, not the URL for the disk. - type_ (google.cloud.compute_v1.types.AttachedDisk.Type): - Specifies the type of the disk, either - SCRATCH or PERSISTENT. If not specified, the - default is PERSISTENT. + compute#accessConfig for access configs. + name (str): + The name of this access configuration. The + default and recommended name is External NAT, + but you can use any arbitrary string, such as My + external IP or Network Access. + nat_i_p (str): + An external IP address associated with this + instance. Specify an unused static external IP + address available to the project or leave this + field undefined to use an IP from a shared + ephemeral IP address pool. If you specify a + static external IP address, it must live in the + same region as the zone of the instance. + network_tier (google.cloud.compute_v1.types.AccessConfig.NetworkTier): + This signifies the networking tier used for + configuring this access configuration and can + only take the following values: PREMIUM, + STANDARD. If an AccessConfig is specified + without a valid external IP address, an + ephemeral IP will be created with this + networkTier. If an AccessConfig with a valid + external IP address is specified, it must match + that of the networkTier associated with the + Address resource owning that IP. + public_ptr_domain_name (str): + The DNS domain name for the public PTR record. You can set + this field only if the ``setPublicPtr`` field is enabled. + set_public_ptr (bool): + Specifies whether a public DNS 'PTR' record + should be created to map the external IP address + of the instance to a DNS domain name. + type_ (google.cloud.compute_v1.types.AccessConfig.Type): + The type of configuration. The default and only option is + ONE_TO_ONE_NAT. """ - class Interface(proto.Enum): - r"""Specifies the disk interface to use for attaching this disk, - which is either SCSI or NVME. The default is SCSI. Persistent - disks must always use SCSI and the request will fail if you - attempt to attach a persistent disk in any other format than - SCSI. Local SSDs can use either NVME or SCSI. For performance - characteristics of SCSI over NVMe, see Local SSD performance. - """ - UNDEFINED_INTERFACE = 0 - NVME = 2408800 - SCSI = 2539686 - - class Mode(proto.Enum): - r"""The mode in which to attach this disk, either READ_WRITE or - READ_ONLY. If not specified, the default is to attach the disk in - READ_WRITE mode. + class NetworkTier(proto.Enum): + r"""This signifies the networking tier used for configuring this + access configuration and can only take the following values: + PREMIUM, STANDARD. If an AccessConfig is specified without a + valid external IP address, an ephemeral IP will be created with + this networkTier. If an AccessConfig with a valid external IP + address is specified, it must match that of the networkTier + associated with the Address resource owning that IP. """ - UNDEFINED_MODE = 0 - READ_ONLY = 91950261 - READ_WRITE = 173607894 + UNDEFINED_NETWORK_TIER = 0 + PREMIUM = 399530551 + STANDARD = 484642493 class Type(proto.Enum): - r"""Specifies the type of the disk, either SCRATCH or PERSISTENT. - If not specified, the default is PERSISTENT. + r"""The type of configuration. The default and only option is + ONE_TO_ONE_NAT. """ UNDEFINED_TYPE = 0 - PERSISTENT = 460683927 - SCRATCH = 496778970 + DIRECT_IPV6 = 4397213 + ONE_TO_ONE_NAT = 84090205 - auto_delete = proto.Field(proto.BOOL, number=464761403, optional=True,) - boot = proto.Field(proto.BOOL, number=3029746, optional=True,) - device_name = proto.Field(proto.STRING, number=67541716, optional=True,) - disk_encryption_key = proto.Field( - proto.MESSAGE, number=271660677, optional=True, message="CustomerEncryptionKey", + external_ipv6 = proto.Field(proto.STRING, number=532703707, optional=True,) + external_ipv6_prefix_length = proto.Field( + proto.INT32, number=425672143, optional=True, ) - disk_size_gb = proto.Field(proto.INT64, number=316263735, optional=True,) - guest_os_features = proto.RepeatedField( - proto.MESSAGE, number=79294545, message="GuestOsFeature", + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + nat_i_p = proto.Field(proto.STRING, number=117634556, optional=True,) + network_tier = proto.Field( + proto.ENUM, number=517397843, optional=True, enum=NetworkTier, ) - index = proto.Field(proto.INT32, number=100346066, optional=True,) - initialize_params = proto.Field( - proto.MESSAGE, - number=17697045, - optional=True, - message="AttachedDiskInitializeParams", + public_ptr_domain_name = proto.Field(proto.STRING, number=316599167, optional=True,) + set_public_ptr = proto.Field(proto.BOOL, number=523870229, optional=True,) + type_ = proto.Field(proto.ENUM, number=3575610, optional=True, enum=Type,) + + +class AddAccessConfigInstanceRequest(proto.Message): + r"""A request message for Instances.AddAccessConfig. See the + method description for details. + + Attributes: + access_config_resource (google.cloud.compute_v1.types.AccessConfig): + The body resource for this request + instance (str): + The instance name for this request. + network_interface (str): + The name of the network interface to add to + this instance. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. + """ + + access_config_resource = proto.Field( + proto.MESSAGE, number=387825552, message="AccessConfig", ) - interface = proto.Field( - proto.ENUM, number=502623545, optional=True, enum=Interface, + instance = proto.Field(proto.STRING, number=18257045,) + network_interface = proto.Field(proto.STRING, number=365387880,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) + + +class AddAssociationFirewallPolicyRequest(proto.Message): + r"""A request message for FirewallPolicies.AddAssociation. See + the method description for details. + + Attributes: + firewall_policy (str): + Name of the firewall policy to update. + firewall_policy_association_resource (google.cloud.compute_v1.types.FirewallPolicyAssociation): + The body resource for this request + replace_existing_association (bool): + Indicates whether or not to replace it if an + association of the attachment already exists. + This is false by default, in which case an error + will be returned if an association already + exists. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + """ + + firewall_policy = proto.Field(proto.STRING, number=498173265,) + firewall_policy_association_resource = proto.Field( + proto.MESSAGE, number=259546170, message="FirewallPolicyAssociation", ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - licenses = proto.RepeatedField(proto.STRING, number=337642578,) - mode = proto.Field(proto.ENUM, number=3357091, optional=True, enum=Mode,) - shielded_instance_initial_state = proto.Field( - proto.MESSAGE, number=192356867, optional=True, message="InitialStateConfig", + replace_existing_association = proto.Field( + proto.BOOL, number=209541240, optional=True, ) - source = proto.Field(proto.STRING, number=177235995, optional=True,) - type_ = proto.Field(proto.ENUM, number=3575610, optional=True, enum=Type,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class AuditLogConfig(proto.Message): - r"""Provides the configuration for logging a type of permissions. - Example: +class AddHealthCheckTargetPoolRequest(proto.Message): + r"""A request message for TargetPools.AddHealthCheck. See the + method description for details. - { "audit_log_configs": [ { "log_type": "DATA_READ", - "exempted_members": [ "user:jose@example.com" ] }, { "log_type": - "DATA_WRITE" } ] } + Attributes: + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_pool (str): + Name of the target pool to add a health check + to. + target_pools_add_health_check_request_resource (google.cloud.compute_v1.types.TargetPoolsAddHealthCheckRequest): + The body resource for this request + """ - This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting - jose@example.com from DATA_READ logging. + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_pool = proto.Field(proto.STRING, number=62796298,) + target_pools_add_health_check_request_resource = proto.Field( + proto.MESSAGE, number=269573412, message="TargetPoolsAddHealthCheckRequest", + ) - Attributes: - exempted_members (Sequence[str]): - Specifies the identities that do not cause logging for this - type of permission. Follows the same format of - [Binding.members][]. - ignore_child_exemptions (bool): - log_type (google.cloud.compute_v1.types.AuditLogConfig.LogType): - The log type that this config enables. - """ +class AddInstanceTargetPoolRequest(proto.Message): + r"""A request message for TargetPools.AddInstance. See the method + description for details. - class LogType(proto.Enum): - r"""The log type that this config enables.""" - UNDEFINED_LOG_TYPE = 0 - ADMIN_READ = 128951462 - DATA_READ = 305224971 - DATA_WRITE = 340181738 - LOG_TYPE_UNSPECIFIED = 154527053 + Attributes: + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_pool (str): + Name of the TargetPool resource to add + instances to. + target_pools_add_instance_request_resource (google.cloud.compute_v1.types.TargetPoolsAddInstanceRequest): + The body resource for this request + """ - exempted_members = proto.RepeatedField(proto.STRING, number=232615576,) - ignore_child_exemptions = proto.Field(proto.BOOL, number=70141850, optional=True,) - log_type = proto.Field(proto.ENUM, number=403115861, optional=True, enum=LogType,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_pool = proto.Field(proto.STRING, number=62796298,) + target_pools_add_instance_request_resource = proto.Field( + proto.MESSAGE, number=428796404, message="TargetPoolsAddInstanceRequest", + ) -class AuditConfig(proto.Message): - r"""Specifies the audit configuration for a service. The configuration - determines which permission types are logged, and what identities, - if any, are exempted from logging. An AuditConfig must have one or - more AuditLogConfigs. +class AddInstancesInstanceGroupRequest(proto.Message): + r"""A request message for InstanceGroups.AddInstances. See the + method description for details. - If there are AuditConfigs for both ``allServices`` and a specific - service, the union of the two AuditConfigs is used for that service: - the log_types specified in each AuditConfig are enabled, and the - exempted_members in each AuditLogConfig are exempted. + Attributes: + instance_group (str): + The name of the instance group where you are + adding instances. + instance_groups_add_instances_request_resource (google.cloud.compute_v1.types.InstanceGroupsAddInstancesRequest): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone where the instance group + is located. + """ - Example Policy with multiple AuditConfigs: + instance_group = proto.Field(proto.STRING, number=81095253,) + instance_groups_add_instances_request_resource = proto.Field( + proto.MESSAGE, number=453713246, message="InstanceGroupsAddInstancesRequest", + ) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) - { "audit_configs": [ { "service": "allServices", - "audit_log_configs": [ { "log_type": "DATA_READ", - "exempted_members": [ "user:jose@example.com" ] }, { "log_type": - "DATA_WRITE" }, { "log_type": "ADMIN_READ" } ] }, { "service": - "sampleservice.googleapis.com", "audit_log_configs": [ { "log_type": - "DATA_READ" }, { "log_type": "DATA_WRITE", "exempted_members": [ - "user:aliya@example.com" ] } ] } ] } - For sampleservice, this policy enables DATA_READ, DATA_WRITE and - ADMIN_READ logging. It also exempts jose@example.com from DATA_READ - logging, and aliya@example.com from DATA_WRITE logging. +class AddNodesNodeGroupRequest(proto.Message): + r"""A request message for NodeGroups.AddNodes. See the method + description for details. Attributes: - audit_log_configs (Sequence[google.cloud.compute_v1.types.AuditLogConfig]): - The configuration for logging of each type of - permission. - exempted_members (Sequence[str]): - - service (str): - Specifies a service that will be enabled for audit logging. - For example, ``storage.googleapis.com``, - ``cloudsql.googleapis.com``. ``allServices`` is a special - value that covers all services. + node_group (str): + Name of the NodeGroup resource. + node_groups_add_nodes_request_resource (google.cloud.compute_v1.types.NodeGroupsAddNodesRequest): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. """ - audit_log_configs = proto.RepeatedField( - proto.MESSAGE, number=488420626, message="AuditLogConfig", + node_group = proto.Field(proto.STRING, number=469958146,) + node_groups_add_nodes_request_resource = proto.Field( + proto.MESSAGE, number=131263288, message="NodeGroupsAddNodesRequest", ) - exempted_members = proto.RepeatedField(proto.STRING, number=232615576,) - service = proto.Field(proto.STRING, number=373540533, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class AuthorizationLoggingOptions(proto.Message): - r"""Authorization-related information used by Cloud Audit - Logging. +class AddPeeringNetworkRequest(proto.Message): + r"""A request message for Networks.AddPeering. See the method + description for details. Attributes: - permission_type (google.cloud.compute_v1.types.AuthorizationLoggingOptions.PermissionType): - The type of the permission that was checked. + network (str): + Name of the network resource to add peering + to. + networks_add_peering_request_resource (google.cloud.compute_v1.types.NetworksAddPeeringRequest): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - class PermissionType(proto.Enum): - r"""The type of the permission that was checked.""" - UNDEFINED_PERMISSION_TYPE = 0 - ADMIN_READ = 128951462 - ADMIN_WRITE = 244412079 - DATA_READ = 305224971 - DATA_WRITE = 340181738 - PERMISSION_TYPE_UNSPECIFIED = 440313346 - - permission_type = proto.Field( - proto.ENUM, number=525978538, optional=True, enum=PermissionType, + network = proto.Field(proto.STRING, number=232872494,) + networks_add_peering_request_resource = proto.Field( + proto.MESSAGE, number=388810421, message="NetworksAddPeeringRequest", ) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class AutoscalingPolicy(proto.Message): - r"""Cloud Autoscaler policy. - Attributes: - cool_down_period_sec (int): - The number of seconds that the autoscaler - waits before it starts collecting information - from a new instance. This prevents the - autoscaler from collecting information when the - instance is initializing, during which the - collected usage would not be reliable. The - default time autoscaler waits is 60 seconds. - Virtual machine initialization times might vary - because of numerous factors. We recommend that - you test how long an instance may take to - initialize. To do this, create an instance and - time the startup process. - cpu_utilization (google.cloud.compute_v1.types.AutoscalingPolicyCpuUtilization): - Defines the CPU utilization policy that - allows the autoscaler to scale based on the - average CPU utilization of a managed instance - group. - custom_metric_utilizations (Sequence[google.cloud.compute_v1.types.AutoscalingPolicyCustomMetricUtilization]): - Configuration parameters of autoscaling based - on a custom metric. - load_balancing_utilization (google.cloud.compute_v1.types.AutoscalingPolicyLoadBalancingUtilization): - Configuration parameters of autoscaling based - on load balancer. - max_num_replicas (int): - The maximum number of instances that the - autoscaler can scale out to. This is required - when creating or updating an autoscaler. The - maximum number of replicas must not be lower - than minimal number of replicas. - min_num_replicas (int): - The minimum number of replicas that the - autoscaler can scale in to. This cannot be less - than 0. If not provided, autoscaler chooses a - default value depending on maximum number of - instances allowed. - mode (google.cloud.compute_v1.types.AutoscalingPolicy.Mode): - Defines operating mode for this policy. - scale_in_control (google.cloud.compute_v1.types.AutoscalingPolicyScaleInControl): +class AddResourcePoliciesDiskRequest(proto.Message): + r"""A request message for Disks.AddResourcePolicies. See the + method description for details. - scaling_schedules (Sequence[google.cloud.compute_v1.types.AutoscalingPolicy.ScalingSchedulesEntry]): - Scaling schedules defined for an autoscaler. Multiple - schedules can be set on an autoscaler, and they can overlap. - During overlapping periods the greatest - min_required_replicas of all scaling schedules is applied. - Up to 128 scaling schedules are allowed. + Attributes: + disk (str): + The disk name for this request. + disks_add_resource_policies_request_resource (google.cloud.compute_v1.types.DisksAddResourcePoliciesRequest): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. """ - class Mode(proto.Enum): - r"""Defines operating mode for this policy.""" - UNDEFINED_MODE = 0 - OFF = 78159 - ON = 2527 - ONLY_SCALE_OUT = 152713670 - ONLY_UP = 478095374 - - cool_down_period_sec = proto.Field(proto.INT32, number=107692954, optional=True,) - cpu_utilization = proto.Field( - proto.MESSAGE, - number=381211147, - optional=True, - message="AutoscalingPolicyCpuUtilization", - ) - custom_metric_utilizations = proto.RepeatedField( - proto.MESSAGE, - number=131972850, - message="AutoscalingPolicyCustomMetricUtilization", - ) - load_balancing_utilization = proto.Field( - proto.MESSAGE, - number=429746403, - optional=True, - message="AutoscalingPolicyLoadBalancingUtilization", + disk = proto.Field(proto.STRING, number=3083677,) + disks_add_resource_policies_request_resource = proto.Field( + proto.MESSAGE, number=496483363, message="DisksAddResourcePoliciesRequest", ) - max_num_replicas = proto.Field(proto.INT32, number=62327375, optional=True,) - min_num_replicas = proto.Field(proto.INT32, number=535329825, optional=True,) - mode = proto.Field(proto.ENUM, number=3357091, optional=True, enum=Mode,) - scale_in_control = proto.Field( - proto.MESSAGE, - number=527670872, - optional=True, - message="AutoscalingPolicyScaleInControl", + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) + + +class AddResourcePoliciesInstanceRequest(proto.Message): + r"""A request message for Instances.AddResourcePolicies. See the + method description for details. + + Attributes: + instance (str): + The instance name for this request. + instances_add_resource_policies_request_resource (google.cloud.compute_v1.types.InstancesAddResourcePoliciesRequest): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. + """ + + instance = proto.Field(proto.STRING, number=18257045,) + instances_add_resource_policies_request_resource = proto.Field( + proto.MESSAGE, number=489351963, message="InstancesAddResourcePoliciesRequest", ) - scaling_schedules = proto.MapField( - proto.STRING, + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) + + +class AddResourcePoliciesRegionDiskRequest(proto.Message): + r"""A request message for RegionDisks.AddResourcePolicies. See + the method description for details. + + Attributes: + disk (str): + The disk name for this request. + project (str): + Project ID for this request. + region (str): + The name of the region for this request. + region_disks_add_resource_policies_request_resource (google.cloud.compute_v1.types.RegionDisksAddResourcePoliciesRequest): + The body resource for this request + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + """ + + disk = proto.Field(proto.STRING, number=3083677,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + region_disks_add_resource_policies_request_resource = proto.Field( proto.MESSAGE, - number=355416580, - message="AutoscalingPolicyScalingSchedule", + number=284196750, + message="RegionDisksAddResourcePoliciesRequest", ) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class ScalingScheduleStatus(proto.Message): - r""" +class AddRuleFirewallPolicyRequest(proto.Message): + r"""A request message for FirewallPolicies.AddRule. See the + method description for details. + Attributes: - last_start_time (str): - [Output Only] The last time the scaling schedule became - active. Note: this is a timestamp when a schedule actually - became active, not when it was planned to do so. The - timestamp is in RFC3339 text format. - next_start_time (str): - [Output Only] The next time the scaling schedule is to - become active. Note: this is a timestamp when a schedule is - planned to run, but the actual time might be slightly - different. The timestamp is in RFC3339 text format. - state (google.cloud.compute_v1.types.ScalingScheduleStatus.State): - [Output Only] The current state of a scaling schedule. + firewall_policy (str): + Name of the firewall policy to update. + firewall_policy_rule_resource (google.cloud.compute_v1.types.FirewallPolicyRule): + The body resource for this request + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - class State(proto.Enum): - r"""[Output Only] The current state of a scaling schedule.""" - UNDEFINED_STATE = 0 - ACTIVE = 314733318 - DISABLED = 516696700 - OBSOLETE = 66532761 - READY = 77848963 + firewall_policy = proto.Field(proto.STRING, number=498173265,) + firewall_policy_rule_resource = proto.Field( + proto.MESSAGE, number=250523523, message="FirewallPolicyRule", + ) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - last_start_time = proto.Field(proto.STRING, number=34545107, optional=True,) - next_start_time = proto.Field(proto.STRING, number=97270102, optional=True,) - state = proto.Field(proto.ENUM, number=109757585, optional=True, enum=State,) +class AddRuleSecurityPolicyRequest(proto.Message): + r"""A request message for SecurityPolicies.AddRule. See the + method description for details. -class AutoscalerStatusDetails(proto.Message): - r""" Attributes: - message (str): - The status message. - type_ (google.cloud.compute_v1.types.AutoscalerStatusDetails.Type): - The type of error, warning, or notice returned. Current set - of possible values: - - - ALL_INSTANCES_UNHEALTHY (WARNING): All instances in the - instance group are unhealthy (not in RUNNING state). - - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR): There is no - backend service attached to the instance group. - - CAPPED_AT_MAX_NUM_REPLICAS (WARNING): Autoscaler - recommends a size greater than maxNumReplicas. - - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING): The - custom metric samples are not exported often enough to be - a credible base for autoscaling. - - CUSTOM_METRIC_INVALID (ERROR): The custom metric that was - specified does not exist or does not have the necessary - labels. - - MIN_EQUALS_MAX (WARNING): The minNumReplicas is equal to - maxNumReplicas. This means the autoscaler cannot add or - remove instances from the instance group. - - MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING): The - autoscaler did not receive any data from the custom - metric configured for autoscaling. - - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING): The - autoscaler is configured to scale based on a load - balancing signal but the instance group has not received - any requests from the load balancer. - - MODE_OFF (WARNING): Autoscaling is turned off. The number - of instances in the group won't change automatically. The - autoscaling configuration is preserved. - - MODE_ONLY_UP (WARNING): Autoscaling is in the "Autoscale - only out" mode. The autoscaler can add instances but not - remove any. - - MORE_THAN_ONE_BACKEND_SERVICE (ERROR): The instance group - cannot be autoscaled because it has more than one backend - service attached to it. - - NOT_ENOUGH_QUOTA_AVAILABLE (ERROR): There is insufficient - quota for the necessary resources, such as CPU or number - of instances. - - REGION_RESOURCE_STOCKOUT (ERROR): Shown only for regional - autoscalers: there is a resource stockout in the chosen - region. - - SCALING_TARGET_DOES_NOT_EXIST (ERROR): The target to be - scaled does not exist. - - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION - (ERROR): Autoscaling does not work with an HTTP/S load - balancer that has been configured for maxRate. - - ZONE_RESOURCE_STOCKOUT (ERROR): For zonal autoscalers: - there is a resource stockout in the chosen zone. For - regional autoscalers: in at least one of the zones you're - using there is a resource stockout. New values might be - added in the future. Some of the values might not be - available in all API versions. + project (str): + Project ID for this request. + security_policy (str): + Name of the security policy to update. + security_policy_rule_resource (google.cloud.compute_v1.types.SecurityPolicyRule): + The body resource for this request """ - class Type(proto.Enum): - r"""The type of error, warning, or notice returned. Current set of - possible values: - - - ALL_INSTANCES_UNHEALTHY (WARNING): All instances in the instance - group are unhealthy (not in RUNNING state). - - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR): There is no backend - service attached to the instance group. - - CAPPED_AT_MAX_NUM_REPLICAS (WARNING): Autoscaler recommends a - size greater than maxNumReplicas. - - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING): The custom metric - samples are not exported often enough to be a credible base for - autoscaling. - - CUSTOM_METRIC_INVALID (ERROR): The custom metric that was - specified does not exist or does not have the necessary labels. - - MIN_EQUALS_MAX (WARNING): The minNumReplicas is equal to - maxNumReplicas. This means the autoscaler cannot add or remove - instances from the instance group. - - MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING): The autoscaler did - not receive any data from the custom metric configured for - autoscaling. - - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING): The autoscaler is - configured to scale based on a load balancing signal but the - instance group has not received any requests from the load - balancer. - - MODE_OFF (WARNING): Autoscaling is turned off. The number of - instances in the group won't change automatically. The - autoscaling configuration is preserved. - - MODE_ONLY_UP (WARNING): Autoscaling is in the "Autoscale only - out" mode. The autoscaler can add instances but not remove any. - - MORE_THAN_ONE_BACKEND_SERVICE (ERROR): The instance group cannot - be autoscaled because it has more than one backend service - attached to it. - - NOT_ENOUGH_QUOTA_AVAILABLE (ERROR): There is insufficient quota - for the necessary resources, such as CPU or number of instances. - - REGION_RESOURCE_STOCKOUT (ERROR): Shown only for regional - autoscalers: there is a resource stockout in the chosen region. - - SCALING_TARGET_DOES_NOT_EXIST (ERROR): The target to be scaled - does not exist. - - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION (ERROR): - Autoscaling does not work with an HTTP/S load balancer that has - been configured for maxRate. - - ZONE_RESOURCE_STOCKOUT (ERROR): For zonal autoscalers: there is a - resource stockout in the chosen zone. For regional autoscalers: - in at least one of the zones you're using there is a resource - stockout. New values might be added in the future. Some of the - values might not be available in all API versions. - """ - UNDEFINED_TYPE = 0 - ALL_INSTANCES_UNHEALTHY = 404965477 - BACKEND_SERVICE_DOES_NOT_EXIST = 191417626 - CAPPED_AT_MAX_NUM_REPLICAS = 518617 - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE = 328964659 - CUSTOM_METRIC_INVALID = 204430550 - MIN_EQUALS_MAX = 2821361 - MISSING_CUSTOM_METRIC_DATA_POINTS = 94885086 - MISSING_LOAD_BALANCING_DATA_POINTS = 509858898 - MODE_OFF = 164169907 - MODE_ONLY_SCALE_OUT = 3840994 - MODE_ONLY_UP = 100969842 - MORE_THAN_ONE_BACKEND_SERVICE = 151922141 - NOT_ENOUGH_QUOTA_AVAILABLE = 403101631 - REGION_RESOURCE_STOCKOUT = 528622846 - SCALING_TARGET_DOES_NOT_EXIST = 122636699 - SCHEDULED_INSTANCES_GREATER_THAN_AUTOSCALER_MAX = 29275586 - SCHEDULED_INSTANCES_LESS_THAN_AUTOSCALER_MIN = 398287669 - UNKNOWN = 433141802 - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION = 330845009 - ZONE_RESOURCE_STOCKOUT = 210200502 + project = proto.Field(proto.STRING, number=227560217,) + security_policy = proto.Field(proto.STRING, number=171082513,) + security_policy_rule_resource = proto.Field( + proto.MESSAGE, number=402693443, message="SecurityPolicyRule", + ) - message = proto.Field(proto.STRING, number=418054151, optional=True,) - type_ = proto.Field(proto.ENUM, number=3575610, optional=True, enum=Type,) +class AddSignedUrlKeyBackendBucketRequest(proto.Message): + r"""A request message for BackendBuckets.AddSignedUrlKey. See the + method description for details. + + Attributes: + backend_bucket (str): + Name of the BackendBucket resource to which + the Signed URL Key should be added. The name + should conform to RFC1035. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + signed_url_key_resource (google.cloud.compute_v1.types.SignedUrlKey): + The body resource for this request + """ + + backend_bucket = proto.Field(proto.STRING, number=91714037,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + signed_url_key_resource = proto.Field( + proto.MESSAGE, number=457625985, message="SignedUrlKey", + ) -class Autoscaler(proto.Message): - r"""Represents an Autoscaler resource. - Google Compute Engine has two Autoscaler resources: +class AddSignedUrlKeyBackendServiceRequest(proto.Message): + r"""A request message for BackendServices.AddSignedUrlKey. See + the method description for details. - - `Zonal `__ - \* - `Regional `__ + Attributes: + backend_service (str): + Name of the BackendService resource to which + the Signed URL Key should be added. The name + should conform to RFC1035. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + signed_url_key_resource (google.cloud.compute_v1.types.SignedUrlKey): + The body resource for this request + """ - Use autoscalers to automatically add or delete instances from a - managed instance group according to your defined autoscaling policy. - For more information, read Autoscaling Groups of Instances. + backend_service = proto.Field(proto.STRING, number=306946058,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + signed_url_key_resource = proto.Field( + proto.MESSAGE, number=457625985, message="SignedUrlKey", + ) - For zonal managed instance groups resource, use the autoscaler - resource. - For regional managed instance groups, use the regionAutoscalers - resource. (== resource_for {$api_version}.autoscalers ==) (== - resource_for {$api_version}.regionAutoscalers ==) +class Address(proto.Message): + r"""Represents an IP Address resource. Google Compute Engine has two IP + Address resources: \* `Global (external and + internal) `__ + \* `Regional (external and + internal) `__ + For more information, see Reserving a static external IP address. Attributes: - autoscaling_policy (google.cloud.compute_v1.types.AutoscalingPolicy): - The configuration parameters for the - autoscaling algorithm. You can define one or - more signals for an autoscaler: cpuUtilization, - customMetricUtilizations, and - loadBalancingUtilization. If none of these are - specified, the default will be to autoscale - based on cpuUtilization to 0.6 or 60%. + address (str): + The static IP address represented by this + resource. + address_type (google.cloud.compute_v1.types.Address.AddressType): + The type of address to reserve, either + INTERNAL or EXTERNAL. If unspecified, defaults + to EXTERNAL. creation_timestamp (str): [Output Only] Creation timestamp in RFC3339 text format. description (str): An optional description of this resource. - Provide this property when you create the - resource. + Provide this field when you create the resource. id (int): [Output Only] The unique identifier for the resource. This identifier is defined by the server. + ip_version (google.cloud.compute_v1.types.Address.IpVersion): + The IP version that will be used by this + address. Valid options are IPV4 or IPV6. This + can only be specified for a global address. kind (str): - [Output Only] Type of the resource. Always - compute#autoscaler for autoscalers. + [Output Only] Type of the resource. Always compute#address + for addresses. name (str): Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. - recommended_size (int): - [Output Only] Target recommended MIG size (number of - instances) computed by autoscaler. Autoscaler calculates the - recommended MIG size even when the autoscaling policy mode - is different from ON. This field is empty when autoscaler is - not connected to an existing managed instance group or - autoscaler did not generate its prediction. + ``[a-z]([-a-z0-9]*[a-z0-9])?``. The first character must be + a lowercase letter, and all following characters (except for + the last character) must be a dash, lowercase letter, or + digit. The last character must be a lowercase letter or + digit. + network (str): + The URL of the network in which to reserve the address. This + field can only be used with INTERNAL type with the + VPC_PEERING purpose. + network_tier (google.cloud.compute_v1.types.Address.NetworkTier): + This signifies the networking tier used for + configuring this address and can only take the + following values: PREMIUM or STANDARD. Internal + IP addresses are always Premium Tier; global + external IP addresses are always Premium Tier; + regional external IP addresses can be either + Standard or Premium Tier. If this field is not + specified, it is assumed to be PREMIUM. + prefix_length (int): + The prefix length if the resource represents + an IP range. + purpose (google.cloud.compute_v1.types.Address.Purpose): + The purpose of this resource, which can be one of the + following values: - GCE_ENDPOINT for addresses that are used + by VM instances, alias IP ranges, load balancers, and + similar resources. - DNS_RESOLVER for a DNS resolver address + in a subnetwork for a Cloud DNS inbound forwarder IP + addresses (regional internal IP address in a subnet of a VPC + network) - VPC_PEERING for global internal IP addresses used + for private services access allocated ranges. - NAT_AUTO for + the regional external IP addresses used by Cloud NAT when + allocating addresses using . - IPSEC_INTERCONNECT for + addresses created from a private IP range that are reserved + for a VLAN attachment in an *IPsec-encrypted Cloud + Interconnect* configuration. These addresses are regional + resources. Not currently available publicly. - + ``SHARED_LOADBALANCER_VIP`` for an internal IP address that + is assigned to multiple internal forwarding rules. - + ``PRIVATE_SERVICE_CONNECT`` for a private network address + that is used to configure Private Service Connect. Only + global internal addresses can use this purpose. region (str): - [Output Only] URL of the region where the instance group - resides (for autoscalers living in regional scope). - scaling_schedule_status (Sequence[google.cloud.compute_v1.types.Autoscaler.ScalingScheduleStatusEntry]): - [Output Only] Status information of existing scaling - schedules. + [Output Only] The URL of the region where a regional address + resides. For regional addresses, you must specify the region + as a path parameter in the HTTP request URL. *This field is + not applicable to global addresses.* self_link (str): [Output Only] Server-defined URL for the resource. - status (google.cloud.compute_v1.types.Autoscaler.Status): - [Output Only] The status of the autoscaler configuration. - Current set of possible values: - - - PENDING: Autoscaler backend hasn't read new/updated - configuration. - - DELETING: Configuration is being deleted. - - ACTIVE: Configuration is acknowledged to be effective. - Some warnings might be present in the statusDetails - field. - - ERROR: Configuration has errors. Actionable for users. - Details are present in the statusDetails field. New - values might be added in the future. - status_details (Sequence[google.cloud.compute_v1.types.AutoscalerStatusDetails]): - [Output Only] Human-readable details about the current state - of the autoscaler. Read the documentation for Commonly - returned status messages for examples of status messages you - might encounter. - target (str): - URL of the managed instance group that this - autoscaler will scale. This field is required - when creating an autoscaler. - zone (str): - [Output Only] URL of the zone where the instance group - resides (for autoscalers living in zonal scope). + status (google.cloud.compute_v1.types.Address.Status): + [Output Only] The status of the address, which can be one of + RESERVING, RESERVED, or IN_USE. An address that is RESERVING + is currently in the process of being reserved. A RESERVED + address is currently reserved and available to use. An + IN_USE address is currently being used by another resource + and is not available. + subnetwork (str): + The URL of the subnetwork in which to reserve the address. + If an IP address is specified, it must be within the + subnetwork's IP range. This field can only be used with + INTERNAL type with a GCE_ENDPOINT or DNS_RESOLVER purpose. + users (Sequence[str]): + [Output Only] The URLs of the resources that are using this + address. """ + class AddressType(proto.Enum): + r"""The type of address to reserve, either INTERNAL or EXTERNAL. + If unspecified, defaults to EXTERNAL. + """ + UNDEFINED_ADDRESS_TYPE = 0 + EXTERNAL = 35607499 + INTERNAL = 279295677 + UNSPECIFIED_TYPE = 53933922 + + class IpVersion(proto.Enum): + r"""The IP version that will be used by this address. Valid + options are IPV4 or IPV6. This can only be specified for a + global address. + """ + UNDEFINED_IP_VERSION = 0 + IPV4 = 2254341 + IPV6 = 2254343 + UNSPECIFIED_VERSION = 21850000 + + class NetworkTier(proto.Enum): + r"""This signifies the networking tier used for configuring this + address and can only take the following values: PREMIUM or + STANDARD. Internal IP addresses are always Premium Tier; global + external IP addresses are always Premium Tier; regional external + IP addresses can be either Standard or Premium Tier. If this + field is not specified, it is assumed to be PREMIUM. + """ + UNDEFINED_NETWORK_TIER = 0 + PREMIUM = 399530551 + STANDARD = 484642493 + + class Purpose(proto.Enum): + r"""The purpose of this resource, which can be one of the following + values: - GCE_ENDPOINT for addresses that are used by VM instances, + alias IP ranges, load balancers, and similar resources. - + DNS_RESOLVER for a DNS resolver address in a subnetwork for a Cloud + DNS inbound forwarder IP addresses (regional internal IP address in + a subnet of a VPC network) - VPC_PEERING for global internal IP + addresses used for private services access allocated ranges. - + NAT_AUTO for the regional external IP addresses used by Cloud NAT + when allocating addresses using . - IPSEC_INTERCONNECT for addresses + created from a private IP range that are reserved for a VLAN + attachment in an *IPsec-encrypted Cloud Interconnect* configuration. + These addresses are regional resources. Not currently available + publicly. - ``SHARED_LOADBALANCER_VIP`` for an internal IP address + that is assigned to multiple internal forwarding rules. - + ``PRIVATE_SERVICE_CONNECT`` for a private network address that is + used to configure Private Service Connect. Only global internal + addresses can use this purpose. + """ + UNDEFINED_PURPOSE = 0 + DNS_RESOLVER = 476114556 + GCE_ENDPOINT = 230515243 + IPSEC_INTERCONNECT = 340437251 + NAT_AUTO = 163666477 + PRIVATE_SERVICE_CONNECT = 48134724 + SHARED_LOADBALANCER_VIP = 294447572 + VPC_PEERING = 400800170 + class Status(proto.Enum): - r"""[Output Only] The status of the autoscaler configuration. Current - set of possible values: - - - PENDING: Autoscaler backend hasn't read new/updated - configuration. - - DELETING: Configuration is being deleted. - - ACTIVE: Configuration is acknowledged to be effective. Some - warnings might be present in the statusDetails field. - - ERROR: Configuration has errors. Actionable for users. Details - are present in the statusDetails field. New values might be added - in the future. + r"""[Output Only] The status of the address, which can be one of + RESERVING, RESERVED, or IN_USE. An address that is RESERVING is + currently in the process of being reserved. A RESERVED address is + currently reserved and available to use. An IN_USE address is + currently being used by another resource and is not available. """ UNDEFINED_STATUS = 0 - ACTIVE = 314733318 - DELETING = 528602024 - ERROR = 66247144 - PENDING = 35394935 + IN_USE = 17393485 + RESERVED = 432241448 + RESERVING = 514587225 - autoscaling_policy = proto.Field( - proto.MESSAGE, number=221950041, optional=True, message="AutoscalingPolicy", + address = proto.Field(proto.STRING, number=462920692, optional=True,) + address_type = proto.Field( + proto.ENUM, number=264307877, optional=True, enum=AddressType, ) creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) description = proto.Field(proto.STRING, number=422937596, optional=True,) id = proto.Field(proto.UINT64, number=3355, optional=True,) + ip_version = proto.Field( + proto.ENUM, number=294959552, optional=True, enum=IpVersion, + ) kind = proto.Field(proto.STRING, number=3292052, optional=True,) name = proto.Field(proto.STRING, number=3373707, optional=True,) - recommended_size = proto.Field(proto.INT32, number=257915749, optional=True,) - region = proto.Field(proto.STRING, number=138946292, optional=True,) - scaling_schedule_status = proto.MapField( - proto.STRING, proto.MESSAGE, number=465950178, message="ScalingScheduleStatus", + network = proto.Field(proto.STRING, number=232872494, optional=True,) + network_tier = proto.Field( + proto.ENUM, number=517397843, optional=True, enum=NetworkTier, ) + prefix_length = proto.Field(proto.INT32, number=453565747, optional=True,) + purpose = proto.Field(proto.ENUM, number=316407070, optional=True, enum=Purpose,) + region = proto.Field(proto.STRING, number=138946292, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) - status_details = proto.RepeatedField( - proto.MESSAGE, number=363353845, message="AutoscalerStatusDetails", - ) - target = proto.Field(proto.STRING, number=192835985, optional=True,) - zone = proto.Field(proto.STRING, number=3744684, optional=True,) - - -class AutoscalersScopedList(proto.Message): - r""" - Attributes: - autoscalers (Sequence[google.cloud.compute_v1.types.Autoscaler]): - [Output Only] A list of autoscalers contained in this scope. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning which replaces the list - of autoscalers when the list is empty. - """ - - autoscalers = proto.RepeatedField( - proto.MESSAGE, number=465771644, message="Autoscaler", - ) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) + subnetwork = proto.Field(proto.STRING, number=307827694, optional=True,) + users = proto.RepeatedField(proto.STRING, number=111578632,) -class AutoscalerAggregatedList(proto.Message): +class AddressAggregatedList(proto.Message): r""" Attributes: id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.AutoscalerAggregatedList.ItemsEntry]): - A list of AutoscalersScopedList resources. + items (Sequence[google.cloud.compute_v1.types.AddressAggregatedList.ItemsEntry]): + A list of AddressesScopedList resources. kind (str): [Output Only] Type of resource. Always - compute#autoscalerAggregatedList for aggregated lists of - autoscalers. + compute#addressAggregatedList for aggregated lists of + addresses. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -2938,7 +2327,7 @@ def raw_page(self): id = proto.Field(proto.STRING, number=3355, optional=True,) items = proto.MapField( - proto.STRING, proto.MESSAGE, number=100526016, message="AutoscalersScopedList", + proto.STRING, proto.MESSAGE, number=100526016, message="AddressesScopedList", ) kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) @@ -2949,17 +2338,17 @@ def raw_page(self): ) -class AutoscalerList(proto.Message): - r"""Contains a list of Autoscaler resources. +class AddressList(proto.Message): + r"""Contains a list of addresses. Attributes: id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.Autoscaler]): - A list of Autoscaler resources. + items (Sequence[google.cloud.compute_v1.types.Address]): + A list of Address resources. kind (str): - [Output Only] Type of resource. Always - compute#autoscalerList for lists of autoscalers. + [Output Only] Type of resource. Always compute#addressList + for lists of addresses. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -2978,7 +2367,7 @@ def raw_page(self): return self id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Autoscaler",) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Address",) kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) @@ -2987,2596 +2376,3462 @@ def raw_page(self): ) -class AutoscalingPolicyCpuUtilization(proto.Message): - r"""CPU utilization policy. +class AddressesScopedList(proto.Message): + r""" Attributes: - predictive_method (google.cloud.compute_v1.types.AutoscalingPolicyCpuUtilization.PredictiveMethod): - Indicates whether predictive autoscaling based on CPU metric - is enabled. Valid values are: - - - NONE (default). No predictive method is used. The - autoscaler scales the group to meet current demand based - on real-time metrics. \* OPTIMIZE_AVAILABILITY. - Predictive autoscaling improves availability by - monitoring daily and weekly load patterns and scaling out - ahead of anticipated demand. - utilization_target (float): - The target CPU utilization that the autoscaler maintains. - Must be a float value in the range (0, 1]. If not specified, - the default is 0.6. + addresses (Sequence[google.cloud.compute_v1.types.Address]): + [Output Only] A list of addresses contained in this scope. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning which replaces the list + of addresses when the list is empty. + """ - If the CPU level is below the target utilization, the - autoscaler scales in the number of instances until it - reaches the minimum number of instances you specified or - until the average CPU of your instances reaches the target - utilization. + addresses = proto.RepeatedField(proto.MESSAGE, number=337673122, message="Address",) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) - If the average CPU is above the target utilization, the - autoscaler scales out until it reaches the maximum number of - instances you specified or until the average utilization - reaches the target utilization. - """ - class PredictiveMethod(proto.Enum): - r"""Indicates whether predictive autoscaling based on CPU metric is - enabled. Valid values are: +class AdvancedMachineFeatures(proto.Message): + r"""Specifies options for controlling advanced machine features. + Options that would traditionally be configured in a BIOS belong + here. Features that require operating system support may have + corresponding entries in the GuestOsFeatures of an Image (e.g., + whether or not the OS in the Image supports nested + virtualization being enabled or disabled). - - NONE (default). No predictive method is used. The autoscaler - scales the group to meet current demand based on real-time - metrics. \* OPTIMIZE_AVAILABILITY. Predictive autoscaling - improves availability by monitoring daily and weekly load - patterns and scaling out ahead of anticipated demand. - """ - UNDEFINED_PREDICTIVE_METHOD = 0 - NONE = 2402104 - OPTIMIZE_AVAILABILITY = 11629437 + Attributes: + enable_nested_virtualization (bool): + Whether to enable nested virtualization or + not (default is false). + threads_per_core (int): + The number of threads per physical core. To + disable simultaneous multithreading (SMT) set + this to 1. If unset, the maximum number of + threads supported per core by the underlying + processor is assumed. + """ - predictive_method = proto.Field( - proto.ENUM, number=390220737, optional=True, enum=PredictiveMethod, + enable_nested_virtualization = proto.Field( + proto.BOOL, number=16639365, optional=True, ) - utilization_target = proto.Field(proto.DOUBLE, number=215905870, optional=True,) + threads_per_core = proto.Field(proto.INT32, number=352611671, optional=True,) -class AutoscalingPolicyCustomMetricUtilization(proto.Message): - r"""Custom utilization metric policy. +class AggregatedListAcceleratorTypesRequest(proto.Message): + r"""A request message for AcceleratorTypes.AggregatedList. See + the method description for details. + Attributes: filter (str): - A filter string, compatible with a Stackdriver Monitoring - filter string for TimeSeries.list API call. This filter is - used to select a specific TimeSeries for the purpose of - autoscaling and to determine whether the metric is exporting - per-instance or per-group data. - - For the filter to be valid for autoscaling purposes, the - following rules apply: - - - You can only use the AND operator for joining selectors. - - You can only use direct equality comparison operator (=) - without any functions for each selector. - - You can specify the metric in both the filter string and - in the metric field. However, if specified in both - places, the metric must be identical. - - The monitored resource type determines what kind of - values are expected for the metric. If it is a - gce_instance, the autoscaler expects the metric to - include a separate TimeSeries for each instance in a - group. In such a case, you cannot filter on resource - labels. If the resource type is any other value, the - autoscaler expects this metric to contain values that - apply to the entire autoscaled instance group and - resource label filtering can be performed to point - autoscaler at the correct TimeSeries to scale upon. This - is called a per-group metric for the purpose of - autoscaling. - - If not specified, the type defaults to gce_instance. - - Try to provide a filter that is selective enough to pick - just one TimeSeries for the autoscaled group or for each of - the instances (if you are using gce_instance resource type). - If multiple TimeSeries are returned upon the query - execution, the autoscaler will sum their respective values - to obtain its scaling value. - metric (str): - The identifier (type) of the Stackdriver - Monitoring metric. The metric cannot have - negative values. The metric must have a value - type of INT64 or DOUBLE. - single_instance_assignment (float): - If scaling is based on a per-group metric value that - represents the total amount of work to be done or resource - usage, set this value to an amount assigned for a single - instance of the scaled group. Autoscaler keeps the number of - instances proportional to the value of this metric. The - metric itself does not change value due to group resizing. + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. + """ - A good metric to use with the target is for example - pubsub.googleapis.com/subscription/num_undelivered_messages - or a custom metric exporting the total number of requests - coming to your instances. + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - A bad example would be a metric exporting an average or - median latency, since this value can't include a chunk - assignable to a single instance, it could be better used - with utilization_target instead. - utilization_target (float): - The target value of the metric that autoscaler maintains. - This must be a positive value. A utilization metric scales - number of virtual machines handling requests to increase or - decrease proportionally to the metric. - For example, a good metric to use as a utilization_target is - https://www.googleapis.com/compute/v1/instance/network/received_bytes_count. - The autoscaler works to keep this value constant for each of - the instances. - utilization_target_type (google.cloud.compute_v1.types.AutoscalingPolicyCustomMetricUtilization.UtilizationTargetType): - Defines how target utilization value is expressed for a - Stackdriver Monitoring metric. Either GAUGE, - DELTA_PER_SECOND, or DELTA_PER_MINUTE. +class AggregatedListAddressesRequest(proto.Message): + r"""A request message for Addresses.AggregatedList. See the + method description for details. + + Attributes: + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - class UtilizationTargetType(proto.Enum): - r"""Defines how target utilization value is expressed for a Stackdriver - Monitoring metric. Either GAUGE, DELTA_PER_SECOND, or - DELTA_PER_MINUTE. - """ - UNDEFINED_UTILIZATION_TARGET_TYPE = 0 - DELTA_PER_MINUTE = 87432861 - DELTA_PER_SECOND = 255180029 - GAUGE = 67590361 + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + + +class AggregatedListAutoscalersRequest(proto.Message): + r"""A request message for Autoscalers.AggregatedList. See the + method description for details. + + Attributes: + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. + """ filter = proto.Field(proto.STRING, number=336120696, optional=True,) - metric = proto.Field(proto.STRING, number=533067184, optional=True,) - single_instance_assignment = proto.Field( - proto.DOUBLE, number=504768064, optional=True, - ) - utilization_target = proto.Field(proto.DOUBLE, number=215905870, optional=True,) - utilization_target_type = proto.Field( - proto.ENUM, number=340169355, optional=True, enum=UtilizationTargetType, - ) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class AutoscalingPolicyLoadBalancingUtilization(proto.Message): - r"""Configuration parameters of autoscaling based on load - balancing. +class AggregatedListBackendServicesRequest(proto.Message): + r"""A request message for BackendServices.AggregatedList. See the + method description for details. Attributes: - utilization_target (float): - Fraction of backend capacity utilization (set - in HTTP(S) load balancing configuration) that - the autoscaler maintains. Must be a positive - float value. If not defined, the default is 0.8. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Name of the project scoping this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - utilization_target = proto.Field(proto.DOUBLE, number=215905870, optional=True,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class AutoscalingPolicyScaleInControl(proto.Message): - r"""Configuration that allows for slower scale in so that even if - Autoscaler recommends an abrupt scale in of a MIG, it will be - throttled as specified by the parameters below. +class AggregatedListDiskTypesRequest(proto.Message): + r"""A request message for DiskTypes.AggregatedList. See the + method description for details. Attributes: - max_scaled_in_replicas (google.cloud.compute_v1.types.FixedOrPercent): - Maximum allowed number (or %) of VMs that can - be deducted from the peak recommendation during - the window autoscaler looks at when computing - recommendations. Possibly all these VMs can be - deleted at once so user service needs to be - prepared to lose that many VMs in one step. - time_window_sec (int): - How far back autoscaling looks when computing - recommendations to include directives regarding - slower scale in, as described above. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - max_scaled_in_replicas = proto.Field( - proto.MESSAGE, number=180710123, optional=True, message="FixedOrPercent", - ) - time_window_sec = proto.Field(proto.INT32, number=36405300, optional=True,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class AutoscalingPolicyScalingSchedule(proto.Message): - r"""Scaling based on user-defined schedule. The message describes - a single scaling schedule. A scaling schedule changes the - minimum number of VM instances an autoscaler can recommend, - which can trigger scaling out. +class AggregatedListDisksRequest(proto.Message): + r"""A request message for Disks.AggregatedList. See the method + description for details. Attributes: - description (str): - A description of a scaling schedule. - disabled (bool): - A boolean value that specifies whether a - scaling schedule can influence autoscaler - recommendations. If set to true, then a scaling - schedule has no effect. This field is optional, - and its value is false by default. - duration_sec (int): - The duration of time intervals, in seconds, - for which this scaling schedule is to run. The - minimum allowed value is 300. This field is - required. - min_required_replicas (int): - The minimum number of VM instances that the - autoscaler will recommend in time intervals - starting according to schedule. This field is - required. - schedule (str): - The start timestamps of time intervals when this scaling - schedule is to provide a scaling signal. This field uses the - extended cron format (with an optional year field). The - expression can describe a single timestamp if the optional - year is set, in which case the scaling schedule runs once. - The schedule is interpreted with respect to time_zone. This - field is required. Note: These timestamps only describe when - autoscaler starts providing the scaling signal. The VMs need - additional time to become serving. - time_zone (str): - The time zone to use when interpreting the schedule. The - value of this field must be a time zone name from the tz - database: http://en.wikipedia.org/wiki/Tz_database. This - field is assigned a default value of ?UTC? if left empty. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - description = proto.Field(proto.STRING, number=422937596, optional=True,) - disabled = proto.Field(proto.BOOL, number=270940796, optional=True,) - duration_sec = proto.Field(proto.INT32, number=212356902, optional=True,) - min_required_replicas = proto.Field(proto.INT32, number=365514414, optional=True,) - schedule = proto.Field(proto.STRING, number=375820951, optional=True,) - time_zone = proto.Field(proto.STRING, number=36848094, optional=True,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class FixedOrPercent(proto.Message): - r"""Encapsulates numeric value that can be either absolute or - relative. +class AggregatedListForwardingRulesRequest(proto.Message): + r"""A request message for ForwardingRules.AggregatedList. See the + method description for details. Attributes: - calculated (int): - [Output Only] Absolute value of VM instances calculated - based on the specific mode. - - - If the value is fixed, then the calculated value is equal - to the fixed value. - - If the value is a percent, then the calculated value is - percent/100 \* targetSize. For example, the calculated - value of a 80% of a managed instance group with 150 - instances would be (80/100 \* 150) = 120 VM instances. If - there is a remainder, the number is rounded up. - fixed (int): - Specifies a fixed number of VM instances. - This must be a positive integer. - percent (int): - Specifies a percentage of instances between 0 - to 100%, inclusive. For example, specify 80 for - 80%. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - calculated = proto.Field(proto.INT32, number=472082878, optional=True,) - fixed = proto.Field(proto.INT32, number=97445748, optional=True,) - percent = proto.Field(proto.INT32, number=394814533, optional=True,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class Backend(proto.Message): - r"""Message containing information of one individual backend. +class AggregatedListGlobalOperationsRequest(proto.Message): + r"""A request message for GlobalOperations.AggregatedList. See + the method description for details. + Attributes: - balancing_mode (google.cloud.compute_v1.types.Backend.BalancingMode): - Specifies how to determine whether the - backend of a load balancer can handle additional - traffic or is fully loaded. For usage - guidelines, see Connection balancing mode. - capacity_scaler (float): - A multiplier applied to the backend's target capacity of its - balancing mode. The default value is 1, which means the - group serves up to 100% of its configured capacity - (depending on balancingMode). A setting of 0 means the group - is completely drained, offering 0% of its available - capacity. The valid ranges are 0.0 and [0.1,1.0]. You cannot - configure a setting larger than 0 and smaller than 0.1. You - cannot configure a setting of 0 when there is only one - backend attached to the backend service. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. + """ - Not supported by: + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - - Internal TCP/UDP Load Balancing - Network Load Balancing - description (str): - An optional description of this resource. - Provide this property when you create the - resource. - failover (bool): - This field designates whether this is a - failover backend. More than one failover backend - can be configured for a given BackendService. - group (str): - The fully-qualified URL of an instance group or network - endpoint group (NEG) resource. The type of backend that a - backend service supports depends on the backend service's - loadBalancingScheme. - - - When the loadBalancingScheme for the backend service is - EXTERNAL (except Network Load Balancing), - INTERNAL_SELF_MANAGED, or INTERNAL_MANAGED , the backend - can be either an instance group or a NEG. The backends on - the backend service must be either all instance groups or - all NEGs. You cannot mix instance group and NEG backends - on the same backend service. - - - When the loadBalancingScheme for the backend service is - EXTERNAL for Network Load Balancing or INTERNAL for - Internal TCP/UDP Load Balancing, the backend must be an - instance group. NEGs are not supported. - - For regional services, the backend must be in the same - region as the backend service. - - You must use the fully-qualified URL (starting with - https://www.googleapis.com/) to specify the instance group - or NEG. Partial URLs are not supported. - max_connections (int): - Defines a target maximum number of - simultaneous connections. For usage guidelines, - see Connection balancing mode and Utilization - balancing mode. Not available if the backend's - balancingMode is RATE. Not supported by: - - Internal TCP/UDP Load Balancing - Network Load - Balancing - max_connections_per_endpoint (int): - Defines a target maximum number of - simultaneous connections. For usage guidelines, - see Connection balancing mode and Utilization - balancing mode. Not available if the backend's - balancingMode is RATE. Not supported by: - - Internal TCP/UDP Load Balancing - Network Load - Balancing. - max_connections_per_instance (int): - Defines a target maximum number of - simultaneous connections. For usage guidelines, - see Connection balancing mode and Utilization - balancing mode. Not available if the backend's - balancingMode is RATE. Not supported by: - - Internal TCP/UDP Load Balancing - Network Load - Balancing. - max_rate (int): - Defines a maximum number of HTTP requests per - second (RPS). For usage guidelines, see Rate - balancing mode and Utilization balancing mode. - Not available if the backend's balancingMode is - CONNECTION. - max_rate_per_endpoint (float): - Defines a maximum target for requests per - second (RPS). For usage guidelines, see Rate - balancing mode and Utilization balancing mode. - Not available if the backend's balancingMode is - CONNECTION. - max_rate_per_instance (float): - Defines a maximum target for requests per - second (RPS). For usage guidelines, see Rate - balancing mode and Utilization balancing mode. - Not available if the backend's balancingMode is - CONNECTION. - max_utilization (float): - """ +class AggregatedListHealthChecksRequest(proto.Message): + r"""A request message for HealthChecks.AggregatedList. See the + method description for details. - class BalancingMode(proto.Enum): - r"""Specifies how to determine whether the backend of a load - balancer can handle additional traffic or is fully loaded. For - usage guidelines, see Connection balancing mode. - """ - UNDEFINED_BALANCING_MODE = 0 - CONNECTION = 246311646 - RATE = 2508000 - UTILIZATION = 157008386 + Attributes: + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Name of the project scoping this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. + """ - balancing_mode = proto.Field( - proto.ENUM, number=430286217, optional=True, enum=BalancingMode, - ) - capacity_scaler = proto.Field(proto.FLOAT, number=315958157, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - failover = proto.Field(proto.BOOL, number=138892530, optional=True,) - group = proto.Field(proto.STRING, number=98629247, optional=True,) - max_connections = proto.Field(proto.INT32, number=110652154, optional=True,) - max_connections_per_endpoint = proto.Field( - proto.INT32, number=216904604, optional=True, - ) - max_connections_per_instance = proto.Field( - proto.INT32, number=104671900, optional=True, - ) - max_rate = proto.Field(proto.INT32, number=408035035, optional=True,) - max_rate_per_endpoint = proto.Field(proto.FLOAT, number=129832283, optional=True,) - max_rate_per_instance = proto.Field(proto.FLOAT, number=17599579, optional=True,) - max_utilization = proto.Field(proto.FLOAT, number=148192199, optional=True,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class BackendBucketCdnPolicy(proto.Message): - r"""Message containing Cloud CDN configuration for a backend - bucket. +class AggregatedListInstanceGroupManagersRequest(proto.Message): + r"""A request message for InstanceGroupManagers.AggregatedList. + See the method description for details. Attributes: - bypass_cache_on_request_headers (Sequence[google.cloud.compute_v1.types.BackendBucketCdnPolicyBypassCacheOnRequestHeader]): - Bypass the cache when the specified request - headers are matched - e.g. Pragma or - Authorization headers. Up to 5 headers can be - specified. The cache is bypassed for all - cdnPolicy.cacheMode settings. - cache_mode (google.cloud.compute_v1.types.BackendBucketCdnPolicy.CacheMode): - Specifies the cache setting for all responses from this - backend. The possible values are: - - USE_ORIGIN_HEADERS Requires the origin to set valid caching - headers to cache content. Responses without these headers - will not be cached at Google's edge, and will require a full - trip to the origin on every request, potentially impacting - performance and increasing load on the origin server. - - FORCE_CACHE_ALL Cache all content, ignoring any "private", - "no-store" or "no-cache" directives in Cache-Control - response headers. Warning: this may result in Cloud CDN - caching private, per-user (user identifiable) content. - - CACHE_ALL_STATIC Automatically cache static content, - including common image formats, media (video and audio), and - web assets (JavaScript and CSS). Requests and responses that - are marked as uncacheable, as well as dynamic content - (including HTML), will not be cached. - client_ttl (int): - Specifies a separate client (e.g. browser client) maximum - TTL. This is used to clamp the max-age (or Expires) value - sent to the client. With FORCE_CACHE_ALL, the lesser of - client_ttl and default_ttl is used for the response max-age - directive, along with a "public" directive. For cacheable - content in CACHE_ALL_STATIC mode, client_ttl clamps the - max-age from the origin (if specified), or else sets the - response max-age directive to the lesser of the client_ttl - and default_ttl, and also ensures a "public" cache-control - directive is present. If a client TTL is not specified, a - default value (1 hour) will be used. The maximum allowed - value is 86400s (1 day). - default_ttl (int): - Specifies the default TTL for cached content served by this - origin for responses that do not have an existing valid TTL - (max-age or s-max-age). Setting a TTL of "0" means "always - revalidate". The value of defaultTTL cannot be set to a - value greater than that of maxTTL, but can be equal. When - the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL will - overwrite the TTL set in all responses. The maximum allowed - value is 31,622,400s (1 year), noting that infrequently - accessed objects may be evicted from the cache before the - defined TTL. - max_ttl (int): - Specifies the maximum allowed TTL for cached - content served by this origin. Cache directives - that attempt to set a max-age or s-maxage higher - than this, or an Expires header more than maxTTL - seconds in the future will be capped at the - value of maxTTL, as if it were the value of an - s-maxage Cache-Control directive. Headers sent - to the client will not be modified. Setting a - TTL of "0" means "always revalidate". The - maximum allowed value is 31,622,400s (1 year), - noting that infrequently accessed objects may be - evicted from the cache before the defined TTL. - negative_caching (bool): - Negative caching allows per-status code TTLs to be set, in - order to apply fine-grained caching for common errors or - redirects. This can reduce the load on your origin and - improve end-user experience by reducing response latency. - When the cache mode is set to CACHE_ALL_STATIC or - USE_ORIGIN_HEADERS, negative caching applies to responses - with the specified response code that lack any - Cache-Control, Expires, or Pragma: no-cache directives. When - the cache mode is set to FORCE_CACHE_ALL, negative caching - applies to all responses with the specified response code, - and override any caching headers. By default, Cloud CDN will - apply the following default TTLs to these status codes: HTTP - 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m - HTTP 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal - Reasons): 120s HTTP 405 (Method Not Found), 421 (Misdirected - Request), 501 (Not Implemented): 60s. These defaults can be - overridden in negative_caching_policy. - negative_caching_policy (Sequence[google.cloud.compute_v1.types.BackendBucketCdnPolicyNegativeCachingPolicy]): - Sets a cache TTL for the specified HTTP status code. - negative_caching must be enabled to configure - negative_caching_policy. Omitting the policy and leaving - negative_caching enabled will use Cloud CDN's default cache - TTLs. Note that when specifying an explicit - negative_caching_policy, you should take care to specify a - cache TTL for all response codes that you wish to cache. - Cloud CDN will not apply any default negative caching when a - policy exists. - request_coalescing (bool): - If true then Cloud CDN will combine multiple - concurrent cache fill requests into a small - number of requests to the origin. - serve_while_stale (int): - Serve existing content from the cache (if - available) when revalidating content with the - origin, or when an error is encountered when - refreshing the cache. This setting defines the - default "max-stale" duration for any cached - responses that do not specify a max-stale - directive. Stale responses that exceed the TTL - configured here will not be served. The default - limit (max-stale) is 86400s (1 day), which will - allow stale content to be served up to this - limit beyond the max-age (or s-max-age) of a - cached response. The maximum allowed value is - 604800 (1 week). Set this to zero (0) to disable - serve-while-stale. - signed_url_cache_max_age_sec (int): - Maximum number of seconds the response to a signed URL - request will be considered fresh. After this time period, - the response will be revalidated before being served. - Defaults to 1hr (3600s). When serving responses to signed - URL requests, Cloud CDN will internally behave as though all - responses from this backend had a "Cache-Control: public, - max-age=[TTL]" header, regardless of any existing - Cache-Control header. The actual headers served in responses - will not be altered. - signed_url_key_names (Sequence[str]): - [Output Only] Names of the keys for signing request URLs. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - class CacheMode(proto.Enum): - r"""Specifies the cache setting for all responses from this backend. The - possible values are: + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - USE_ORIGIN_HEADERS Requires the origin to set valid caching headers - to cache content. Responses without these headers will not be cached - at Google's edge, and will require a full trip to the origin on - every request, potentially impacting performance and increasing load - on the origin server. - FORCE_CACHE_ALL Cache all content, ignoring any "private", - "no-store" or "no-cache" directives in Cache-Control response - headers. Warning: this may result in Cloud CDN caching private, - per-user (user identifiable) content. +class AggregatedListInstanceGroupsRequest(proto.Message): + r"""A request message for InstanceGroups.AggregatedList. See the + method description for details. - CACHE_ALL_STATIC Automatically cache static content, including - common image formats, media (video and audio), and web assets - (JavaScript and CSS). Requests and responses that are marked as - uncacheable, as well as dynamic content (including HTML), will not - be cached. - """ - UNDEFINED_CACHE_MODE = 0 - CACHE_ALL_STATIC = 355027945 - FORCE_CACHE_ALL = 486026928 - INVALID_CACHE_MODE = 381295560 - USE_ORIGIN_HEADERS = 55380261 + Attributes: + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. + """ - bypass_cache_on_request_headers = proto.RepeatedField( - proto.MESSAGE, - number=486203082, - message="BackendBucketCdnPolicyBypassCacheOnRequestHeader", - ) - cache_mode = proto.Field( - proto.ENUM, number=28877888, optional=True, enum=CacheMode, - ) - client_ttl = proto.Field(proto.INT32, number=29034360, optional=True,) - default_ttl = proto.Field(proto.INT32, number=100253422, optional=True,) - max_ttl = proto.Field(proto.INT32, number=307578001, optional=True,) - negative_caching = proto.Field(proto.BOOL, number=336110005, optional=True,) - negative_caching_policy = proto.RepeatedField( - proto.MESSAGE, - number=155359996, - message="BackendBucketCdnPolicyNegativeCachingPolicy", - ) - request_coalescing = proto.Field(proto.BOOL, number=532808276, optional=True,) - serve_while_stale = proto.Field(proto.INT32, number=236682203, optional=True,) - signed_url_cache_max_age_sec = proto.Field( - proto.INT64, number=269374534, optional=True, - ) - signed_url_key_names = proto.RepeatedField(proto.STRING, number=371848885,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class BackendBucket(proto.Message): - r"""Represents a Cloud Storage Bucket resource. - This Cloud Storage bucket resource is referenced by a URL map of - a load balancer. For more information, read Backend Buckets. +class AggregatedListInstancesRequest(proto.Message): + r"""A request message for Instances.AggregatedList. See the + method description for details. Attributes: - bucket_name (str): - Cloud Storage bucket name. - cdn_policy (google.cloud.compute_v1.types.BackendBucketCdnPolicy): - Cloud CDN configuration for this - BackendBucket. - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - custom_response_headers (Sequence[str]): - Headers that the HTTP/S load balancer should - add to proxied responses. - description (str): - An optional textual description of the - resource; provided by the client when the - resource is created. - enable_cdn (bool): - If true, enable Cloud CDN for this - BackendBucket. - id (int): - [Output Only] Unique identifier for the resource; defined by - the server. - kind (str): - Type of the resource. - name (str): - Name of the resource. Provided by the client when the - resource is created. The name must be 1-63 characters long, - and comply with RFC1035. Specifically, the name must be 1-63 - characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. - self_link (str): - [Output Only] Server-defined URL for the resource. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - bucket_name = proto.Field(proto.STRING, number=283610048, optional=True,) - cdn_policy = proto.Field( - proto.MESSAGE, - number=213976452, - optional=True, - message="BackendBucketCdnPolicy", - ) - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - custom_response_headers = proto.RepeatedField(proto.STRING, number=387539094,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - enable_cdn = proto.Field(proto.BOOL, number=282942321, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class BackendBucketCdnPolicyBypassCacheOnRequestHeader(proto.Message): - r"""Bypass the cache when the specified request headers are present, - e.g. Pragma or Authorization headers. Values are case insensitive. - The presence of such a header overrides the cache_mode setting. +class AggregatedListInterconnectAttachmentsRequest(proto.Message): + r"""A request message for InterconnectAttachments.AggregatedList. + See the method description for details. Attributes: - header_name (str): - The header field name to match on when - bypassing cache. Values are case-insensitive. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - header_name = proto.Field(proto.STRING, number=110223613, optional=True,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class BackendBucketCdnPolicyNegativeCachingPolicy(proto.Message): - r"""Specify CDN TTLs for response error codes. +class AggregatedListMachineTypesRequest(proto.Message): + r"""A request message for MachineTypes.AggregatedList. See the + method description for details. + Attributes: - code (int): - The HTTP status code to define a TTL against. - Only HTTP status codes 300, 301, 302, 307, 308, - 404, 405, 410, 421, 451 and 501 are can be - specified as values, and you cannot specify a - status code more than once. - ttl (int): - The TTL (in seconds) for which to cache - responses with the corresponding status code. - The maximum allowed value is 1800s (30 minutes), - noting that infrequently accessed objects may be - evicted from the cache before the defined TTL. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - code = proto.Field(proto.INT32, number=3059181, optional=True,) - ttl = proto.Field(proto.INT32, number=115180, optional=True,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class BackendBucketList(proto.Message): - r"""Contains a list of BackendBucket resources. +class AggregatedListNetworkEndpointGroupsRequest(proto.Message): + r"""A request message for NetworkEndpointGroups.AggregatedList. + See the method description for details. + Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.BackendBucket]): - A list of BackendBucket resources. - kind (str): - Type of resource. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="BackendBucket", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class BackendServiceCdnPolicy(proto.Message): - r"""Message containing Cloud CDN configuration for a backend - service. +class AggregatedListNodeGroupsRequest(proto.Message): + r"""A request message for NodeGroups.AggregatedList. See the + method description for details. Attributes: - bypass_cache_on_request_headers (Sequence[google.cloud.compute_v1.types.BackendServiceCdnPolicyBypassCacheOnRequestHeader]): - Bypass the cache when the specified request - headers are matched - e.g. Pragma or - Authorization headers. Up to 5 headers can be - specified. The cache is bypassed for all - cdnPolicy.cacheMode settings. - cache_key_policy (google.cloud.compute_v1.types.CacheKeyPolicy): - The CacheKeyPolicy for this CdnPolicy. - cache_mode (google.cloud.compute_v1.types.BackendServiceCdnPolicy.CacheMode): - Specifies the cache setting for all responses from this - backend. The possible values are: - - USE_ORIGIN_HEADERS Requires the origin to set valid caching - headers to cache content. Responses without these headers - will not be cached at Google's edge, and will require a full - trip to the origin on every request, potentially impacting - performance and increasing load on the origin server. - - FORCE_CACHE_ALL Cache all content, ignoring any "private", - "no-store" or "no-cache" directives in Cache-Control - response headers. Warning: this may result in Cloud CDN - caching private, per-user (user identifiable) content. - - CACHE_ALL_STATIC Automatically cache static content, - including common image formats, media (video and audio), and - web assets (JavaScript and CSS). Requests and responses that - are marked as uncacheable, as well as dynamic content - (including HTML), will not be cached. - client_ttl (int): - Specifies a separate client (e.g. browser client) maximum - TTL. This is used to clamp the max-age (or Expires) value - sent to the client. With FORCE_CACHE_ALL, the lesser of - client_ttl and default_ttl is used for the response max-age - directive, along with a "public" directive. For cacheable - content in CACHE_ALL_STATIC mode, client_ttl clamps the - max-age from the origin (if specified), or else sets the - response max-age directive to the lesser of the client_ttl - and default_ttl, and also ensures a "public" cache-control - directive is present. If a client TTL is not specified, a - default value (1 hour) will be used. The maximum allowed - value is 86400s (1 day). - default_ttl (int): - Specifies the default TTL for cached content served by this - origin for responses that do not have an existing valid TTL - (max-age or s-max-age). Setting a TTL of "0" means "always - revalidate". The value of defaultTTL cannot be set to a - value greater than that of maxTTL, but can be equal. When - the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL will - overwrite the TTL set in all responses. The maximum allowed - value is 31,622,400s (1 year), noting that infrequently - accessed objects may be evicted from the cache before the - defined TTL. - max_ttl (int): - Specifies the maximum allowed TTL for cached - content served by this origin. Cache directives - that attempt to set a max-age or s-maxage higher - than this, or an Expires header more than maxTTL - seconds in the future will be capped at the - value of maxTTL, as if it were the value of an - s-maxage Cache-Control directive. Headers sent - to the client will not be modified. Setting a - TTL of "0" means "always revalidate". The - maximum allowed value is 31,622,400s (1 year), - noting that infrequently accessed objects may be - evicted from the cache before the defined TTL. - negative_caching (bool): - Negative caching allows per-status code TTLs to be set, in - order to apply fine-grained caching for common errors or - redirects. This can reduce the load on your origin and - improve end-user experience by reducing response latency. - When the cache mode is set to CACHE_ALL_STATIC or - USE_ORIGIN_HEADERS, negative caching applies to responses - with the specified response code that lack any - Cache-Control, Expires, or Pragma: no-cache directives. When - the cache mode is set to FORCE_CACHE_ALL, negative caching - applies to all responses with the specified response code, - and override any caching headers. By default, Cloud CDN will - apply the following default TTLs to these status codes: HTTP - 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m - HTTP 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal - Reasons): 120s HTTP 405 (Method Not Found), 421 (Misdirected - Request), 501 (Not Implemented): 60s. These defaults can be - overridden in negative_caching_policy. - negative_caching_policy (Sequence[google.cloud.compute_v1.types.BackendServiceCdnPolicyNegativeCachingPolicy]): - Sets a cache TTL for the specified HTTP status code. - negative_caching must be enabled to configure - negative_caching_policy. Omitting the policy and leaving - negative_caching enabled will use Cloud CDN's default cache - TTLs. Note that when specifying an explicit - negative_caching_policy, you should take care to specify a - cache TTL for all response codes that you wish to cache. - Cloud CDN will not apply any default negative caching when a - policy exists. - request_coalescing (bool): - If true then Cloud CDN will combine multiple - concurrent cache fill requests into a small - number of requests to the origin. - serve_while_stale (int): - Serve existing content from the cache (if - available) when revalidating content with the - origin, or when an error is encountered when - refreshing the cache. This setting defines the - default "max-stale" duration for any cached - responses that do not specify a max-stale - directive. Stale responses that exceed the TTL - configured here will not be served. The default - limit (max-stale) is 86400s (1 day), which will - allow stale content to be served up to this - limit beyond the max-age (or s-max-age) of a - cached response. The maximum allowed value is - 604800 (1 week). Set this to zero (0) to disable - serve-while-stale. - signed_url_cache_max_age_sec (int): - Maximum number of seconds the response to a signed URL - request will be considered fresh. After this time period, - the response will be revalidated before being served. - Defaults to 1hr (3600s). When serving responses to signed - URL requests, Cloud CDN will internally behave as though all - responses from this backend had a "Cache-Control: public, - max-age=[TTL]" header, regardless of any existing - Cache-Control header. The actual headers served in responses - will not be altered. - signed_url_key_names (Sequence[str]): - [Output Only] Names of the keys for signing request URLs. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - class CacheMode(proto.Enum): - r"""Specifies the cache setting for all responses from this backend. The - possible values are: - - USE_ORIGIN_HEADERS Requires the origin to set valid caching headers - to cache content. Responses without these headers will not be cached - at Google's edge, and will require a full trip to the origin on - every request, potentially impacting performance and increasing load - on the origin server. - - FORCE_CACHE_ALL Cache all content, ignoring any "private", - "no-store" or "no-cache" directives in Cache-Control response - headers. Warning: this may result in Cloud CDN caching private, - per-user (user identifiable) content. - - CACHE_ALL_STATIC Automatically cache static content, including - common image formats, media (video and audio), and web assets - (JavaScript and CSS). Requests and responses that are marked as - uncacheable, as well as dynamic content (including HTML), will not - be cached. - """ - UNDEFINED_CACHE_MODE = 0 - CACHE_ALL_STATIC = 355027945 - FORCE_CACHE_ALL = 486026928 - INVALID_CACHE_MODE = 381295560 - USE_ORIGIN_HEADERS = 55380261 - - bypass_cache_on_request_headers = proto.RepeatedField( - proto.MESSAGE, - number=486203082, - message="BackendServiceCdnPolicyBypassCacheOnRequestHeader", - ) - cache_key_policy = proto.Field( - proto.MESSAGE, number=159263727, optional=True, message="CacheKeyPolicy", - ) - cache_mode = proto.Field( - proto.ENUM, number=28877888, optional=True, enum=CacheMode, - ) - client_ttl = proto.Field(proto.INT32, number=29034360, optional=True,) - default_ttl = proto.Field(proto.INT32, number=100253422, optional=True,) - max_ttl = proto.Field(proto.INT32, number=307578001, optional=True,) - negative_caching = proto.Field(proto.BOOL, number=336110005, optional=True,) - negative_caching_policy = proto.RepeatedField( - proto.MESSAGE, - number=155359996, - message="BackendServiceCdnPolicyNegativeCachingPolicy", - ) - request_coalescing = proto.Field(proto.BOOL, number=532808276, optional=True,) - serve_while_stale = proto.Field(proto.INT32, number=236682203, optional=True,) - signed_url_cache_max_age_sec = proto.Field( - proto.INT64, number=269374534, optional=True, - ) - signed_url_key_names = proto.RepeatedField(proto.STRING, number=371848885,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class CircuitBreakers(proto.Message): - r"""Settings controlling the volume of connections to a backend - service. +class AggregatedListNodeTemplatesRequest(proto.Message): + r"""A request message for NodeTemplates.AggregatedList. See the + method description for details. Attributes: - max_connections (int): - The maximum number of connections to the - backend service. If not specified, there is no - limit. - max_pending_requests (int): - The maximum number of pending requests - allowed to the backend service. If not - specified, there is no limit. - max_requests (int): - The maximum number of parallel requests that - allowed to the backend service. If not - specified, there is no limit. - max_requests_per_connection (int): - Maximum requests for a single connection to - the backend service. This parameter is respected - by both the HTTP/1.1 and HTTP/2 implementations. - If not specified, there is no limit. Setting - this parameter to 1 will effectively disable - keep alive. - max_retries (int): - The maximum number of parallel retries - allowed to the backend cluster. If not - specified, the default is 1. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - max_connections = proto.Field(proto.INT32, number=110652154, optional=True,) - max_pending_requests = proto.Field(proto.INT32, number=375558887, optional=True,) - max_requests = proto.Field(proto.INT32, number=28097599, optional=True,) - max_requests_per_connection = proto.Field( - proto.INT32, number=361630528, optional=True, - ) - max_retries = proto.Field(proto.INT32, number=55546219, optional=True,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class ConnectionDraining(proto.Message): - r"""Message containing connection draining configuration. +class AggregatedListNodeTypesRequest(proto.Message): + r"""A request message for NodeTypes.AggregatedList. See the + method description for details. + Attributes: - draining_timeout_sec (int): - Configures a duration timeout for existing - requests on a removed backend instance. For - supported load balancers and protocols, as - described in Enabling connection draining. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - draining_timeout_sec = proto.Field(proto.INT32, number=225127070, optional=True,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class ConsistentHashLoadBalancerSettings(proto.Message): - r"""This message defines settings for a consistent hash style - load balancer. +class AggregatedListPacketMirroringsRequest(proto.Message): + r"""A request message for PacketMirrorings.AggregatedList. See + the method description for details. Attributes: - http_cookie (google.cloud.compute_v1.types.ConsistentHashLoadBalancerSettingsHttpCookie): - Hash is based on HTTP Cookie. This field describes a HTTP - cookie that will be used as the hash key for the consistent - hash load balancer. If the cookie is not present, it will be - generated. This field is applicable if the sessionAffinity - is set to HTTP_COOKIE. - http_header_name (str): - The hash based on the value of the specified header field. - This field is applicable if the sessionAffinity is set to - HEADER_FIELD. - minimum_ring_size (int): - The minimum number of virtual nodes to use - for the hash ring. Defaults to 1024. Larger ring - sizes result in more granular load - distributions. If the number of hosts in the - load balancing pool is larger than the ring - size, each host will be assigned a single - virtual node. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - http_cookie = proto.Field( - proto.MESSAGE, - number=6673915, - optional=True, - message="ConsistentHashLoadBalancerSettingsHttpCookie", - ) - http_header_name = proto.Field(proto.STRING, number=234798022, optional=True,) - minimum_ring_size = proto.Field(proto.INT64, number=234380735, optional=True,) - - -class BackendServiceFailoverPolicy(proto.Message): - r"""Applicable only to Failover for Internal TCP/UDP Load - Balancing and Network Load Balancing. On failover or failback, - this field indicates whether connection draining will be - honored. GCP has a fixed connection draining timeout of 10 - minutes. A setting of true terminates existing TCP connections - to the active pool during failover and failback, immediately - draining traffic. A setting of false allows existing TCP - connections to persist, even on VMs no longer in the active - pool, for up to the duration of the connection draining timeout - (10 minutes). - - Attributes: - disable_connection_drain_on_failover (bool): - This can be set to true only if the protocol - is TCP. - The default is false. - drop_traffic_if_unhealthy (bool): - Applicable only to Failover for Internal - TCP/UDP Load Balancing and Network Load - Balancing, If set to true, connections to the - load balancer are dropped when all primary and - all backup backend VMs are unhealthy.If set to - false, connections are distributed among all - primary VMs when all primary and all backup - backend VMs are unhealthy. The default is false. - failover_ratio (float): - Applicable only to Failover for Internal TCP/UDP Load - Balancing and Network Load Balancing. The value of the field - must be in the range [0, 1]. If the value is 0, the load - balancer performs a failover when the number of healthy - primary VMs equals zero. For all other values, the load - balancer performs a failover when the total number of - healthy primary VMs is less than this ratio. - """ + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - disable_connection_drain_on_failover = proto.Field( - proto.BOOL, number=182150753, optional=True, - ) - drop_traffic_if_unhealthy = proto.Field( - proto.BOOL, number=112289428, optional=True, - ) - failover_ratio = proto.Field(proto.FLOAT, number=212667006, optional=True,) +class AggregatedListPublicDelegatedPrefixesRequest(proto.Message): + r"""A request message for PublicDelegatedPrefixes.AggregatedList. + See the method description for details. -class BackendServiceIAP(proto.Message): - r"""Identity-Aware Proxy Attributes: - enabled (bool): - Whether the serving infrastructure will - authenticate and authorize all incoming - requests. If true, the oauth2ClientId and - oauth2ClientSecret fields must be non-empty. - oauth2_client_id (str): - OAuth2 client ID to use for the - authentication flow. - oauth2_client_secret (str): - OAuth2 client secret to use for the - authentication flow. For security reasons, this - value cannot be retrieved via the API. Instead, - the SHA-256 hash of the value is returned in the - oauth2ClientSecretSha256 field. - oauth2_client_secret_sha256 (str): - [Output Only] SHA256 hash value for the field - oauth2_client_secret above. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Name of the project scoping this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - enabled = proto.Field(proto.BOOL, number=1018689, optional=True,) - oauth2_client_id = proto.Field(proto.STRING, number=314017611, optional=True,) - oauth2_client_secret = proto.Field(proto.STRING, number=50999520, optional=True,) - oauth2_client_secret_sha256 = proto.Field( - proto.STRING, number=112903782, optional=True, - ) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class BackendServiceLogConfig(proto.Message): - r"""The available logging options for the load balancer traffic - served by this backend service. +class AggregatedListRegionCommitmentsRequest(proto.Message): + r"""A request message for RegionCommitments.AggregatedList. See + the method description for details. Attributes: - enable (bool): - This field denotes whether to enable logging - for the load balancer traffic served by this - backend service. - sample_rate (float): - This field can only be specified if logging is enabled for - this backend service. The value of the field must be in [0, - 1]. This configures the sampling rate of requests to the - load balancer where 1.0 means all logged requests are - reported and 0.0 means no logged requests are reported. The - default value is 1.0. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - enable = proto.Field(proto.BOOL, number=311764355, optional=True,) - sample_rate = proto.Field(proto.FLOAT, number=153193045, optional=True,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class Duration(proto.Message): - r"""A Duration represents a fixed-length span of time represented - as a count of seconds and fractions of seconds at nanosecond - resolution. It is independent of any calendar and concepts like - "day" or "month". Range is approximately 10,000 years. +class AggregatedListReservationsRequest(proto.Message): + r"""A request message for Reservations.AggregatedList. See the + method description for details. Attributes: - nanos (int): - Span of time that's a fraction of a second at nanosecond - resolution. Durations less than one second are represented - with a 0 ``seconds`` field and a positive ``nanos`` field. - Must be from 0 to 999,999,999 inclusive. - seconds (int): - Span of time at a resolution of a second. Must be from 0 to - 315,576,000,000 inclusive. Note: these bounds are computed - from: 60 sec/min \* 60 min/hr \* 24 hr/day \* 365.25 - days/year \* 10000 years + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - nanos = proto.Field(proto.INT32, number=104586303, optional=True,) - seconds = proto.Field(proto.INT64, number=359484031, optional=True,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class OutlierDetection(proto.Message): - r"""Settings controlling the eviction of unhealthy hosts from the - load balancing pool for the backend service. +class AggregatedListResourcePoliciesRequest(proto.Message): + r"""A request message for ResourcePolicies.AggregatedList. See + the method description for details. Attributes: - base_ejection_time (google.cloud.compute_v1.types.Duration): - The base time that a host is ejected for. The - real ejection time is equal to the base ejection - time multiplied by the number of times the host - has been ejected. Defaults to 30000ms or 30s. - consecutive_errors (int): - Number of errors before a host is ejected - from the connection pool. When the backend host - is accessed over HTTP, a 5xx return code - qualifies as an error. Defaults to 5. - consecutive_gateway_failure (int): - The number of consecutive gateway failures - (502, 503, 504 status or connection errors that - are mapped to one of those status codes) before - a consecutive gateway failure ejection occurs. - Defaults to 3. - enforcing_consecutive_errors (int): - The percentage chance that a host will be - actually ejected when an outlier status is - detected through consecutive 5xx. This setting - can be used to disable ejection or to ramp it up - slowly. Defaults to 0. - enforcing_consecutive_gateway_failure (int): - The percentage chance that a host will be - actually ejected when an outlier status is - detected through consecutive gateway failures. - This setting can be used to disable ejection or - to ramp it up slowly. Defaults to 100. - enforcing_success_rate (int): - The percentage chance that a host will be - actually ejected when an outlier status is - detected through success rate statistics. This - setting can be used to disable ejection or to - ramp it up slowly. Defaults to 100. - interval (google.cloud.compute_v1.types.Duration): - Time interval between ejection analysis - sweeps. This can result in both new ejections as - well as hosts being returned to service. - Defaults to 1 second. - max_ejection_percent (int): - Maximum percentage of hosts in the load - balancing pool for the backend service that can - be ejected. Defaults to 50%. - success_rate_minimum_hosts (int): - The number of hosts in a cluster that must - have enough request volume to detect success - rate outliers. If the number of hosts is less - than this setting, outlier detection via success - rate statistics is not performed for any host in - the cluster. Defaults to 5. - success_rate_request_volume (int): - The minimum number of total requests that - must be collected in one interval (as defined by - the interval duration above) to include this - host in success rate based outlier detection. If - the volume is lower than this setting, outlier - detection via success rate statistics is not - performed for that host. Defaults to 100. - success_rate_stdev_factor (int): - This factor is used to determine the ejection threshold for - success rate outlier ejection. The ejection threshold is the - difference between the mean success rate, and the product of - this factor and the standard deviation of the mean success - rate: mean - (stdev \* success_rate_stdev_factor). This - factor is divided by a thousand to get a double. That is, if - the desired factor is 1.9, the runtime value should be 1900. - Defaults to 1900. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - base_ejection_time = proto.Field( - proto.MESSAGE, number=80997255, optional=True, message="Duration", - ) - consecutive_errors = proto.Field(proto.INT32, number=387193248, optional=True,) - consecutive_gateway_failure = proto.Field( - proto.INT32, number=417504250, optional=True, - ) - enforcing_consecutive_errors = proto.Field( - proto.INT32, number=213133760, optional=True, - ) - enforcing_consecutive_gateway_failure = proto.Field( - proto.INT32, number=394440666, optional=True, - ) - enforcing_success_rate = proto.Field(proto.INT32, number=194508732, optional=True,) - interval = proto.Field( - proto.MESSAGE, number=33547461, optional=True, message="Duration", - ) - max_ejection_percent = proto.Field(proto.INT32, number=18436888, optional=True,) - success_rate_minimum_hosts = proto.Field( - proto.INT32, number=525766903, optional=True, - ) - success_rate_request_volume = proto.Field( - proto.INT32, number=281425357, optional=True, - ) - success_rate_stdev_factor = proto.Field( - proto.INT32, number=174735773, optional=True, - ) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class SecuritySettings(proto.Message): - r"""The authentication and authorization settings for a - BackendService. +class AggregatedListRoutersRequest(proto.Message): + r"""A request message for Routers.AggregatedList. See the method + description for details. Attributes: - client_tls_policy (str): - Optional. A URL referring to a - networksecurity.ClientTlsPolicy resource that describes how - clients should authenticate with this service's backends. - clientTlsPolicy only applies to a global BackendService with - the loadBalancingScheme set to INTERNAL_SELF_MANAGED. If - left blank, communications are not encrypted. Note: This - field currently has no impact. - subject_alt_names (Sequence[str]): - Optional. A list of Subject Alternative Names (SANs) that - the client verifies during a mutual TLS handshake with an - server/endpoint for this BackendService. When the server - presents its X.509 certificate to the client, the client - inspects the certificate's subjectAltName field. If the - field contains one of the specified values, the - communication continues. Otherwise, it fails. This - additional check enables the client to verify that the - server is authorized to run the requested service. Note that - the contents of the server certificate's subjectAltName - field are configured by the Public Key Infrastructure which - provisions server identities. Only applies to a global - BackendService with loadBalancingScheme set to - INTERNAL_SELF_MANAGED. Only applies when BackendService has - an attached clientTlsPolicy with clientCertificate (mTLS - mode). Note: This field currently has no impact. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - client_tls_policy = proto.Field(proto.STRING, number=462325226, optional=True,) - subject_alt_names = proto.RepeatedField(proto.STRING, number=330029535,) - - -class BackendService(proto.Message): - r"""Represents a Backend Service resource. - - A backend service defines how Google Cloud load balancers distribute - traffic. The backend service configuration contains a set of values, - such as the protocol used to connect to backends, various - distribution and session settings, health checks, and timeouts. - These settings provide fine-grained control over how your load - balancer behaves. Most of the settings have default values that - allow for easy configuration if you need to get started quickly. - - Backend services in Google Compute Engine can be either regionally - or globally scoped. - - - `Global `__ - \* - `Regional `__ + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - For more information, see Backend Services. - (== resource_for {$api_version}.backendService ==) +class AggregatedListServiceAttachmentsRequest(proto.Message): + r"""A request message for ServiceAttachments.AggregatedList. See + the method description for details. Attributes: - affinity_cookie_ttl_sec (int): - Lifetime of cookies in seconds. Only applicable if the - loadBalancingScheme is EXTERNAL, INTERNAL_SELF_MANAGED, or - INTERNAL_MANAGED, the protocol is HTTP or HTTPS, and the - sessionAffinity is GENERATED_COOKIE, or HTTP_COOKIE. - - If set to 0, the cookie is non-persistent and lasts only - until the end of the browser session (or equivalent). The - maximum allowed value is one day (86,400). + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Name of the project scoping this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. + """ - Not supported when the backend service is referenced by a - URL map that is bound to target gRPC proxy that has - validateForProxyless field set to true. - backends (Sequence[google.cloud.compute_v1.types.Backend]): - The list of backends that serve this - BackendService. - cdn_policy (google.cloud.compute_v1.types.BackendServiceCdnPolicy): - Cloud CDN configuration for this - BackendService. Only available for external - HTTP(S) Load Balancing. - circuit_breakers (google.cloud.compute_v1.types.CircuitBreakers): - Settings controlling the volume of connections to a backend - service. If not set, this feature is considered disabled. + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - This field is applicable to either: - - A regional backend service with the service_protocol set - to HTTP, HTTPS, or HTTP2, and load_balancing_scheme set - to INTERNAL_MANAGED. - - A global backend service with the load_balancing_scheme - set to INTERNAL_SELF_MANAGED. +class AggregatedListSslCertificatesRequest(proto.Message): + r"""A request message for SslCertificates.AggregatedList. See the + method description for details. - Not supported when the backend service is referenced by a - URL map that is bound to target gRPC proxy that has - validateForProxyless field set to true. - connection_draining (google.cloud.compute_v1.types.ConnectionDraining): + Attributes: + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Name of the project scoping this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. + """ - consistent_hash (google.cloud.compute_v1.types.ConsistentHashLoadBalancerSettings): - Consistent Hash-based load balancing can be used to provide - soft session affinity based on HTTP headers, cookies or - other properties. This load balancing policy is applicable - only for HTTP connections. The affinity to a particular - destination host will be lost when one or more hosts are - added/removed from the destination service. This field - specifies parameters that control consistent hashing. This - field is only applicable when localityLbPolicy is set to - MAGLEV or RING_HASH. + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - This field is applicable to either: - - A regional backend service with the service_protocol set - to HTTP, HTTPS, or HTTP2, and load_balancing_scheme set - to INTERNAL_MANAGED. - - A global backend service with the load_balancing_scheme - set to INTERNAL_SELF_MANAGED. +class AggregatedListSubnetworksRequest(proto.Message): + r"""A request message for Subnetworks.AggregatedList. See the + method description for details. - Not supported when the backend service is referenced by a - URL map that is bound to target gRPC proxy that has - validateForProxyless field set to true. - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - custom_request_headers (Sequence[str]): - Headers that the HTTP/S load balancer should - add to proxied requests. - custom_response_headers (Sequence[str]): - Headers that the HTTP/S load balancer should - add to proxied responses. - description (str): - An optional description of this resource. - Provide this property when you create the - resource. - enable_c_d_n (bool): - If true, enables Cloud CDN for the backend - service. Only applicable if the - loadBalancingScheme is EXTERNAL and the protocol - is HTTP or HTTPS. - failover_policy (google.cloud.compute_v1.types.BackendServiceFailoverPolicy): - Applicable only to Failover for Internal - TCP/UDP Load Balancing and Network Load - Balancing. Requires at least one backend - instance group to be defined as a backup - (failover) backend. - fingerprint (str): - Fingerprint of this resource. A hash of the - contents stored in this object. This field is - used in optimistic locking. This field will be - ignored when inserting a BackendService. An up- - to-date fingerprint must be provided in order to - update the BackendService, otherwise the request - will fail with error 412 conditionNotMet. To - see the latest fingerprint, make a get() request - to retrieve a BackendService. - health_checks (Sequence[str]): - The list of URLs to the healthChecks, - httpHealthChecks (legacy), or httpsHealthChecks - (legacy) resource for health checking this - backend service. Not all backend services - support legacy health checks. See Load balancer - guide. Currently, at most one health check can - be specified for each backend service. Backend - services with instance group or zonal NEG - backends must have a health check. Backend - services with internet or serverless NEG - backends must not have a health check. - iap (google.cloud.compute_v1.types.BackendServiceIAP): - The configurations for Identity-Aware Proxy - on this resource. Not available for Internal - TCP/UDP Load Balancing and Network Load - Balancing. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - kind (str): - [Output Only] Type of resource. Always - compute#backendService for backend services. - load_balancing_scheme (google.cloud.compute_v1.types.BackendService.LoadBalancingScheme): - Specifies the load balancer type. Choose EXTERNAL for - external HTTP(S), SSL Proxy, TCP Proxy and Network Load - Balancing. Choose INTERNAL for Internal TCP/UDP Load - Balancing. Choose INTERNAL_MANAGED for Internal HTTP(S) Load - Balancing. INTERNAL_SELF_MANAGED for Traffic Director. A - backend service created for one type of load balancer cannot - be used with another. For more information, refer to - Choosing a load balancer. - locality_lb_policy (google.cloud.compute_v1.types.BackendService.LocalityLbPolicy): - The load balancing algorithm used within the scope of the - locality. The possible values are: - - - ROUND_ROBIN: This is a simple policy in which each - healthy backend is selected in round robin order. This is - the default. - - LEAST_REQUEST: An O(1) algorithm which selects two random - healthy hosts and picks the host which has fewer active - requests. - - RING_HASH: The ring/modulo hash load balancer implements - consistent hashing to backends. The algorithm has the - property that the addition/removal of a host from a set - of N hosts only affects 1/N of the requests. - - RANDOM: The load balancer selects a random healthy host. - - ORIGINAL_DESTINATION: Backend host is selected based on - the client connection metadata, i.e., connections are - opened to the same address as the destination address of - the incoming connection before the connection was - redirected to the load balancer. - - MAGLEV: used as a drop in replacement for the ring hash - load balancer. Maglev is not as stable as ring hash but - has faster table lookup build times and host selection - times. For more information about Maglev, see - https://ai.google/research/pubs/pub44824 - - This field is applicable to either: - - - A regional backend service with the service_protocol set - to HTTP, HTTPS, or HTTP2, and load_balancing_scheme set - to INTERNAL_MANAGED. - - A global backend service with the load_balancing_scheme - set to INTERNAL_SELF_MANAGED. - - If sessionAffinity is not NONE, and this field is not set to - MAGLEV or RING_HASH, session affinity settings will not take - effect. - - Only the default ROUND_ROBIN policy is supported when the - backend service is referenced by a URL map that is bound to - target gRPC proxy that has validateForProxyless field set to - true. - log_config (google.cloud.compute_v1.types.BackendServiceLogConfig): - This field denotes the logging options for - the load balancer traffic served by this backend - service. If logging is enabled, logs will be - exported to Stackdriver. - max_stream_duration (google.cloud.compute_v1.types.Duration): - Specifies the default maximum duration (timeout) for streams - to this service. Duration is computed from the beginning of - the stream until the response has been completely processed, - including all retries. A stream that does not complete in - this duration is closed. If not specified, there will be no - timeout limit, i.e. the maximum duration is infinite. This - field is only allowed when the loadBalancingScheme of the - backend service is INTERNAL_SELF_MANAGED. - name (str): - Name of the resource. Provided by the client when the - resource is created. The name must be 1-63 characters long, - and comply with RFC1035. Specifically, the name must be 1-63 - characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. - network (str): - The URL of the network to which this backend - service belongs. This field can only be - specified when the load balancing scheme is set - to INTERNAL. - outlier_detection (google.cloud.compute_v1.types.OutlierDetection): - Settings controlling the eviction of unhealthy hosts from - the load balancing pool for the backend service. If not set, - this feature is considered disabled. + Attributes: + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. + """ - This field is applicable to either: + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - - A regional backend service with the service_protocol set - to HTTP, HTTPS, or HTTP2, and load_balancing_scheme set - to INTERNAL_MANAGED. - - A global backend service with the load_balancing_scheme - set to INTERNAL_SELF_MANAGED. - Not supported when the backend service is referenced by a - URL map that is bound to target gRPC proxy that has - validateForProxyless field set to true. - port (int): - Deprecated in favor of portName. The TCP port - to connect on the backend. The default value is - 80. Backend services for Internal TCP/UDP Load - Balancing and Network Load Balancing require you - omit port. - port_name (str): - A named port on a backend instance group representing the - port for communication to the backend VMs in that group. - Required when the loadBalancingScheme is EXTERNAL (except - Network Load Balancing), INTERNAL_MANAGED, or - INTERNAL_SELF_MANAGED and the backends are instance groups. - The named port must be defined on each backend instance - group. This parameter has no meaning if the backends are - NEGs. - - Backend services for Internal TCP/UDP Load Balancing and - Network Load Balancing require you omit port_name. - protocol (google.cloud.compute_v1.types.BackendService.Protocol): - The protocol this BackendService uses to - communicate with backends. - Possible values are HTTP, HTTPS, HTTP2, TCP, - SSL, UDP or GRPC. depending on the chosen load - balancer or Traffic Director configuration. - Refer to the documentation for the load balancer - or for Traffic Director for more information. - Must be set to GRPC when the backend service is - referenced by a URL map that is bound to target - gRPC proxy. - region (str): - [Output Only] URL of the region where the regional backend - service resides. This field is not applicable to global - backend services. You must specify this field as part of the - HTTP request URL. It is not settable as a field in the - request body. - security_policy (str): - [Output Only] The resource URL for the security policy - associated with this backend service. - security_settings (google.cloud.compute_v1.types.SecuritySettings): - This field specifies the security policy that applies to - this backend service. This field is applicable to either: +class AggregatedListTargetHttpProxiesRequest(proto.Message): + r"""A request message for TargetHttpProxies.AggregatedList. See + the method description for details. - - A regional backend service with the service_protocol set - to HTTP, HTTPS, or HTTP2, and load_balancing_scheme set - to INTERNAL_MANAGED. - - A global backend service with the load_balancing_scheme - set to INTERNAL_SELF_MANAGED. - self_link (str): - [Output Only] Server-defined URL for the resource. - session_affinity (google.cloud.compute_v1.types.BackendService.SessionAffinity): - Type of session affinity to use. The default is NONE. + Attributes: + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Name of the project scoping this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. + """ - When the loadBalancingScheme is EXTERNAL: \* For Network - Load Balancing, the possible values are NONE, CLIENT_IP, - CLIENT_IP_PROTO, or CLIENT_IP_PORT_PROTO. \* For all other - load balancers that use loadBalancingScheme=EXTERNAL, the - possible values are NONE, CLIENT_IP, or GENERATED_COOKIE. \* - You can use GENERATED_COOKIE if the protocol is HTTP, HTTP2, - or HTTPS. + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - When the loadBalancingScheme is INTERNAL, possible values - are NONE, CLIENT_IP, CLIENT_IP_PROTO, or - CLIENT_IP_PORT_PROTO. - When the loadBalancingScheme is INTERNAL_SELF_MANAGED, or - INTERNAL_MANAGED, possible values are NONE, CLIENT_IP, - GENERATED_COOKIE, HEADER_FIELD, or HTTP_COOKIE. +class AggregatedListTargetHttpsProxiesRequest(proto.Message): + r"""A request message for TargetHttpsProxies.AggregatedList. See + the method description for details. - Not supported when the backend service is referenced by a - URL map that is bound to target gRPC proxy that has - validateForProxyless field set to true. - timeout_sec (int): - The backend service timeout has a different - meaning depending on the type of load balancer. - For more information see, Backend service - settings The default is 30 seconds. The full - range of timeout values allowed is 1 - - 2,147,483,647 seconds. + Attributes: + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Name of the project scoping this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - class LoadBalancingScheme(proto.Enum): - r"""Specifies the load balancer type. Choose EXTERNAL for external - HTTP(S), SSL Proxy, TCP Proxy and Network Load Balancing. Choose - INTERNAL for Internal TCP/UDP Load Balancing. Choose - INTERNAL_MANAGED for Internal HTTP(S) Load Balancing. - INTERNAL_SELF_MANAGED for Traffic Director. A backend service - created for one type of load balancer cannot be used with another. - For more information, refer to Choosing a load balancer. - """ - UNDEFINED_LOAD_BALANCING_SCHEME = 0 - EXTERNAL = 35607499 - INTERNAL = 279295677 - INTERNAL_MANAGED = 37350397 - INTERNAL_SELF_MANAGED = 236211150 - INVALID_LOAD_BALANCING_SCHEME = 275352060 + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - class LocalityLbPolicy(proto.Enum): - r"""The load balancing algorithm used within the scope of the locality. - The possible values are: - - - ROUND_ROBIN: This is a simple policy in which each healthy - backend is selected in round robin order. This is the default. - - LEAST_REQUEST: An O(1) algorithm which selects two random healthy - hosts and picks the host which has fewer active requests. - - RING_HASH: The ring/modulo hash load balancer implements - consistent hashing to backends. The algorithm has the property - that the addition/removal of a host from a set of N hosts only - affects 1/N of the requests. - - RANDOM: The load balancer selects a random healthy host. - - ORIGINAL_DESTINATION: Backend host is selected based on the - client connection metadata, i.e., connections are opened to the - same address as the destination address of the incoming - connection before the connection was redirected to the load - balancer. - - MAGLEV: used as a drop in replacement for the ring hash load - balancer. Maglev is not as stable as ring hash but has faster - table lookup build times and host selection times. For more - information about Maglev, see - https://ai.google/research/pubs/pub44824 - - This field is applicable to either: - - - A regional backend service with the service_protocol set to HTTP, - HTTPS, or HTTP2, and load_balancing_scheme set to - INTERNAL_MANAGED. - - A global backend service with the load_balancing_scheme set to - INTERNAL_SELF_MANAGED. - - If sessionAffinity is not NONE, and this field is not set to MAGLEV - or RING_HASH, session affinity settings will not take effect. - - Only the default ROUND_ROBIN policy is supported when the backend - service is referenced by a URL map that is bound to target gRPC - proxy that has validateForProxyless field set to true. - """ - UNDEFINED_LOCALITY_LB_POLICY = 0 - INVALID_LB_POLICY = 323318707 - LEAST_REQUEST = 46604921 - MAGLEV = 119180266 - ORIGINAL_DESTINATION = 166297216 - RANDOM = 262527171 - RING_HASH = 432795069 - ROUND_ROBIN = 153895801 - class Protocol(proto.Enum): - r"""The protocol this BackendService uses to communicate with - backends. - Possible values are HTTP, HTTPS, HTTP2, TCP, SSL, UDP or GRPC. - depending on the chosen load balancer or Traffic Director - configuration. Refer to the documentation for the load balancer - or for Traffic Director for more information. - Must be set to GRPC when the backend service is referenced by a - URL map that is bound to target gRPC proxy. - """ - UNDEFINED_PROTOCOL = 0 - GRPC = 2196510 - HTTP = 2228360 - HTTP2 = 69079210 - HTTPS = 69079243 - SSL = 82412 - TCP = 82881 - UDP = 83873 +class AggregatedListTargetInstancesRequest(proto.Message): + r"""A request message for TargetInstances.AggregatedList. See the + method description for details. + + Attributes: + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. + """ - class SessionAffinity(proto.Enum): - r"""Type of session affinity to use. The default is NONE. + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - When the loadBalancingScheme is EXTERNAL: \* For Network Load - Balancing, the possible values are NONE, CLIENT_IP, CLIENT_IP_PROTO, - or CLIENT_IP_PORT_PROTO. \* For all other load balancers that use - loadBalancingScheme=EXTERNAL, the possible values are NONE, - CLIENT_IP, or GENERATED_COOKIE. \* You can use GENERATED_COOKIE if - the protocol is HTTP, HTTP2, or HTTPS. - When the loadBalancingScheme is INTERNAL, possible values are NONE, - CLIENT_IP, CLIENT_IP_PROTO, or CLIENT_IP_PORT_PROTO. +class AggregatedListTargetPoolsRequest(proto.Message): + r"""A request message for TargetPools.AggregatedList. See the + method description for details. - When the loadBalancingScheme is INTERNAL_SELF_MANAGED, or - INTERNAL_MANAGED, possible values are NONE, CLIENT_IP, - GENERATED_COOKIE, HEADER_FIELD, or HTTP_COOKIE. + Attributes: + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. + """ - Not supported when the backend service is referenced by a URL map - that is bound to target gRPC proxy that has validateForProxyless - field set to true. - """ - UNDEFINED_SESSION_AFFINITY = 0 - CLIENT_IP = 345665051 - CLIENT_IP_NO_DESTINATION = 106122516 - CLIENT_IP_PORT_PROTO = 221722926 - CLIENT_IP_PROTO = 25322148 - GENERATED_COOKIE = 370321204 - HEADER_FIELD = 200737960 - HTTP_COOKIE = 494981627 - NONE = 2402104 + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - affinity_cookie_ttl_sec = proto.Field(proto.INT32, number=369996954, optional=True,) - backends = proto.RepeatedField(proto.MESSAGE, number=510839903, message="Backend",) - cdn_policy = proto.Field( - proto.MESSAGE, - number=213976452, - optional=True, - message="BackendServiceCdnPolicy", - ) - circuit_breakers = proto.Field( - proto.MESSAGE, number=421340061, optional=True, message="CircuitBreakers", - ) - connection_draining = proto.Field( - proto.MESSAGE, number=461096747, optional=True, message="ConnectionDraining", - ) - consistent_hash = proto.Field( - proto.MESSAGE, - number=905883, - optional=True, - message="ConsistentHashLoadBalancerSettings", - ) - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - custom_request_headers = proto.RepeatedField(proto.STRING, number=27977992,) - custom_response_headers = proto.RepeatedField(proto.STRING, number=387539094,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - enable_c_d_n = proto.Field(proto.BOOL, number=250733499, optional=True,) - failover_policy = proto.Field( - proto.MESSAGE, - number=105658655, - optional=True, - message="BackendServiceFailoverPolicy", - ) - fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) - health_checks = proto.RepeatedField(proto.STRING, number=448370606,) - iap = proto.Field( - proto.MESSAGE, number=104024, optional=True, message="BackendServiceIAP", - ) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - load_balancing_scheme = proto.Field( - proto.ENUM, number=363890244, optional=True, enum=LoadBalancingScheme, - ) - locality_lb_policy = proto.Field( - proto.ENUM, number=131431487, optional=True, enum=LocalityLbPolicy, - ) - log_config = proto.Field( - proto.MESSAGE, - number=351299741, - optional=True, - message="BackendServiceLogConfig", - ) - max_stream_duration = proto.Field( - proto.MESSAGE, number=61428376, optional=True, message="Duration", - ) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - network = proto.Field(proto.STRING, number=232872494, optional=True,) - outlier_detection = proto.Field( - proto.MESSAGE, number=354625086, optional=True, message="OutlierDetection", - ) - port = proto.Field(proto.INT32, number=3446913, optional=True,) - port_name = proto.Field(proto.STRING, number=41534345, optional=True,) - protocol = proto.Field(proto.ENUM, number=84577944, optional=True, enum=Protocol,) - region = proto.Field(proto.STRING, number=138946292, optional=True,) - security_policy = proto.Field(proto.STRING, number=171082513, optional=True,) - security_settings = proto.Field( - proto.MESSAGE, number=478649922, optional=True, message="SecuritySettings", - ) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - session_affinity = proto.Field( - proto.ENUM, number=463888561, optional=True, enum=SessionAffinity, - ) - timeout_sec = proto.Field(proto.INT32, number=79994995, optional=True,) +class AggregatedListTargetVpnGatewaysRequest(proto.Message): + r"""A request message for TargetVpnGateways.AggregatedList. See + the method description for details. -class BackendServicesScopedList(proto.Message): - r""" Attributes: - backend_services (Sequence[google.cloud.compute_v1.types.BackendService]): - A list of BackendServices contained in this - scope. - warning (google.cloud.compute_v1.types.Warning): - Informational warning which replaces the list - of backend services when the list is empty. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - backend_services = proto.RepeatedField( - proto.MESSAGE, number=388522409, message="BackendService", - ) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class BackendServiceAggregatedList(proto.Message): - r"""Contains a list of BackendServicesScopedList. +class AggregatedListUrlMapsRequest(proto.Message): + r"""A request message for UrlMaps.AggregatedList. See the method + description for details. + Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.BackendServiceAggregatedList.ItemsEntry]): - A list of BackendServicesScopedList - resources. - kind (str): - Type of resource. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - unreachables (Sequence[str]): - [Output Only] Unreachable resources. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Name of the project scoping this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.MapField( - proto.STRING, - proto.MESSAGE, - number=100526016, - message="BackendServicesScopedList", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - unreachables = proto.RepeatedField(proto.STRING, number=243372063,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class BackendServiceCdnPolicyBypassCacheOnRequestHeader(proto.Message): - r"""Bypass the cache when the specified request headers are present, - e.g. Pragma or Authorization headers. Values are case insensitive. - The presence of such a header overrides the cache_mode setting. +class AggregatedListVpnGatewaysRequest(proto.Message): + r"""A request message for VpnGateways.AggregatedList. See the + method description for details. Attributes: - header_name (str): - The header field name to match on when - bypassing cache. Values are case-insensitive. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - header_name = proto.Field(proto.STRING, number=110223613, optional=True,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class CacheKeyPolicy(proto.Message): - r"""Message containing what to include in the cache key for a - request for Cloud CDN. +class AggregatedListVpnTunnelsRequest(proto.Message): + r"""A request message for VpnTunnels.AggregatedList. See the + method description for details. Attributes: - include_host (bool): - If true, requests to different hosts will be - cached separately. - include_protocol (bool): - If true, http and https requests will be - cached separately. - include_query_string (bool): - If true, include query string parameters in the cache key - according to query_string_whitelist and - query_string_blacklist. If neither is set, the entire query - string will be included. If false, the query string will be - excluded from the cache key entirely. - query_string_blacklist (Sequence[str]): - Names of query string parameters to exclude in cache keys. - All other parameters will be included. Either specify - query_string_whitelist or query_string_blacklist, not both. - '&' and '=' will be percent encoded and not treated as - delimiters. - query_string_whitelist (Sequence[str]): - Names of query string parameters to include in cache keys. - All other parameters will be excluded. Either specify - query_string_whitelist or query_string_blacklist, not both. - '&' and '=' will be percent encoded and not treated as - delimiters. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + include_all_scopes (bool): + Indicates whether every visible scope for + each scope type (zone, region, global) should be + included in the response. For new resource types + added after this field, the flag has no effect + as new resource types will always include every + visible scope for each scope type in response. + For resource types which predate this field, if + this flag is omitted or false, only scopes of + the scope types where the resource type is + expected to be found will be included. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - include_host = proto.Field(proto.BOOL, number=486867679, optional=True,) - include_protocol = proto.Field(proto.BOOL, number=303507535, optional=True,) - include_query_string = proto.Field(proto.BOOL, number=474036639, optional=True,) - query_string_blacklist = proto.RepeatedField(proto.STRING, number=354964742,) - query_string_whitelist = proto.RepeatedField(proto.STRING, number=52456496,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class BackendServiceCdnPolicyNegativeCachingPolicy(proto.Message): - r"""Specify CDN TTLs for response error codes. +class AliasIpRange(proto.Message): + r"""An alias IP range attached to an instance's network + interface. + Attributes: - code (int): - The HTTP status code to define a TTL against. - Only HTTP status codes 300, 301, 302, 307, 308, - 404, 405, 410, 421, 451 and 501 are can be - specified as values, and you cannot specify a - status code more than once. - ttl (int): - The TTL (in seconds) for which to cache - responses with the corresponding status code. - The maximum allowed value is 1800s (30 minutes), - noting that infrequently accessed objects may be - evicted from the cache before the defined TTL. + ip_cidr_range (str): + The IP alias ranges to allocate for this + interface. This IP CIDR range must belong to the + specified subnetwork and cannot contain IP + addresses reserved by system or used by other + network interfaces. This range may be a single + IP address (such as 10.2.3.4), a netmask (such + as /24) or a CIDR-formatted string (such as + 10.1.2.0/24). + subnetwork_range_name (str): + The name of a subnetwork secondary IP range + from which to allocate an IP alias range. If not + specified, the primary range of the subnetwork + is used. """ - code = proto.Field(proto.INT32, number=3059181, optional=True,) - ttl = proto.Field(proto.INT32, number=115180, optional=True,) + ip_cidr_range = proto.Field(proto.STRING, number=98117322, optional=True,) + subnetwork_range_name = proto.Field(proto.STRING, number=387995966, optional=True,) -class HealthStatus(proto.Message): +class AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk( + proto.Message +): r""" Attributes: - annotations (Sequence[google.cloud.compute_v1.types.HealthStatus.AnnotationsEntry]): - Metadata defined as annotations for network - endpoint. - forwarding_rule (str): - URL of the forwarding rule associated with - the health status of the instance. - forwarding_rule_ip (str): - A forwarding rule IP address assigned to this - instance. - health_state (google.cloud.compute_v1.types.HealthStatus.HealthState): - Health state of the instance. - instance (str): - URL of the instance resource. - ip_address (str): - For target pool based Network Load Balancing, - it indicates the forwarding rule's IP address - assigned to this instance. For other types of - load balancing, the field indicates VM internal - ip. - port (int): - The named port of the instance group, not - necessarily the port that is health-checked. - weight (str): - - weight_error (google.cloud.compute_v1.types.HealthStatus.WeightError): - + disk_size_gb (int): + Specifies the size of the disk in base-2 GB. + interface (google.cloud.compute_v1.types.AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk.Interface): + Specifies the disk interface to use for + attaching this disk, which is either SCSI or + NVME. The default is SCSI. For performance + characteristics of SCSI over NVMe, see Local SSD + performance. """ - class HealthState(proto.Enum): - r"""Health state of the instance.""" - UNDEFINED_HEALTH_STATE = 0 - HEALTHY = 439801213 - UNHEALTHY = 462118084 - - class WeightError(proto.Enum): - r"""""" - UNDEFINED_WEIGHT_ERROR = 0 - INVALID_WEIGHT = 383698400 - MISSING_WEIGHT = 384027537 - UNAVAILABLE_WEIGHT = 439464295 - WEIGHT_NONE = 502428831 + class Interface(proto.Enum): + r"""Specifies the disk interface to use for attaching this disk, + which is either SCSI or NVME. The default is SCSI. For + performance characteristics of SCSI over NVMe, see Local SSD + performance. + """ + UNDEFINED_INTERFACE = 0 + NVME = 2408800 + SCSI = 2539686 - annotations = proto.MapField(proto.STRING, proto.STRING, number=112032548,) - forwarding_rule = proto.Field(proto.STRING, number=269964030, optional=True,) - forwarding_rule_ip = proto.Field(proto.STRING, number=172250632, optional=True,) - health_state = proto.Field( - proto.ENUM, number=324007150, optional=True, enum=HealthState, - ) - instance = proto.Field(proto.STRING, number=18257045, optional=True,) - ip_address = proto.Field(proto.STRING, number=406272220, optional=True,) - port = proto.Field(proto.INT32, number=3446913, optional=True,) - weight = proto.Field(proto.STRING, number=282149496, optional=True,) - weight_error = proto.Field( - proto.ENUM, number=522501505, optional=True, enum=WeightError, + disk_size_gb = proto.Field(proto.INT64, number=316263735, optional=True,) + interface = proto.Field( + proto.ENUM, number=502623545, optional=True, enum=Interface, ) -class BackendServiceGroupHealth(proto.Message): - r""" +class AllocationSpecificSKUAllocationReservedInstanceProperties(proto.Message): + r"""Properties of the SKU instances being reserved. Next ID: 9 Attributes: - annotations (Sequence[google.cloud.compute_v1.types.BackendServiceGroupHealth.AnnotationsEntry]): - Metadata defined as annotations on the - network endpoint group. - health_status (Sequence[google.cloud.compute_v1.types.HealthStatus]): - Health state of the backend instances or - endpoints in requested instance or network - endpoint group, determined based on configured - health checks. - kind (str): - [Output Only] Type of resource. Always - compute#backendServiceGroupHealth for the health of backend - services. + guest_accelerators (Sequence[google.cloud.compute_v1.types.AcceleratorConfig]): + Specifies accelerator type and count. + local_ssds (Sequence[google.cloud.compute_v1.types.AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk]): + Specifies amount of local ssd to reserve with + each instance. The type of disk is local-ssd. + location_hint (str): + An opaque location hint used to place the + allocation close to other resources. This field + is for use by internal tools that use the public + API. + machine_type (str): + Specifies type of machine (name only) which has fixed number + of vCPUs and fixed amount of memory. This also includes + specifying custom machine type following + custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern. + min_cpu_platform (str): + Minimum cpu platform the reservation. """ - annotations = proto.MapField(proto.STRING, proto.STRING, number=112032548,) - health_status = proto.RepeatedField( - proto.MESSAGE, number=380545845, message="HealthStatus", + guest_accelerators = proto.RepeatedField( + proto.MESSAGE, number=463595119, message="AcceleratorConfig", ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) + local_ssds = proto.RepeatedField( + proto.MESSAGE, + number=229951299, + message="AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk", + ) + location_hint = proto.Field(proto.STRING, number=350519505, optional=True,) + machine_type = proto.Field(proto.STRING, number=227711026, optional=True,) + min_cpu_platform = proto.Field(proto.STRING, number=242912759, optional=True,) -class BackendServiceList(proto.Message): - r"""Contains a list of BackendService resources. +class AllocationSpecificSKUReservation(proto.Message): + r"""This reservation type allows to pre allocate specific + instance configuration. Next ID: 5 + Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.BackendService]): - A list of BackendService resources. - kind (str): - [Output Only] Type of resource. Always - compute#backendServiceList for lists of backend services. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + count (int): + Specifies the number of resources that are + allocated. + in_use_count (int): + [Output Only] Indicates how many instances are in use. + instance_properties (google.cloud.compute_v1.types.AllocationSpecificSKUAllocationReservedInstanceProperties): + The instance properties for the reservation. """ - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="BackendService", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + count = proto.Field(proto.INT64, number=94851343, optional=True,) + in_use_count = proto.Field(proto.INT64, number=493458877, optional=True,) + instance_properties = proto.Field( + proto.MESSAGE, + number=215355165, + optional=True, + message="AllocationSpecificSKUAllocationReservedInstanceProperties", ) -class BackendServiceReference(proto.Message): +class Allowed(proto.Message): r""" Attributes: - backend_service (str): - + I_p_protocol (str): + The IP protocol to which this rule applies. + The protocol type is required when creating a + firewall rule. This value can either be one of + the following well known protocol strings (tcp, + udp, icmp, esp, ah, ipip, sctp) or the IP + protocol number. + ports (Sequence[str]): + An optional list of ports to which this rule applies. This + field is only applicable for the UDP or TCP protocol. Each + entry must be either an integer or a range. If not + specified, this rule applies to connections through any + port. Example inputs include: ["22"], ["80","443"], and + ["12345-12349"]. """ - backend_service = proto.Field(proto.STRING, number=306946058, optional=True,) - - -class Expr(proto.Message): - r"""Represents a textual expression in the Common Expression Language - (CEL) syntax. CEL is a C-like expression language. The syntax and - semantics of CEL are documented at - https://github.com/google/cel-spec. - - Example (Comparison): - - title: "Summary size limit" description: "Determines if a summary is - less than 100 chars" expression: "document.summary.size() < 100" - - Example (Equality): - - title: "Requestor is owner" description: "Determines if requestor is - the document owner" expression: "document.owner == - request.auth.claims.email" - - Example (Logic): - - title: "Public documents" description: "Determine whether the - document should be publicly visible" expression: "document.type != - 'private' && document.type != 'internal'" - - Example (Data Manipulation): + I_p_protocol = proto.Field(proto.STRING, number=488094525, optional=True,) + ports = proto.RepeatedField(proto.STRING, number=106854418,) - title: "Notification string" description: "Create a notification - string with a timestamp." expression: "'New message received at ' + - string(document.create_time)" - The exact variables and functions that may be referenced within an - expression are determined by the service that evaluates it. See the - service documentation for additional information. +class ApplyUpdatesToInstancesInstanceGroupManagerRequest(proto.Message): + r"""A request message for + InstanceGroupManagers.ApplyUpdatesToInstances. See the method + description for details. Attributes: - description (str): - Optional. Description of the expression. This - is a longer text which describes the expression, - e.g. when hovered over it in a UI. - expression (str): - Textual representation of an expression in - Common Expression Language syntax. - location (str): - Optional. String indicating the location of - the expression for error reporting, e.g. a file - name and a position in the file. - title (str): - Optional. Title for the expression, i.e. a - short string describing its purpose. This can be - used e.g. in UIs which allow to enter the - expression. + instance_group_manager (str): + The name of the managed instance group, + should conform to RFC1035. + instance_group_managers_apply_updates_request_resource (google.cloud.compute_v1.types.InstanceGroupManagersApplyUpdatesRequest): + The body resource for this request + project (str): + Project ID for this request. + zone (str): + The name of the zone where the managed + instance group is located. Should conform to + RFC1035. """ - description = proto.Field(proto.STRING, number=422937596, optional=True,) - expression = proto.Field(proto.STRING, number=352031384, optional=True,) - location = proto.Field(proto.STRING, number=290430901, optional=True,) - title = proto.Field(proto.STRING, number=110371416, optional=True,) + instance_group_manager = proto.Field(proto.STRING, number=249363395,) + instance_group_managers_apply_updates_request_resource = proto.Field( + proto.MESSAGE, + number=259242835, + message="InstanceGroupManagersApplyUpdatesRequest", + ) + project = proto.Field(proto.STRING, number=227560217,) + zone = proto.Field(proto.STRING, number=3744684,) -class Binding(proto.Message): - r"""Associates ``members`` with a ``role``. - Attributes: - binding_id (str): +class ApplyUpdatesToInstancesRegionInstanceGroupManagerRequest(proto.Message): + r"""A request message for + RegionInstanceGroupManagers.ApplyUpdatesToInstances. See the + method description for details. - condition (google.cloud.compute_v1.types.Expr): - The condition that is associated with this binding. + Attributes: + instance_group_manager (str): + The name of the managed instance group, + should conform to RFC1035. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request, + should conform to RFC1035. + region_instance_group_managers_apply_updates_request_resource (google.cloud.compute_v1.types.RegionInstanceGroupManagersApplyUpdatesRequest): + The body resource for this request + """ - If the condition evaluates to ``true``, then this binding - applies to the current request. + instance_group_manager = proto.Field(proto.STRING, number=249363395,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + region_instance_group_managers_apply_updates_request_resource = proto.Field( + proto.MESSAGE, + number=76248318, + message="RegionInstanceGroupManagersApplyUpdatesRequest", + ) - If the condition evaluates to ``false``, then this binding - does not apply to the current request. However, a different - role binding might grant the same role to one or more of the - members in this binding. - To learn which resources support conditions in their IAM - policies, see the `IAM - documentation `__. - members (Sequence[str]): - Specifies the identities requesting access for a Cloud - Platform resource. ``members`` can have the following - values: +class AttachDiskInstanceRequest(proto.Message): + r"""A request message for Instances.AttachDisk. See the method + description for details. - - ``allUsers``: A special identifier that represents anyone - who is on the internet; with or without a Google account. - - - ``allAuthenticatedUsers``: A special identifier that - represents anyone who is authenticated with a Google - account or a service account. - - - ``user:{emailid}``: An email address that represents a - specific Google account. For example, - ``alice@example.com`` . - - - ``serviceAccount:{emailid}``: An email address that - represents a service account. For example, - ``my-other-app@appspot.gserviceaccount.com``. - - - ``group:{emailid}``: An email address that represents a - Google group. For example, ``admins@example.com``. - - - ``deleted:user:{emailid}?uid={uniqueid}``: An email - address (plus unique identifier) representing a user that - has been recently deleted. For example, - ``alice@example.com?uid=123456789012345678901``. If the - user is recovered, this value reverts to - ``user:{emailid}`` and the recovered user retains the - role in the binding. - - - ``deleted:serviceAccount:{emailid}?uid={uniqueid}``: An - email address (plus unique identifier) representing a - service account that has been recently deleted. For - example, - ``my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901``. - If the service account is undeleted, this value reverts - to ``serviceAccount:{emailid}`` and the undeleted service - account retains the role in the binding. - - - ``deleted:group:{emailid}?uid={uniqueid}``: An email - address (plus unique identifier) representing a Google - group that has been recently deleted. For example, - ``admins@example.com?uid=123456789012345678901``. If the - group is recovered, this value reverts to - ``group:{emailid}`` and the recovered group retains the - role in the binding. - - - ``domain:{domain}``: The G Suite domain (primary) that - represents all the users of that domain. For example, - ``google.com`` or ``example.com``. - role (str): - Role that is assigned to ``members``. For example, - ``roles/viewer``, ``roles/editor``, or ``roles/owner``. + Attributes: + attached_disk_resource (google.cloud.compute_v1.types.AttachedDisk): + The body resource for this request + force_attach (bool): + Whether to force attach the regional disk + even if it's currently attached to another + instance. If you try to force attach a zonal + disk to an instance, you will receive an error. + instance (str): + The instance name for this request. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. """ - binding_id = proto.Field(proto.STRING, number=441088277, optional=True,) - condition = proto.Field( - proto.MESSAGE, number=212430107, optional=True, message="Expr", + attached_disk_resource = proto.Field( + proto.MESSAGE, number=90605845, message="AttachedDisk", ) - members = proto.RepeatedField(proto.STRING, number=412010777,) - role = proto.Field(proto.STRING, number=3506294, optional=True,) + force_attach = proto.Field(proto.BOOL, number=142758425, optional=True,) + instance = proto.Field(proto.STRING, number=18257045,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class InstanceProperties(proto.Message): - r""" - Attributes: - advanced_machine_features (google.cloud.compute_v1.types.AdvancedMachineFeatures): - Controls for advanced machine-related - behavior features. - can_ip_forward (bool): - Enables instances created based on these - properties to send packets with source IP - addresses other than their own and receive - packets with destination IP addresses other than - their own. If these instances will be used as an - IP gateway or it will be set as the next-hop in - a Route resource, specify true. If unsure, leave - this set to false. See the Enable IP forwarding - documentation for more information. - confidential_instance_config (google.cloud.compute_v1.types.ConfidentialInstanceConfig): - Specifies the Confidential Instance options. - description (str): - An optional text description for the - instances that are created from these - properties. - disks (Sequence[google.cloud.compute_v1.types.AttachedDisk]): - An array of disks that are associated with - the instances that are created from these - properties. - guest_accelerators (Sequence[google.cloud.compute_v1.types.AcceleratorConfig]): - A list of guest accelerator cards' type and - count to use for instances created from these - properties. - labels (Sequence[google.cloud.compute_v1.types.InstanceProperties.LabelsEntry]): - Labels to apply to instances that are created - from these properties. - machine_type (str): - The machine type to use for instances that - are created from these properties. - metadata (google.cloud.compute_v1.types.Metadata): - The metadata key/value pairs to assign to - instances that are created from these - properties. These pairs can consist of custom - metadata or predefined keys. See Project and - instance metadata for more information. - min_cpu_platform (str): - Minimum cpu/platform to be used by instances. - The instance may be scheduled on the specified - or newer cpu/platform. Applicable values are the - friendly names of CPU platforms, such as - minCpuPlatform: "Intel Haswell" or - minCpuPlatform: "Intel Sandy Bridge". For more - information, read Specifying a Minimum CPU - Platform. - network_interfaces (Sequence[google.cloud.compute_v1.types.NetworkInterface]): - An array of network access configurations for - this interface. - private_ipv6_google_access (google.cloud.compute_v1.types.InstanceProperties.PrivateIpv6GoogleAccess): - The private IPv6 google access type for VMs. If not - specified, use INHERIT_FROM_SUBNETWORK as default. - reservation_affinity (google.cloud.compute_v1.types.ReservationAffinity): - Specifies the reservations that instances can - consume from. - resource_policies (Sequence[str]): - Resource policies (names, not ULRs) applied - to instances created from these properties. - scheduling (google.cloud.compute_v1.types.Scheduling): - Specifies the scheduling options for the - instances that are created from these - properties. - service_accounts (Sequence[google.cloud.compute_v1.types.ServiceAccount]): - A list of service accounts with specified - scopes. Access tokens for these service accounts - are available to the instances that are created - from these properties. Use metadata queries to - obtain the access tokens for these instances. - shielded_instance_config (google.cloud.compute_v1.types.ShieldedInstanceConfig): +class AttachNetworkEndpointsGlobalNetworkEndpointGroupRequest(proto.Message): + r"""A request message for + GlobalNetworkEndpointGroups.AttachNetworkEndpoints. See the + method description for details. - tags (google.cloud.compute_v1.types.Tags): - A list of tags to apply to the instances that - are created from these properties. The tags - identify valid sources or targets for network - firewalls. The setTags method can modify this - list of tags. Each tag within the list must - comply with RFC1035. + Attributes: + global_network_endpoint_groups_attach_endpoints_request_resource (google.cloud.compute_v1.types.GlobalNetworkEndpointGroupsAttachEndpointsRequest): + The body resource for this request + network_endpoint_group (str): + The name of the network endpoint group where + you are attaching network endpoints to. It + should comply with RFC1035. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - class PrivateIpv6GoogleAccess(proto.Enum): - r"""The private IPv6 google access type for VMs. If not specified, use - INHERIT_FROM_SUBNETWORK as default. - """ - UNDEFINED_PRIVATE_IPV6_GOOGLE_ACCESS = 0 - ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE = 427975994 - ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE = 288210263 - INHERIT_FROM_SUBNETWORK = 530256959 - - advanced_machine_features = proto.Field( - proto.MESSAGE, - number=409646002, - optional=True, - message="AdvancedMachineFeatures", - ) - can_ip_forward = proto.Field(proto.BOOL, number=467731324, optional=True,) - confidential_instance_config = proto.Field( + global_network_endpoint_groups_attach_endpoints_request_resource = proto.Field( proto.MESSAGE, - number=490637685, - optional=True, - message="ConfidentialInstanceConfig", - ) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - disks = proto.RepeatedField(proto.MESSAGE, number=95594102, message="AttachedDisk",) - guest_accelerators = proto.RepeatedField( - proto.MESSAGE, number=463595119, message="AcceleratorConfig", - ) - labels = proto.MapField(proto.STRING, proto.STRING, number=500195327,) - machine_type = proto.Field(proto.STRING, number=227711026, optional=True,) - metadata = proto.Field( - proto.MESSAGE, number=86866735, optional=True, message="Metadata", - ) - min_cpu_platform = proto.Field(proto.STRING, number=242912759, optional=True,) - network_interfaces = proto.RepeatedField( - proto.MESSAGE, number=52735243, message="NetworkInterface", - ) - private_ipv6_google_access = proto.Field( - proto.ENUM, number=48277006, optional=True, enum=PrivateIpv6GoogleAccess, - ) - reservation_affinity = proto.Field( - proto.MESSAGE, number=157850683, optional=True, message="ReservationAffinity", - ) - resource_policies = proto.RepeatedField(proto.STRING, number=22220385,) - scheduling = proto.Field( - proto.MESSAGE, number=386688404, optional=True, message="Scheduling", - ) - service_accounts = proto.RepeatedField( - proto.MESSAGE, number=277537328, message="ServiceAccount", - ) - shielded_instance_config = proto.Field( - proto.MESSAGE, number=12862901, optional=True, message="ShieldedInstanceConfig", + number=30691563, + message="GlobalNetworkEndpointGroupsAttachEndpointsRequest", ) - tags = proto.Field(proto.MESSAGE, number=3552281, optional=True, message="Tags",) + network_endpoint_group = proto.Field(proto.STRING, number=433907078,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class LocationPolicy(proto.Message): - r"""Configuration for location policy among multiple possible - locations (e.g. preferences for zone selection among zones in a - single region). +class AttachNetworkEndpointsNetworkEndpointGroupRequest(proto.Message): + r"""A request message for + NetworkEndpointGroups.AttachNetworkEndpoints. See the method + description for details. Attributes: - locations (Sequence[google.cloud.compute_v1.types.LocationPolicy.LocationsEntry]): - Location configurations mapped by location - name. Currently only zone names are supported - and must be represented as valid internal URLs, - such as zones/us-central1-a. + network_endpoint_group (str): + The name of the network endpoint group where + you are attaching network endpoints to. It + should comply with RFC1035. + network_endpoint_groups_attach_endpoints_request_resource (google.cloud.compute_v1.types.NetworkEndpointGroupsAttachEndpointsRequest): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone where the network + endpoint group is located. It should comply with + RFC1035. """ - locations = proto.MapField( - proto.STRING, proto.MESSAGE, number=413423454, message="LocationPolicyLocation", + network_endpoint_group = proto.Field(proto.STRING, number=433907078,) + network_endpoint_groups_attach_endpoints_request_resource = proto.Field( + proto.MESSAGE, + number=531079, + message="NetworkEndpointGroupsAttachEndpointsRequest", ) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class BulkInsertInstanceResourcePerInstanceProperties(proto.Message): - r"""Per-instance properties to be set on individual instances. To - be extended in the future. - +class AttachedDisk(proto.Message): + r"""An instance-attached disk resource. Attributes: - name (str): - This field is only temporary. It will be - removed. Do not use it. + auto_delete (bool): + Specifies whether the disk will be auto- + eleted when the instance is deleted (but not + when the disk is detached from the instance). + boot (bool): + Indicates that this is a boot disk. The + virtual machine will use the first partition of + the disk for its root filesystem. + device_name (str): + Specifies a unique device name of your choice that is + reflected into the /dev/disk/by-id/google-\* tree of a Linux + operating system running within the instance. This name can + be used to reference the device for mounting, resizing, and + so on, from within the instance. If not specified, the + server chooses a default device name to apply to this disk, + in the form persistent-disk-x, where x is a number assigned + by Google Compute Engine. This field is only applicable for + persistent disks. + disk_encryption_key (google.cloud.compute_v1.types.CustomerEncryptionKey): + Encrypts or decrypts a disk using a customer- + upplied encryption key. If you are creating a + new disk, this field encrypts the new disk using + an encryption key that you provide. If you are + attaching an existing disk that is already + encrypted, this field decrypts the disk using + the customer-supplied encryption key. If you + encrypt a disk using a customer-supplied key, + you must provide the same key again when you + attempt to use this resource at a later time. + For example, you must provide the key when you + create a snapshot or an image from the disk or + when you attach the disk to a virtual machine + instance. If you do not provide an encryption + key, then the disk will be encrypted using an + automatically generated key and you do not need + to provide a key to use the disk later. Instance + templates do not store customer-supplied + encryption keys, so you cannot use your own keys + to encrypt disks in a managed instance group. + disk_size_gb (int): + The size of the disk in GB. + guest_os_features (Sequence[google.cloud.compute_v1.types.GuestOsFeature]): + A list of features to enable on the guest + operating system. Applicable only for bootable + images. Read Enabling guest operating system + features to see a list of available options. + index (int): + [Output Only] A zero-based index to this disk, where 0 is + reserved for the boot disk. If you have many disks attached + to an instance, each disk would have a unique index number. + initialize_params (google.cloud.compute_v1.types.AttachedDiskInitializeParams): + [Input Only] Specifies the parameters for a new disk that + will be created alongside the new instance. Use + initialization parameters to create boot disks or local SSDs + attached to the new instance. This property is mutually + exclusive with the source property; you can only define one + or the other, but not both. + interface (google.cloud.compute_v1.types.AttachedDisk.Interface): + Specifies the disk interface to use for + attaching this disk, which is either SCSI or + NVME. The default is SCSI. Persistent disks must + always use SCSI and the request will fail if you + attempt to attach a persistent disk in any other + format than SCSI. Local SSDs can use either NVME + or SCSI. For performance characteristics of SCSI + over NVMe, see Local SSD performance. + kind (str): + [Output Only] Type of the resource. Always + compute#attachedDisk for attached disks. + licenses (Sequence[str]): + [Output Only] Any valid publicly visible licenses. + mode (google.cloud.compute_v1.types.AttachedDisk.Mode): + The mode in which to attach this disk, either READ_WRITE or + READ_ONLY. If not specified, the default is to attach the + disk in READ_WRITE mode. + shielded_instance_initial_state (google.cloud.compute_v1.types.InitialStateConfig): + [Output Only] shielded vm initial state stored on disk + source (str): + Specifies a valid partial or full URL to an + existing Persistent Disk resource. When creating + a new instance, one of + initializeParams.sourceImage or + initializeParams.sourceSnapshot or disks.source + is required except for local SSD. If desired, + you can also attach existing non-root persistent + disks using this property. This field is only + applicable for persistent disks. Note that for + InstanceTemplate, specify the disk name, not the + URL for the disk. + type_ (google.cloud.compute_v1.types.AttachedDisk.Type): + Specifies the type of the disk, either + SCRATCH or PERSISTENT. If not specified, the + default is PERSISTENT. """ - name = proto.Field(proto.STRING, number=3373707, optional=True,) - + class Interface(proto.Enum): + r"""Specifies the disk interface to use for attaching this disk, + which is either SCSI or NVME. The default is SCSI. Persistent + disks must always use SCSI and the request will fail if you + attempt to attach a persistent disk in any other format than + SCSI. Local SSDs can use either NVME or SCSI. For performance + characteristics of SCSI over NVMe, see Local SSD performance. + """ + UNDEFINED_INTERFACE = 0 + NVME = 2408800 + SCSI = 2539686 -class BulkInsertInstanceResource(proto.Message): - r""" - Attributes: - count (int): - The maximum number of instances to create. - instance_properties (google.cloud.compute_v1.types.InstanceProperties): - The instance properties defining the VM - instances to be created. Required if - sourceInstanceTemplate is not provided. - location_policy (google.cloud.compute_v1.types.LocationPolicy): - Policy for chosing target zone. - min_count (int): - The minimum number of instances to create. If no min_count - is specified then count is used as the default value. If - min_count instances cannot be created, then no instances - will be created and instances already created will be - deleted. - name_pattern (str): - The string pattern used for the names of the VMs. Either - name_pattern or per_instance_properties must be set. The - pattern should contain one continuous sequence of - placeholder hash characters (#) with each character - corresponding to one digit of the generated instance name. - Example: name_pattern of inst-#### will generate instance - names such as inst-0001, inst-0002, ... . If there already - exist instance(s) whose names match the name pattern in the - same project and zone, then the generated instance numbers - will start after the biggest existing number. For example, - if there exists an instance with name inst-0050, then - instance names generated using the pattern inst-#### will be - inst-0051, inst-0052, etc. The name pattern placeholder - #...# can contain up to 18 characters. - per_instance_properties (Sequence[google.cloud.compute_v1.types.BulkInsertInstanceResource.PerInstancePropertiesEntry]): - Per-instance properties to be set on individual instances. - Keys of this map specify requested instance names. Can be - empty if name_pattern is used. - source_instance_template (str): - Specifies the instance template from which to - create instances. You may combine - sourceInstanceTemplate with instanceProperties - to override specific values from an existing - instance template. Bulk API follows the - semantics of JSON Merge Patch described by RFC - 7396. It can be a full or partial URL. For - example, the following are all valid URLs to an - instance template: - - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate - - - projects/project/global/instanceTemplates/instanceTemplate - - global/instanceTemplates/instanceTemplate + class Mode(proto.Enum): + r"""The mode in which to attach this disk, either READ_WRITE or + READ_ONLY. If not specified, the default is to attach the disk in + READ_WRITE mode. + """ + UNDEFINED_MODE = 0 + READ_ONLY = 91950261 + READ_WRITE = 173607894 - This field is optional. - """ + class Type(proto.Enum): + r"""Specifies the type of the disk, either SCRATCH or PERSISTENT. + If not specified, the default is PERSISTENT. + """ + UNDEFINED_TYPE = 0 + PERSISTENT = 460683927 + SCRATCH = 496778970 - count = proto.Field(proto.INT64, number=94851343, optional=True,) - instance_properties = proto.Field( - proto.MESSAGE, number=215355165, optional=True, message="InstanceProperties", + auto_delete = proto.Field(proto.BOOL, number=464761403, optional=True,) + boot = proto.Field(proto.BOOL, number=3029746, optional=True,) + device_name = proto.Field(proto.STRING, number=67541716, optional=True,) + disk_encryption_key = proto.Field( + proto.MESSAGE, number=271660677, optional=True, message="CustomerEncryptionKey", ) - location_policy = proto.Field( - proto.MESSAGE, number=465689852, optional=True, message="LocationPolicy", + disk_size_gb = proto.Field(proto.INT64, number=316263735, optional=True,) + guest_os_features = proto.RepeatedField( + proto.MESSAGE, number=79294545, message="GuestOsFeature", ) - min_count = proto.Field(proto.INT64, number=523228386, optional=True,) - name_pattern = proto.Field(proto.STRING, number=413815260, optional=True,) - per_instance_properties = proto.MapField( - proto.STRING, + index = proto.Field(proto.INT32, number=100346066, optional=True,) + initialize_params = proto.Field( proto.MESSAGE, - number=108502267, - message="BulkInsertInstanceResourcePerInstanceProperties", + number=17697045, + optional=True, + message="AttachedDiskInitializeParams", ) - source_instance_template = proto.Field( - proto.STRING, number=332423616, optional=True, + interface = proto.Field( + proto.ENUM, number=502623545, optional=True, enum=Interface, + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + licenses = proto.RepeatedField(proto.STRING, number=337642578,) + mode = proto.Field(proto.ENUM, number=3357091, optional=True, enum=Mode,) + shielded_instance_initial_state = proto.Field( + proto.MESSAGE, number=192356867, optional=True, message="InitialStateConfig", ) + source = proto.Field(proto.STRING, number=177235995, optional=True,) + type_ = proto.Field(proto.ENUM, number=3575610, optional=True, enum=Type,) -class CacheInvalidationRule(proto.Message): - r""" - Attributes: - host (str): - If set, this invalidation rule will only - apply to requests with a Host header matching - host. - path (str): +class AttachedDiskInitializeParams(proto.Message): + r"""[Input Only] Specifies the parameters for a new disk that will be + created alongside the new instance. Use initialization parameters to + create boot disks or local SSDs attached to the new instance. This + property is mutually exclusive with the source property; you can + only define one or the other, but not both. + Attributes: + description (str): + An optional description. Provide this + property when creating the disk. + disk_name (str): + Specifies the disk name. If not specified, + the default is to use the name of the instance. + If a disk with the same name already exists in + the given region, the existing disk is attached + to the new instance and the new disk is not + created. + disk_size_gb (int): + Specifies the size of the disk in base-2 GB. + The size must be at least 10 GB. If you specify + a sourceImage, which is required for boot disks, + the default size is the size of the sourceImage. + If you do not specify a sourceImage, the default + disk size is 500 GB. + disk_type (str): + Specifies the disk type to use to create the + instance. If not specified, the default is pd- + standard, specified using the full URL. For + example: + https://www.googleapis.com/compute/v1/projects/project/zones/zone + /diskTypes/pd-standard For a full list of + acceptable values, see Persistent disk types. If + you define this field, you can provide either + the full or partial URL. For example, the + following are valid values: - + https://www.googleapis.com/compute/v1/projects/project/zones/zone + /diskTypes/diskType - + projects/project/zones/zone/diskTypes/diskType - + zones/zone/diskTypes/diskType Note that for + InstanceTemplate, this is the name of the disk + type, not URL. + labels (Sequence[google.cloud.compute_v1.types.AttachedDiskInitializeParams.LabelsEntry]): + Labels to apply to this disk. These can be + later modified by the disks.setLabels method. + This field is only applicable for persistent + disks. + on_update_action (google.cloud.compute_v1.types.AttachedDiskInitializeParams.OnUpdateAction): + Specifies which action to take on instance + update with this disk. Default is to use the + existing disk. + provisioned_iops (int): + Indicates how many IOPS to provision for the + disk. This sets the number of I/O operations per + second that the disk can handle. Values must be + between 10,000 and 120,000. For more details, + see the Extreme persistent disk documentation. + resource_policies (Sequence[str]): + Resource policies applied to this disk for + automatic snapshot creations. Specified using + the full or partial URL. For instance template, + specify only the resource policy name. + source_image (str): + The source image to create this disk. When + creating a new instance, one of + initializeParams.sourceImage or + initializeParams.sourceSnapshot or disks.source + is required except for local SSD. To create a + disk with one of the public operating system + images, specify the image by its family name. + For example, specify family/debian-9 to use the + latest Debian 9 image: projects/debian- + cloud/global/images/family/debian-9 + Alternatively, use a specific version of a + public operating system image: projects/debian- + cloud/global/images/debian-9-stretch-vYYYYMMDD + To create a disk with a custom image that you + created, specify the image name in the following + format: global/images/my-custom-image You can + also specify a custom image by its image family, + which returns the latest version of the image in + that family. Replace the image name with + family/family-name: global/images/family/my- + image-family If the source image is deleted + later, this field will not be set. + source_image_encryption_key (google.cloud.compute_v1.types.CustomerEncryptionKey): + The customer-supplied encryption key of the + source image. Required if the source image is + protected by a customer-supplied encryption key. + Instance templates do not store customer- + supplied encryption keys, so you cannot create + disks for instances in a managed instance group + if the source images are encrypted with your own + keys. + source_snapshot (str): + The source snapshot to create this disk. When + creating a new instance, one of + initializeParams.sourceSnapshot or + initializeParams.sourceImage or disks.source is + required except for local SSD. To create a disk + with a snapshot that you created, specify the + snapshot name in the following format: + global/snapshots/my-backup If the source + snapshot is deleted later, this field will not + be set. + source_snapshot_encryption_key (google.cloud.compute_v1.types.CustomerEncryptionKey): + The customer-supplied encryption key of the + source snapshot. """ - host = proto.Field(proto.STRING, number=3208616, optional=True,) - path = proto.Field(proto.STRING, number=3433509, optional=True,) + class OnUpdateAction(proto.Enum): + r"""Specifies which action to take on instance update with this + disk. Default is to use the existing disk. + """ + UNDEFINED_ON_UPDATE_ACTION = 0 + RECREATE_DISK = 494767853 + RECREATE_DISK_IF_SOURCE_CHANGED = 398099712 + USE_EXISTING_DISK = 232682233 + + description = proto.Field(proto.STRING, number=422937596, optional=True,) + disk_name = proto.Field(proto.STRING, number=92807149, optional=True,) + disk_size_gb = proto.Field(proto.INT64, number=316263735, optional=True,) + disk_type = proto.Field(proto.STRING, number=93009052, optional=True,) + labels = proto.MapField(proto.STRING, proto.STRING, number=500195327,) + on_update_action = proto.Field( + proto.ENUM, number=202451980, optional=True, enum=OnUpdateAction, + ) + provisioned_iops = proto.Field(proto.INT64, number=186769108, optional=True,) + resource_policies = proto.RepeatedField(proto.STRING, number=22220385,) + source_image = proto.Field(proto.STRING, number=50443319, optional=True,) + source_image_encryption_key = proto.Field( + proto.MESSAGE, number=381503659, optional=True, message="CustomerEncryptionKey", + ) + source_snapshot = proto.Field(proto.STRING, number=126061928, optional=True,) + source_snapshot_encryption_key = proto.Field( + proto.MESSAGE, number=303679322, optional=True, message="CustomerEncryptionKey", + ) -class LicenseResourceCommitment(proto.Message): - r"""Commitment for a particular license resource. +class AuditConfig(proto.Message): + r"""Specifies the audit configuration for a service. The configuration + determines which permission types are logged, and what identities, + if any, are exempted from logging. An AuditConfig must have one or + more AuditLogConfigs. If there are AuditConfigs for both + ``allServices`` and a specific service, the union of the two + AuditConfigs is used for that service: the log_types specified in + each AuditConfig are enabled, and the exempted_members in each + AuditLogConfig are exempted. Example Policy with multiple + AuditConfigs: { "audit_configs": [ { "service": "allServices", + "audit_log_configs": [ { "log_type": "DATA_READ", + "exempted_members": [ "user:jose@example.com" ] }, { "log_type": + "DATA_WRITE" }, { "log_type": "ADMIN_READ" } ] }, { "service": + "sampleservice.googleapis.com", "audit_log_configs": [ { "log_type": + "DATA_READ" }, { "log_type": "DATA_WRITE", "exempted_members": [ + "user:aliya@example.com" ] } ] } ] } For sampleservice, this policy + enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also + exempts jose@example.com from DATA_READ logging, and + aliya@example.com from DATA_WRITE logging. + Attributes: - amount (int): - The number of licenses purchased. - cores_per_license (str): - Specifies the core range of the instance for - which this license applies. - license_ (str): - Any applicable license URI. + audit_log_configs (Sequence[google.cloud.compute_v1.types.AuditLogConfig]): + The configuration for logging of each type of + permission. + exempted_members (Sequence[str]): + This is deprecated and has no effect. Do not + use. + service (str): + Specifies a service that will be enabled for audit logging. + For example, ``storage.googleapis.com``, + ``cloudsql.googleapis.com``. ``allServices`` is a special + value that covers all services. """ - amount = proto.Field(proto.INT64, number=196759640, optional=True,) - cores_per_license = proto.Field(proto.STRING, number=32482324, optional=True,) - license_ = proto.Field(proto.STRING, number=166757441, optional=True,) + audit_log_configs = proto.RepeatedField( + proto.MESSAGE, number=488420626, message="AuditLogConfig", + ) + exempted_members = proto.RepeatedField(proto.STRING, number=232615576,) + service = proto.Field(proto.STRING, number=373540533, optional=True,) -class Reservation(proto.Message): - r"""Represents a reservation resource. A reservation ensures that - capacity is held in a specific zone even if the reserved VMs are not - running. For more information, read Reserving zonal resources. (== - resource_for {$api_version}.reservations ==) +class AuditLogConfig(proto.Message): + r"""Provides the configuration for logging a type of permissions. + Example: { "audit_log_configs": [ { "log_type": "DATA_READ", + "exempted_members": [ "user:jose@example.com" ] }, { "log_type": + "DATA_WRITE" } ] } This enables 'DATA_READ' and 'DATA_WRITE' + logging, while exempting jose@example.com from DATA_READ logging. Attributes: - commitment (str): - [Output Only] Full or partial URL to a parent commitment. - This field displays for reservations that are tied to a - commitment. - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - description (str): - An optional description of this resource. - Provide this property when you create the - resource. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - kind (str): - [Output Only] Type of the resource. Always - compute#reservations for reservations. - name (str): - The name of the resource, provided by the client when - initially creating the resource. The resource name must be - 1-63 characters long, and comply with RFC1035. Specifically, - the name must be 1-63 characters long and match the regular - expression ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the - first character must be a lowercase letter, and all - following characters must be a dash, lowercase letter, or - digit, except the last character, which cannot be a dash. - satisfies_pzs (bool): - [Output Only] Reserved for future use. - self_link (str): - [Output Only] Server-defined fully-qualified URL for this - resource. - specific_reservation (google.cloud.compute_v1.types.AllocationSpecificSKUReservation): - Reservation for instances with specific - machine shapes. - specific_reservation_required (bool): - Indicates whether the reservation can be - consumed by VMs with affinity for "any" - reservation. If the field is set, then only VMs - that target the reservation by name can consume - from this reservation. - status (google.cloud.compute_v1.types.Reservation.Status): - [Output Only] The status of the reservation. - zone (str): - Zone in which the reservation resides. A zone - must be provided if the reservation is created - within a commitment. + exempted_members (Sequence[str]): + Specifies the identities that do not cause + logging for this type of permission. Follows the + same format of Binding.members. + ignore_child_exemptions (bool): + This is deprecated and has no effect. Do not + use. + log_type (google.cloud.compute_v1.types.AuditLogConfig.LogType): + The log type that this config enables. """ - class Status(proto.Enum): - r"""[Output Only] The status of the reservation.""" - UNDEFINED_STATUS = 0 - CREATING = 455564985 - DELETING = 528602024 - INVALID = 530283991 - READY = 77848963 - UPDATING = 494614342 - - commitment = proto.Field(proto.STRING, number=482134805, optional=True,) - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - satisfies_pzs = proto.Field(proto.BOOL, number=480964267, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - specific_reservation = proto.Field( - proto.MESSAGE, - number=404901951, - optional=True, - message="AllocationSpecificSKUReservation", - ) - specific_reservation_required = proto.Field( - proto.BOOL, number=226550687, optional=True, - ) - status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) - zone = proto.Field(proto.STRING, number=3744684, optional=True,) + class LogType(proto.Enum): + r"""The log type that this config enables.""" + UNDEFINED_LOG_TYPE = 0 + ADMIN_READ = 128951462 + DATA_READ = 305224971 + DATA_WRITE = 340181738 + LOG_TYPE_UNSPECIFIED = 154527053 + exempted_members = proto.RepeatedField(proto.STRING, number=232615576,) + ignore_child_exemptions = proto.Field(proto.BOOL, number=70141850, optional=True,) + log_type = proto.Field(proto.ENUM, number=403115861, optional=True, enum=LogType,) -class ResourceCommitment(proto.Message): - r"""Commitment for a particular resource (a Commitment is - composed of one or more of these). +class AuthorizationLoggingOptions(proto.Message): + r"""This is deprecated and has no effect. Do not use. Attributes: - accelerator_type (str): - Name of the accelerator type resource. - Applicable only when the type is ACCELERATOR. - amount (int): - The amount of the resource purchased (in a - type-dependent unit, such as bytes). For vCPUs, - this can just be an integer. For memory, this - must be provided in MB. Memory must be a - multiple of 256 MB, with up to 6.5GB of memory - per every vCPU. - type_ (google.cloud.compute_v1.types.ResourceCommitment.Type): - Type of resource for which this commitment - applies. Possible values are VCPU and MEMORY + permission_type (google.cloud.compute_v1.types.AuthorizationLoggingOptions.PermissionType): + This is deprecated and has no effect. Do not + use. """ - class Type(proto.Enum): - r"""Type of resource for which this commitment applies. Possible - values are VCPU and MEMORY - """ - UNDEFINED_TYPE = 0 - ACCELERATOR = 429815371 - LOCAL_SSD = 508934896 - MEMORY = 123056385 - UNSPECIFIED = 526786327 - VCPU = 2628978 - - accelerator_type = proto.Field(proto.STRING, number=138031246, optional=True,) - amount = proto.Field(proto.INT64, number=196759640, optional=True,) - type_ = proto.Field(proto.ENUM, number=3575610, optional=True, enum=Type,) - + class PermissionType(proto.Enum): + r"""This is deprecated and has no effect. Do not use.""" + UNDEFINED_PERMISSION_TYPE = 0 + ADMIN_READ = 128951462 + ADMIN_WRITE = 244412079 + DATA_READ = 305224971 + DATA_WRITE = 340181738 + PERMISSION_TYPE_UNSPECIFIED = 440313346 -class Commitment(proto.Message): - r"""Represents a regional Commitment resource. + permission_type = proto.Field( + proto.ENUM, number=525978538, optional=True, enum=PermissionType, + ) - Creating a commitment resource means that you are purchasing a - committed use contract with an explicit start and end time. You can - create commitments based on vCPUs and memory usage and receive - discounted rates. For full details, read Signing Up for Committed - Use Discounts. (== resource_for {$api_version}.regionCommitments ==) - Attributes: - category (google.cloud.compute_v1.types.Commitment.Category): - The category of the commitment. Category - MACHINE specifies commitments composed of - machine resources such as VCPU or MEMORY, listed - in resources. Category LICENSE specifies - commitments composed of software licenses, - listed in licenseResources. Note that only - MACHINE commitments should have a Type - specified. +class Autoscaler(proto.Message): + r"""Represents an Autoscaler resource. Google Compute Engine has two + Autoscaler resources: \* + `Zonal `__ \* + `Regional `__ Use + autoscalers to automatically add or delete instances from a managed + instance group according to your defined autoscaling policy. For + more information, read Autoscaling Groups of Instances. For zonal + managed instance groups resource, use the autoscaler resource. For + regional managed instance groups, use the regionAutoscalers + resource. + + Attributes: + autoscaling_policy (google.cloud.compute_v1.types.AutoscalingPolicy): + The configuration parameters for the + autoscaling algorithm. You can define one or + more signals for an autoscaler: cpuUtilization, + customMetricUtilizations, and + loadBalancingUtilization. If none of these are + specified, the default will be to autoscale + based on cpuUtilization to 0.6 or 60%. creation_timestamp (str): [Output Only] Creation timestamp in RFC3339 text format. description (str): An optional description of this resource. Provide this property when you create the resource. - end_timestamp (str): - [Output Only] Commitment end time in RFC3339 text format. id (int): [Output Only] The unique identifier for the resource. This identifier is defined by the server. kind (str): [Output Only] Type of the resource. Always - compute#commitment for commitments. - license_resource (google.cloud.compute_v1.types.LicenseResourceCommitment): - The license specification required as part of - a license commitment. + compute#autoscaler for autoscalers. name (str): Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, @@ -5586,124 +5841,94 @@ class Commitment(proto.Message): character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. - plan (google.cloud.compute_v1.types.Commitment.Plan): - The plan for this commitment, which determines duration and - discount rate. The currently supported plans are - TWELVE_MONTH (1 year), and THIRTY_SIX_MONTH (3 years). + recommended_size (int): + [Output Only] Target recommended MIG size (number of + instances) computed by autoscaler. Autoscaler calculates the + recommended MIG size even when the autoscaling policy mode + is different from ON. This field is empty when autoscaler is + not connected to an existing managed instance group or + autoscaler did not generate its prediction. region (str): - [Output Only] URL of the region where this commitment may be - used. - reservations (Sequence[google.cloud.compute_v1.types.Reservation]): - List of reservations in this commitment. - resources (Sequence[google.cloud.compute_v1.types.ResourceCommitment]): - A list of commitment amounts for particular - resources. Note that VCPU and MEMORY resource - commitments must occur together. + [Output Only] URL of the region where the instance group + resides (for autoscalers living in regional scope). + scaling_schedule_status (Sequence[google.cloud.compute_v1.types.Autoscaler.ScalingScheduleStatusEntry]): + [Output Only] Status information of existing scaling + schedules. self_link (str): [Output Only] Server-defined URL for the resource. - start_timestamp (str): - [Output Only] Commitment start time in RFC3339 text format. - status (google.cloud.compute_v1.types.Commitment.Status): - [Output Only] Status of the commitment with regards to - eventual expiration (each commitment has an end date - defined). One of the following values: NOT_YET_ACTIVE, - ACTIVE, EXPIRED. - status_message (str): - [Output Only] An optional, human-readable explanation of the - status. + status (google.cloud.compute_v1.types.Autoscaler.Status): + [Output Only] The status of the autoscaler configuration. + Current set of possible values: - PENDING: Autoscaler + backend hasn't read new/updated configuration. - DELETING: + Configuration is being deleted. - ACTIVE: Configuration is + acknowledged to be effective. Some warnings might be present + in the statusDetails field. - ERROR: Configuration has + errors. Actionable for users. Details are present in the + statusDetails field. New values might be added in the + future. + status_details (Sequence[google.cloud.compute_v1.types.AutoscalerStatusDetails]): + [Output Only] Human-readable details about the current state + of the autoscaler. Read the documentation for Commonly + returned status messages for examples of status messages you + might encounter. + target (str): + URL of the managed instance group that this + autoscaler will scale. This field is required + when creating an autoscaler. + zone (str): + [Output Only] URL of the zone where the instance group + resides (for autoscalers living in zonal scope). """ - class Category(proto.Enum): - r"""The category of the commitment. Category MACHINE specifies - commitments composed of machine resources such as VCPU or - MEMORY, listed in resources. Category LICENSE specifies - commitments composed of software licenses, listed in - licenseResources. Note that only MACHINE commitments should have - a Type specified. - """ - UNDEFINED_CATEGORY = 0 - CATEGORY_UNSPECIFIED = 509189462 - LICENSE = 347869217 - MACHINE = 469553191 - - class Plan(proto.Enum): - r"""The plan for this commitment, which determines duration and discount - rate. The currently supported plans are TWELVE_MONTH (1 year), and - THIRTY_SIX_MONTH (3 years). - """ - UNDEFINED_PLAN = 0 - INVALID = 530283991 - THIRTY_SIX_MONTH = 266295942 - TWELVE_MONTH = 173083962 - class Status(proto.Enum): - r"""[Output Only] Status of the commitment with regards to eventual - expiration (each commitment has an end date defined). One of the - following values: NOT_YET_ACTIVE, ACTIVE, EXPIRED. + r"""[Output Only] The status of the autoscaler configuration. Current + set of possible values: - PENDING: Autoscaler backend hasn't read + new/updated configuration. - DELETING: Configuration is being + deleted. - ACTIVE: Configuration is acknowledged to be effective. + Some warnings might be present in the statusDetails field. - ERROR: + Configuration has errors. Actionable for users. Details are present + in the statusDetails field. New values might be added in the future. """ UNDEFINED_STATUS = 0 ACTIVE = 314733318 - CREATING = 455564985 - EXPIRED = 482489093 - NOT_YET_ACTIVE = 20607337 + DELETING = 528602024 + ERROR = 66247144 + PENDING = 35394935 - category = proto.Field(proto.ENUM, number=50511102, optional=True, enum=Category,) + autoscaling_policy = proto.Field( + proto.MESSAGE, number=221950041, optional=True, message="AutoscalingPolicy", + ) creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) description = proto.Field(proto.STRING, number=422937596, optional=True,) - end_timestamp = proto.Field(proto.STRING, number=468096690, optional=True,) id = proto.Field(proto.UINT64, number=3355, optional=True,) kind = proto.Field(proto.STRING, number=3292052, optional=True,) - license_resource = proto.Field( - proto.MESSAGE, - number=437955148, - optional=True, - message="LicenseResourceCommitment", - ) name = proto.Field(proto.STRING, number=3373707, optional=True,) - plan = proto.Field(proto.ENUM, number=3443497, optional=True, enum=Plan,) + recommended_size = proto.Field(proto.INT32, number=257915749, optional=True,) region = proto.Field(proto.STRING, number=138946292, optional=True,) - reservations = proto.RepeatedField( - proto.MESSAGE, number=399717927, message="Reservation", - ) - resources = proto.RepeatedField( - proto.MESSAGE, number=164412965, message="ResourceCommitment", + scaling_schedule_status = proto.MapField( + proto.STRING, proto.MESSAGE, number=465950178, message="ScalingScheduleStatus", ) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - start_timestamp = proto.Field(proto.STRING, number=83645817, optional=True,) status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) - status_message = proto.Field(proto.STRING, number=297428154, optional=True,) - - -class CommitmentsScopedList(proto.Message): - r""" - Attributes: - commitments (Sequence[google.cloud.compute_v1.types.Commitment]): - [Output Only] A list of commitments contained in this scope. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning which replaces the list - of commitments when the list is empty. - """ - - commitments = proto.RepeatedField( - proto.MESSAGE, number=450664446, message="Commitment", - ) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + status_details = proto.RepeatedField( + proto.MESSAGE, number=363353845, message="AutoscalerStatusDetails", ) + target = proto.Field(proto.STRING, number=192835985, optional=True,) + zone = proto.Field(proto.STRING, number=3744684, optional=True,) -class CommitmentAggregatedList(proto.Message): +class AutoscalerAggregatedList(proto.Message): r""" Attributes: id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.CommitmentAggregatedList.ItemsEntry]): - A list of CommitmentsScopedList resources. + items (Sequence[google.cloud.compute_v1.types.AutoscalerAggregatedList.ItemsEntry]): + A list of AutoscalersScopedList resources. kind (str): [Output Only] Type of resource. Always - compute#commitmentAggregatedList for aggregated lists of - commitments. + compute#autoscalerAggregatedList for aggregated lists of + autoscalers. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -5714,7 +5939,8 @@ class CommitmentAggregatedList(proto.Message): self_link (str): [Output Only] Server-defined URL for this resource. unreachables (Sequence[str]): - [Output Only] Unreachable resources. + [Output Only] Unreachable resources. end_interface: + MixerListResponseWithEtagBuilder warning (google.cloud.compute_v1.types.Warning): [Output Only] Informational warning message. """ @@ -5725,7 +5951,7 @@ def raw_page(self): id = proto.Field(proto.STRING, number=3355, optional=True,) items = proto.MapField( - proto.STRING, proto.MESSAGE, number=100526016, message="CommitmentsScopedList", + proto.STRING, proto.MESSAGE, number=100526016, message="AutoscalersScopedList", ) kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) @@ -5736,17 +5962,17 @@ def raw_page(self): ) -class CommitmentList(proto.Message): - r"""Contains a list of Commitment resources. +class AutoscalerList(proto.Message): + r"""Contains a list of Autoscaler resources. Attributes: id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.Commitment]): - A list of Commitment resources. + items (Sequence[google.cloud.compute_v1.types.Autoscaler]): + A list of Autoscaler resources. kind (str): [Output Only] Type of resource. Always - compute#commitmentList for lists of commitments. + compute#autoscalerList for lists of autoscalers. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -5765,7 +5991,7 @@ def raw_page(self): return self id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Commitment",) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Autoscaler",) kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) @@ -5774,218 +6000,608 @@ def raw_page(self): ) -class Condition(proto.Message): - r"""A condition to be met. +class AutoscalerStatusDetails(proto.Message): + r""" Attributes: - iam (str): - Trusted attributes supplied by the IAM - system. - op (str): - An operator to apply the subject with. - svc (str): - Trusted attributes discharged by the service. - sys (str): - Trusted attributes supplied by any service - that owns resources and uses the IAM system for - access control. - values (Sequence[str]): - The objects of the condition. + message (str): + The status message. + type_ (google.cloud.compute_v1.types.AutoscalerStatusDetails.Type): + The type of error, warning, or notice returned. Current set + of possible values: - ALL_INSTANCES_UNHEALTHY (WARNING): All + instances in the instance group are unhealthy (not in + RUNNING state). - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR): + There is no backend service attached to the instance group. + - CAPPED_AT_MAX_NUM_REPLICAS (WARNING): Autoscaler + recommends a size greater than maxNumReplicas. - + CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING): The custom + metric samples are not exported often enough to be a + credible base for autoscaling. - CUSTOM_METRIC_INVALID + (ERROR): The custom metric that was specified does not exist + or does not have the necessary labels. - MIN_EQUALS_MAX + (WARNING): The minNumReplicas is equal to maxNumReplicas. + This means the autoscaler cannot add or remove instances + from the instance group. - MISSING_CUSTOM_METRIC_DATA_POINTS + (WARNING): The autoscaler did not receive any data from the + custom metric configured for autoscaling. - + MISSING_LOAD_BALANCING_DATA_POINTS (WARNING): The autoscaler + is configured to scale based on a load balancing signal but + the instance group has not received any requests from the + load balancer. - MODE_OFF (WARNING): Autoscaling is turned + off. The number of instances in the group won't change + automatically. The autoscaling configuration is preserved. - + MODE_ONLY_UP (WARNING): Autoscaling is in the "Autoscale + only out" mode. The autoscaler can add instances but not + remove any. - MORE_THAN_ONE_BACKEND_SERVICE (ERROR): The + instance group cannot be autoscaled because it has more than + one backend service attached to it. - + NOT_ENOUGH_QUOTA_AVAILABLE (ERROR): There is insufficient + quota for the necessary resources, such as CPU or number of + instances. - REGION_RESOURCE_STOCKOUT (ERROR): Shown only + for regional autoscalers: there is a resource stockout in + the chosen region. - SCALING_TARGET_DOES_NOT_EXIST (ERROR): + The target to be scaled does not exist. - + UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION (ERROR): + Autoscaling does not work with an HTTP/S load balancer that + has been configured for maxRate. - ZONE_RESOURCE_STOCKOUT + (ERROR): For zonal autoscalers: there is a resource stockout + in the chosen zone. For regional autoscalers: in at least + one of the zones you're using there is a resource stockout. + New values might be added in the future. Some of the values + might not be available in all API versions. """ - iam = proto.Field(proto.STRING, number=104021, optional=True,) - op = proto.Field(proto.STRING, number=3553, optional=True,) - svc = proto.Field(proto.STRING, number=114272, optional=True,) - sys = proto.Field(proto.STRING, number=114381, optional=True,) - values = proto.RepeatedField(proto.STRING, number=249928994,) + class Type(proto.Enum): + r"""The type of error, warning, or notice returned. Current set of + possible values: - ALL_INSTANCES_UNHEALTHY (WARNING): All instances + in the instance group are unhealthy (not in RUNNING state). - + BACKEND_SERVICE_DOES_NOT_EXIST (ERROR): There is no backend service + attached to the instance group. - CAPPED_AT_MAX_NUM_REPLICAS + (WARNING): Autoscaler recommends a size greater than maxNumReplicas. + - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING): The custom metric + samples are not exported often enough to be a credible base for + autoscaling. - CUSTOM_METRIC_INVALID (ERROR): The custom metric that + was specified does not exist or does not have the necessary labels. + - MIN_EQUALS_MAX (WARNING): The minNumReplicas is equal to + maxNumReplicas. This means the autoscaler cannot add or remove + instances from the instance group. - + MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING): The autoscaler did not + receive any data from the custom metric configured for autoscaling. + - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING): The autoscaler is + configured to scale based on a load balancing signal but the + instance group has not received any requests from the load balancer. + - MODE_OFF (WARNING): Autoscaling is turned off. The number of + instances in the group won't change automatically. The autoscaling + configuration is preserved. - MODE_ONLY_UP (WARNING): Autoscaling is + in the "Autoscale only out" mode. The autoscaler can add instances + but not remove any. - MORE_THAN_ONE_BACKEND_SERVICE (ERROR): The + instance group cannot be autoscaled because it has more than one + backend service attached to it. - NOT_ENOUGH_QUOTA_AVAILABLE + (ERROR): There is insufficient quota for the necessary resources, + such as CPU or number of instances. - REGION_RESOURCE_STOCKOUT + (ERROR): Shown only for regional autoscalers: there is a resource + stockout in the chosen region. - SCALING_TARGET_DOES_NOT_EXIST + (ERROR): The target to be scaled does not exist. - + UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION (ERROR): + Autoscaling does not work with an HTTP/S load balancer that has been + configured for maxRate. - ZONE_RESOURCE_STOCKOUT (ERROR): For zonal + autoscalers: there is a resource stockout in the chosen zone. For + regional autoscalers: in at least one of the zones you're using + there is a resource stockout. New values might be added in the + future. Some of the values might not be available in all API + versions. + """ + UNDEFINED_TYPE = 0 + ALL_INSTANCES_UNHEALTHY = 404965477 + BACKEND_SERVICE_DOES_NOT_EXIST = 191417626 + CAPPED_AT_MAX_NUM_REPLICAS = 518617 + CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE = 328964659 + CUSTOM_METRIC_INVALID = 204430550 + MIN_EQUALS_MAX = 2821361 + MISSING_CUSTOM_METRIC_DATA_POINTS = 94885086 + MISSING_LOAD_BALANCING_DATA_POINTS = 509858898 + MODE_OFF = 164169907 + MODE_ONLY_SCALE_OUT = 3840994 + MODE_ONLY_UP = 100969842 + MORE_THAN_ONE_BACKEND_SERVICE = 151922141 + NOT_ENOUGH_QUOTA_AVAILABLE = 403101631 + REGION_RESOURCE_STOCKOUT = 528622846 + SCALING_TARGET_DOES_NOT_EXIST = 122636699 + SCHEDULED_INSTANCES_GREATER_THAN_AUTOSCALER_MAX = 29275586 + SCHEDULED_INSTANCES_LESS_THAN_AUTOSCALER_MIN = 398287669 + UNKNOWN = 433141802 + UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION = 330845009 + ZONE_RESOURCE_STOCKOUT = 210200502 + message = proto.Field(proto.STRING, number=418054151, optional=True,) + type_ = proto.Field(proto.ENUM, number=3575610, optional=True, enum=Type,) -class ConfidentialInstanceConfig(proto.Message): - r"""A set of Confidential Instance options. + +class AutoscalersScopedList(proto.Message): + r""" Attributes: - enable_confidential_compute (bool): - Defines whether the instance should have - confidential compute enabled. + autoscalers (Sequence[google.cloud.compute_v1.types.Autoscaler]): + [Output Only] A list of autoscalers contained in this scope. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning which replaces the list + of autoscalers when the list is empty. """ - enable_confidential_compute = proto.Field( - proto.BOOL, number=102135228, optional=True, + autoscalers = proto.RepeatedField( + proto.MESSAGE, number=465771644, message="Autoscaler", + ) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", ) -class ConsistentHashLoadBalancerSettingsHttpCookie(proto.Message): - r"""The information about the HTTP Cookie on which the hash - function is based for load balancing policies that use a - consistent hash. +class AutoscalingPolicy(proto.Message): + r"""Cloud Autoscaler policy. + Attributes: + cool_down_period_sec (int): + The number of seconds that the autoscaler + waits before it starts collecting information + from a new instance. This prevents the + autoscaler from collecting information when the + instance is initializing, during which the + collected usage would not be reliable. The + default time autoscaler waits is 60 seconds. + Virtual machine initialization times might vary + because of numerous factors. We recommend that + you test how long an instance may take to + initialize. To do this, create an instance and + time the startup process. + cpu_utilization (google.cloud.compute_v1.types.AutoscalingPolicyCpuUtilization): + Defines the CPU utilization policy that + allows the autoscaler to scale based on the + average CPU utilization of a managed instance + group. + custom_metric_utilizations (Sequence[google.cloud.compute_v1.types.AutoscalingPolicyCustomMetricUtilization]): + Configuration parameters of autoscaling based + on a custom metric. + load_balancing_utilization (google.cloud.compute_v1.types.AutoscalingPolicyLoadBalancingUtilization): + Configuration parameters of autoscaling based + on load balancer. + max_num_replicas (int): + The maximum number of instances that the + autoscaler can scale out to. This is required + when creating or updating an autoscaler. The + maximum number of replicas must not be lower + than minimal number of replicas. + min_num_replicas (int): + The minimum number of replicas that the + autoscaler can scale in to. This cannot be less + than 0. If not provided, autoscaler chooses a + default value depending on maximum number of + instances allowed. + mode (google.cloud.compute_v1.types.AutoscalingPolicy.Mode): + Defines operating mode for this policy. + scale_in_control (google.cloud.compute_v1.types.AutoscalingPolicyScaleInControl): + + scaling_schedules (Sequence[google.cloud.compute_v1.types.AutoscalingPolicy.ScalingSchedulesEntry]): + Scaling schedules defined for an autoscaler. Multiple + schedules can be set on an autoscaler, and they can overlap. + During overlapping periods the greatest + min_required_replicas of all scaling schedules is applied. + Up to 128 scaling schedules are allowed. + """ + + class Mode(proto.Enum): + r"""Defines operating mode for this policy.""" + UNDEFINED_MODE = 0 + OFF = 78159 + ON = 2527 + ONLY_SCALE_OUT = 152713670 + ONLY_UP = 478095374 + + cool_down_period_sec = proto.Field(proto.INT32, number=107692954, optional=True,) + cpu_utilization = proto.Field( + proto.MESSAGE, + number=381211147, + optional=True, + message="AutoscalingPolicyCpuUtilization", + ) + custom_metric_utilizations = proto.RepeatedField( + proto.MESSAGE, + number=131972850, + message="AutoscalingPolicyCustomMetricUtilization", + ) + load_balancing_utilization = proto.Field( + proto.MESSAGE, + number=429746403, + optional=True, + message="AutoscalingPolicyLoadBalancingUtilization", + ) + max_num_replicas = proto.Field(proto.INT32, number=62327375, optional=True,) + min_num_replicas = proto.Field(proto.INT32, number=535329825, optional=True,) + mode = proto.Field(proto.ENUM, number=3357091, optional=True, enum=Mode,) + scale_in_control = proto.Field( + proto.MESSAGE, + number=527670872, + optional=True, + message="AutoscalingPolicyScaleInControl", + ) + scaling_schedules = proto.MapField( + proto.STRING, + proto.MESSAGE, + number=355416580, + message="AutoscalingPolicyScalingSchedule", + ) + +class AutoscalingPolicyCpuUtilization(proto.Message): + r"""CPU utilization policy. Attributes: - name (str): - Name of the cookie. - path (str): - Path to set for the cookie. - ttl (google.cloud.compute_v1.types.Duration): - Lifetime of the cookie. + predictive_method (google.cloud.compute_v1.types.AutoscalingPolicyCpuUtilization.PredictiveMethod): + Indicates whether predictive autoscaling based on CPU metric + is enabled. Valid values are: \* NONE (default). No + predictive method is used. The autoscaler scales the group + to meet current demand based on real-time metrics. \* + OPTIMIZE_AVAILABILITY. Predictive autoscaling improves + availability by monitoring daily and weekly load patterns + and scaling out ahead of anticipated demand. + utilization_target (float): + The target CPU utilization that the autoscaler maintains. + Must be a float value in the range (0, 1]. If not specified, + the default is 0.6. If the CPU level is below the target + utilization, the autoscaler scales in the number of + instances until it reaches the minimum number of instances + you specified or until the average CPU of your instances + reaches the target utilization. If the average CPU is above + the target utilization, the autoscaler scales out until it + reaches the maximum number of instances you specified or + until the average utilization reaches the target + utilization. """ - name = proto.Field(proto.STRING, number=3373707, optional=True,) - path = proto.Field(proto.STRING, number=3433509, optional=True,) - ttl = proto.Field(proto.MESSAGE, number=115180, optional=True, message="Duration",) + class PredictiveMethod(proto.Enum): + r"""Indicates whether predictive autoscaling based on CPU metric is + enabled. Valid values are: \* NONE (default). No predictive method + is used. The autoscaler scales the group to meet current demand + based on real-time metrics. \* OPTIMIZE_AVAILABILITY. Predictive + autoscaling improves availability by monitoring daily and weekly + load patterns and scaling out ahead of anticipated demand. + """ + UNDEFINED_PREDICTIVE_METHOD = 0 + NONE = 2402104 + OPTIMIZE_AVAILABILITY = 11629437 + predictive_method = proto.Field( + proto.ENUM, number=390220737, optional=True, enum=PredictiveMethod, + ) + utilization_target = proto.Field(proto.DOUBLE, number=215905870, optional=True,) -class CorsPolicy(proto.Message): - r"""The specification for allowing client side cross-origin - requests. Please see W3C Recommendation for Cross Origin - Resource Sharing +class AutoscalingPolicyCustomMetricUtilization(proto.Message): + r"""Custom utilization metric policy. Attributes: - allow_credentials (bool): - In response to a preflight request, setting - this to true indicates that the actual request - can include user credentials. This translates to - the Access-Control-Allow-Credentials header. - Default is false. - allow_headers (Sequence[str]): - Specifies the content for the Access-Control- - llow-Headers header. - allow_methods (Sequence[str]): - Specifies the content for the Access-Control- - llow-Methods header. - allow_origin_regexes (Sequence[str]): - Specifies the regualar expression patterns - that match allowed origins. For regular - expression grammar please see - github.com/google/re2/wiki/Syntax An origin is - allowed if it matches either an item in - allowOrigins or an item in allowOriginRegexes. - allow_origins (Sequence[str]): - Specifies the list of origins that will be - allowed to do CORS requests. An origin is - allowed if it matches either an item in - allowOrigins or an item in allowOriginRegexes. + filter (str): + A filter string, compatible with a Stackdriver Monitoring + filter string for TimeSeries.list API call. This filter is + used to select a specific TimeSeries for the purpose of + autoscaling and to determine whether the metric is exporting + per-instance or per-group data. For the filter to be valid + for autoscaling purposes, the following rules apply: - You + can only use the AND operator for joining selectors. - You + can only use direct equality comparison operator (=) without + any functions for each selector. - You can specify the + metric in both the filter string and in the metric field. + However, if specified in both places, the metric must be + identical. - The monitored resource type determines what + kind of values are expected for the metric. If it is a + gce_instance, the autoscaler expects the metric to include a + separate TimeSeries for each instance in a group. In such a + case, you cannot filter on resource labels. If the resource + type is any other value, the autoscaler expects this metric + to contain values that apply to the entire autoscaled + instance group and resource label filtering can be performed + to point autoscaler at the correct TimeSeries to scale upon. + This is called a *per-group metric* for the purpose of + autoscaling. If not specified, the type defaults to + gce_instance. Try to provide a filter that is selective + enough to pick just one TimeSeries for the autoscaled group + or for each of the instances (if you are using gce_instance + resource type). If multiple TimeSeries are returned upon the + query execution, the autoscaler will sum their respective + values to obtain its scaling value. + metric (str): + The identifier (type) of the Stackdriver + Monitoring metric. The metric cannot have + negative values. The metric must have a value + type of INT64 or DOUBLE. + single_instance_assignment (float): + If scaling is based on a per-group metric value that + represents the total amount of work to be done or resource + usage, set this value to an amount assigned for a single + instance of the scaled group. Autoscaler keeps the number of + instances proportional to the value of this metric. The + metric itself does not change value due to group resizing. A + good metric to use with the target is for example + pubsub.googleapis.com/subscription/num_undelivered_messages + or a custom metric exporting the total number of requests + coming to your instances. A bad example would be a metric + exporting an average or median latency, since this value + can't include a chunk assignable to a single instance, it + could be better used with utilization_target instead. + utilization_target (float): + The target value of the metric that autoscaler maintains. + This must be a positive value. A utilization metric scales + number of virtual machines handling requests to increase or + decrease proportionally to the metric. For example, a good + metric to use as a utilization_target is + https://www.googleapis.com/compute/v1/instance/network/received_bytes_count. + The autoscaler works to keep this value constant for each of + the instances. + utilization_target_type (google.cloud.compute_v1.types.AutoscalingPolicyCustomMetricUtilization.UtilizationTargetType): + Defines how target utilization value is expressed for a + Stackdriver Monitoring metric. Either GAUGE, + DELTA_PER_SECOND, or DELTA_PER_MINUTE. + """ + + class UtilizationTargetType(proto.Enum): + r"""Defines how target utilization value is expressed for a Stackdriver + Monitoring metric. Either GAUGE, DELTA_PER_SECOND, or + DELTA_PER_MINUTE. + """ + UNDEFINED_UTILIZATION_TARGET_TYPE = 0 + DELTA_PER_MINUTE = 87432861 + DELTA_PER_SECOND = 255180029 + GAUGE = 67590361 + + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + metric = proto.Field(proto.STRING, number=533067184, optional=True,) + single_instance_assignment = proto.Field( + proto.DOUBLE, number=504768064, optional=True, + ) + utilization_target = proto.Field(proto.DOUBLE, number=215905870, optional=True,) + utilization_target_type = proto.Field( + proto.ENUM, number=340169355, optional=True, enum=UtilizationTargetType, + ) + + +class AutoscalingPolicyLoadBalancingUtilization(proto.Message): + r"""Configuration parameters of autoscaling based on load + balancing. + + Attributes: + utilization_target (float): + Fraction of backend capacity utilization (set + in HTTP(S) load balancing configuration) that + the autoscaler maintains. Must be a positive + float value. If not defined, the default is 0.8. + """ + + utilization_target = proto.Field(proto.DOUBLE, number=215905870, optional=True,) + + +class AutoscalingPolicyScaleInControl(proto.Message): + r"""Configuration that allows for slower scale in so that even if + Autoscaler recommends an abrupt scale in of a MIG, it will be + throttled as specified by the parameters below. + + Attributes: + max_scaled_in_replicas (google.cloud.compute_v1.types.FixedOrPercent): + Maximum allowed number (or %) of VMs that can + be deducted from the peak recommendation during + the window autoscaler looks at when computing + recommendations. Possibly all these VMs can be + deleted at once so user service needs to be + prepared to lose that many VMs in one step. + time_window_sec (int): + How far back autoscaling looks when computing + recommendations to include directives regarding + slower scale in, as described above. + """ + + max_scaled_in_replicas = proto.Field( + proto.MESSAGE, number=180710123, optional=True, message="FixedOrPercent", + ) + time_window_sec = proto.Field(proto.INT32, number=36405300, optional=True,) + + +class AutoscalingPolicyScalingSchedule(proto.Message): + r"""Scaling based on user-defined schedule. The message describes + a single scaling schedule. A scaling schedule changes the + minimum number of VM instances an autoscaler can recommend, + which can trigger scaling out. + + Attributes: + description (str): + A description of a scaling schedule. disabled (bool): - If true, specifies the CORS policy is - disabled. The default value of false, which - indicates that the CORS policy is in effect. - expose_headers (Sequence[str]): - Specifies the content for the Access-Control- - xpose-Headers header. - max_age (int): - Specifies how long results of a preflight - request can be cached in seconds. This - translates to the Access-Control-Max-Age header. + A boolean value that specifies whether a + scaling schedule can influence autoscaler + recommendations. If set to true, then a scaling + schedule has no effect. This field is optional, + and its value is false by default. + duration_sec (int): + The duration of time intervals, in seconds, + for which this scaling schedule is to run. The + minimum allowed value is 300. This field is + required. + min_required_replicas (int): + The minimum number of VM instances that the + autoscaler will recommend in time intervals + starting according to schedule. This field is + required. + schedule (str): + The start timestamps of time intervals when this scaling + schedule is to provide a scaling signal. This field uses the + extended cron format (with an optional year field). The + expression can describe a single timestamp if the optional + year is set, in which case the scaling schedule runs once. + The schedule is interpreted with respect to time_zone. This + field is required. Note: These timestamps only describe when + autoscaler starts providing the scaling signal. The VMs need + additional time to become serving. + time_zone (str): + The time zone to use when interpreting the schedule. The + value of this field must be a time zone name from the tz + database: http://en.wikipedia.org/wiki/Tz_database. This + field is assigned a default value of ���UTC��� if left + empty. """ - allow_credentials = proto.Field(proto.BOOL, number=481263366, optional=True,) - allow_headers = proto.RepeatedField(proto.STRING, number=45179024,) - allow_methods = proto.RepeatedField(proto.STRING, number=205405372,) - allow_origin_regexes = proto.RepeatedField(proto.STRING, number=215385810,) - allow_origins = proto.RepeatedField(proto.STRING, number=194914071,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) disabled = proto.Field(proto.BOOL, number=270940796, optional=True,) - expose_headers = proto.RepeatedField(proto.STRING, number=247604747,) - max_age = proto.Field(proto.INT32, number=307559332, optional=True,) + duration_sec = proto.Field(proto.INT32, number=212356902, optional=True,) + min_required_replicas = proto.Field(proto.INT32, number=365514414, optional=True,) + schedule = proto.Field(proto.STRING, number=375820951, optional=True,) + time_zone = proto.Field(proto.STRING, number=36848094, optional=True,) -class CustomerEncryptionKeyProtectedDisk(proto.Message): - r""" +class Backend(proto.Message): + r"""Message containing information of one individual backend. Attributes: - disk_encryption_key (google.cloud.compute_v1.types.CustomerEncryptionKey): - Decrypts data associated with the disk with a - customer-supplied encryption key. - source (str): - Specifies a valid partial or full URL to an - existing Persistent Disk resource. This field is - only applicable for persistent disks. + balancing_mode (google.cloud.compute_v1.types.Backend.BalancingMode): + Specifies how to determine whether the + backend of a load balancer can handle additional + traffic or is fully loaded. For usage + guidelines, see Connection balancing mode. + Backends must use compatible balancing modes. + For more information, see Supported balancing + modes and target capacity settings and + Restrictions and guidance for instance groups. + Note: Currently, if you use the API to configure + incompatible balancing modes, the configuration + might be accepted even though it has no impact + and is ignored. Specifically, + Backend.maxUtilization is ignored when + Backend.balancingMode is RATE. In the future, + this incompatible combination will be rejected. + capacity_scaler (float): + A multiplier applied to the backend's target capacity of its + balancing mode. The default value is 1, which means the + group serves up to 100% of its configured capacity + (depending on balancingMode). A setting of 0 means the group + is completely drained, offering 0% of its available + capacity. The valid ranges are 0.0 and [0.1,1.0]. You cannot + configure a setting larger than 0 and smaller than 0.1. You + cannot configure a setting of 0 when there is only one + backend attached to the backend service. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + failover (bool): + This field designates whether this is a + failover backend. More than one failover backend + can be configured for a given BackendService. + group (str): + The fully-qualified URL of an instance group or network + endpoint group (NEG) resource. To determine what types of + backends a load balancer supports, see the `Backend services + overview `__. + You must use the *fully-qualified* URL (starting with + https://www.googleapis.com/) to specify the instance group + or NEG. Partial URLs are not supported. + max_connections (int): + Defines a target maximum number of + simultaneous connections. For usage guidelines, + see Connection balancing mode and Utilization + balancing mode. Not available if the backend's + balancingMode is RATE. + max_connections_per_endpoint (int): + Defines a target maximum number of + simultaneous connections. For usage guidelines, + see Connection balancing mode and Utilization + balancing mode. Not available if the backend's + balancingMode is RATE. + max_connections_per_instance (int): + Defines a target maximum number of + simultaneous connections. For usage guidelines, + see Connection balancing mode and Utilization + balancing mode. Not available if the backend's + balancingMode is RATE. + max_rate (int): + Defines a maximum number of HTTP requests per + second (RPS). For usage guidelines, see Rate + balancing mode and Utilization balancing mode. + Not available if the backend's balancingMode is + CONNECTION. + max_rate_per_endpoint (float): + Defines a maximum target for requests per + second (RPS). For usage guidelines, see Rate + balancing mode and Utilization balancing mode. + Not available if the backend's balancingMode is + CONNECTION. + max_rate_per_instance (float): + Defines a maximum target for requests per + second (RPS). For usage guidelines, see Rate + balancing mode and Utilization balancing mode. + Not available if the backend's balancingMode is + CONNECTION. + max_utilization (float): + Optional parameter to define a target capacity for the + UTILIZATIONbalancing mode. The valid range is [0.0, 1.0]. + For usage guidelines, see Utilization balancing mode. """ - disk_encryption_key = proto.Field( - proto.MESSAGE, number=271660677, optional=True, message="CustomerEncryptionKey", - ) - source = proto.Field(proto.STRING, number=177235995, optional=True,) - - -class Disk(proto.Message): - r"""Represents a Persistent Disk resource. - - Google Compute Engine has two Disk resources: - - - `Zonal `__ \* - `Regional `__ + class BalancingMode(proto.Enum): + r"""Specifies how to determine whether the backend of a load + balancer can handle additional traffic or is fully loaded. For + usage guidelines, see Connection balancing mode. Backends must + use compatible balancing modes. For more information, see + Supported balancing modes and target capacity settings and + Restrictions and guidance for instance groups. Note: Currently, + if you use the API to configure incompatible balancing modes, + the configuration might be accepted even though it has no impact + and is ignored. Specifically, Backend.maxUtilization is ignored + when Backend.balancingMode is RATE. In the future, this + incompatible combination will be rejected. + """ + UNDEFINED_BALANCING_MODE = 0 + CONNECTION = 246311646 + RATE = 2508000 + UTILIZATION = 157008386 - Persistent disks are required for running your VM instances. Create - both boot and non-boot (data) persistent disks. For more - information, read Persistent Disks. For more storage options, read - Storage options. + balancing_mode = proto.Field( + proto.ENUM, number=430286217, optional=True, enum=BalancingMode, + ) + capacity_scaler = proto.Field(proto.FLOAT, number=315958157, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + failover = proto.Field(proto.BOOL, number=138892530, optional=True,) + group = proto.Field(proto.STRING, number=98629247, optional=True,) + max_connections = proto.Field(proto.INT32, number=110652154, optional=True,) + max_connections_per_endpoint = proto.Field( + proto.INT32, number=216904604, optional=True, + ) + max_connections_per_instance = proto.Field( + proto.INT32, number=104671900, optional=True, + ) + max_rate = proto.Field(proto.INT32, number=408035035, optional=True,) + max_rate_per_endpoint = proto.Field(proto.FLOAT, number=129832283, optional=True,) + max_rate_per_instance = proto.Field(proto.FLOAT, number=17599579, optional=True,) + max_utilization = proto.Field(proto.FLOAT, number=148192199, optional=True,) - The disks resource represents a zonal persistent disk. For more - information, read Zonal persistent disks. - The regionDisks resource represents a regional persistent disk. For - more information, read Regional resources. (== resource_for - {$api_version}.disks ==) (== resource_for {$api_version}.regionDisks - ==) +class BackendBucket(proto.Message): + r"""Represents a Cloud Storage Bucket resource. This Cloud + Storage bucket resource is referenced by a URL map of a load + balancer. For more information, read Backend Buckets. Attributes: + bucket_name (str): + Cloud Storage bucket name. + cdn_policy (google.cloud.compute_v1.types.BackendBucketCdnPolicy): + Cloud CDN configuration for this + BackendBucket. creation_timestamp (str): [Output Only] Creation timestamp in RFC3339 text format. + custom_response_headers (Sequence[str]): + Headers that the HTTP/S load balancer should + add to proxied responses. description (str): - An optional description of this resource. - Provide this property when you create the - resource. - disk_encryption_key (google.cloud.compute_v1.types.CustomerEncryptionKey): - Encrypts the disk using a customer-supplied - encryption key. - After you encrypt a disk with a customer- - supplied key, you must provide the same key if - you use the disk later (e.g. to create a disk - snapshot, to create a disk image, to create a - machine image, or to attach the disk to a - virtual machine). - Customer-supplied encryption keys do not protect - access to metadata of the disk. - If you do not provide an encryption key when - creating the disk, then the disk will be - encrypted using an automatically generated key - and you do not need to provide a key to use the - disk later. - guest_os_features (Sequence[google.cloud.compute_v1.types.GuestOsFeature]): - A list of features to enable on the guest - operating system. Applicable only for bootable - images. Read Enabling guest operating system - features to see a list of available options. + An optional textual description of the + resource; provided by the client when the + resource is created. + enable_cdn (bool): + If true, enable Cloud CDN for this + BackendBucket. id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. + [Output Only] Unique identifier for the resource; defined by + the server. kind (str): - [Output Only] Type of the resource. Always compute#disk for - disks. - label_fingerprint (str): - A fingerprint for the labels being applied to - this disk, which is essentially a hash of the - labels set used for optimistic locking. The - fingerprint is initially generated by Compute - Engine and changes after every request to modify - or update labels. You must always provide an up- - to-date fingerprint hash in order to update or - change labels, otherwise the request will fail - with error 412 conditionNotMet. To see the - latest fingerprint, make a get() request to - retrieve a disk. - labels (Sequence[google.cloud.compute_v1.types.Disk.LabelsEntry]): - Labels to apply to this disk. These can be - later modified by the setLabels method. - last_attach_timestamp (str): - [Output Only] Last attach timestamp in RFC3339 text format. - last_detach_timestamp (str): - [Output Only] Last detach timestamp in RFC3339 text format. - license_codes (Sequence[int]): - Integer license codes indicating which - licenses are attached to this disk. - licenses (Sequence[str]): - A list of publicly visible licenses. Reserved - for Google's use. - location_hint (str): - An opaque location hint used to place the - disk close to other resources. This field is for - use by internal tools that use the public API. + Type of the resource. name (str): Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, @@ -5995,248 +6611,245 @@ class Disk(proto.Message): character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. - options (str): - Internal use only. - physical_block_size_bytes (int): - Physical block size of the persistent disk, - in bytes. If not present in a request, a default - value is used. The currently supported size is - 4096, other sizes may be added in the future. If - an unsupported value is requested, the error - message will list the supported values for the - caller's project. - provisioned_iops (int): - Indicates how many IOPS must be provisioned - for the disk. - region (str): - [Output Only] URL of the region where the disk resides. Only - applicable for regional resources. You must specify this - field as part of the HTTP request URL. It is not settable as - a field in the request body. - replica_zones (Sequence[str]): - URLs of the zones where the disk should be - replicated to. Only applicable for regional - resources. - resource_policies (Sequence[str]): - Resource policies applied to this disk for - automatic snapshot creations. - satisfies_pzs (bool): - [Output Only] Reserved for future use. self_link (str): - [Output Only] Server-defined fully-qualified URL for this - resource. - size_gb (int): - Size, in GB, of the persistent disk. You can - specify this field when creating a persistent - disk using the sourceImage, sourceSnapshot, or - sourceDisk parameter, or specify it alone to - create an empty persistent disk. If you specify - this field along with a source, the value of - sizeGb must not be less than the size of the - source. Acceptable values are 1 to 65536, - inclusive. - source_disk (str): - The source disk used to create this disk. You - can provide this as a partial or full URL to the - resource. For example, the following are valid - values: - - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk - - - https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk - - projects/project/zones/zone/disks/disk - - projects/project/regions/region/disks/disk - - zones/zone/disks/disk - - regions/region/disks/disk - source_disk_id (str): - [Output Only] The unique ID of the disk used to create this - disk. This value identifies the exact disk that was used to - create this persistent disk. For example, if you created the - persistent disk from a disk that was later deleted and - recreated under the same name, the source disk ID would - identify the exact version of the disk that was used. - source_image (str): - The source image used to create this disk. If - the source image is deleted, this field will not - be set. To create a disk with one of the public - operating system images, specify the image by - its family name. For example, specify - family/debian-9 to use the latest Debian 9 - image: projects/debian- - cloud/global/images/family/debian-9 + [Output Only] Server-defined URL for the resource. + """ - Alternatively, use a specific version of a - public operating system image: projects/debian- - cloud/global/images/debian-9-stretch-vYYYYMMDD + bucket_name = proto.Field(proto.STRING, number=283610048, optional=True,) + cdn_policy = proto.Field( + proto.MESSAGE, + number=213976452, + optional=True, + message="BackendBucketCdnPolicy", + ) + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + custom_response_headers = proto.RepeatedField(proto.STRING, number=387539094,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + enable_cdn = proto.Field(proto.BOOL, number=282942321, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - To create a disk with a custom image that you - created, specify the image name in the following - format: global/images/my-custom-image - You can also specify a custom image by its image - family, which returns the latest version of the - image in that family. Replace the image name - with family/family-name: - global/images/family/my-image-family - source_image_encryption_key (google.cloud.compute_v1.types.CustomerEncryptionKey): - The customer-supplied encryption key of the - source image. Required if the source image is - protected by a customer-supplied encryption key. - source_image_id (str): - [Output Only] The ID value of the image used to create this - disk. This value identifies the exact image that was used to - create this persistent disk. For example, if you created the - persistent disk from an image that was later deleted and - recreated under the same name, the source image ID would - identify the exact version of the image that was used. - source_snapshot (str): - The source snapshot used to create this disk. - You can provide this as a partial or full URL to - the resource. For example, the following are - valid values: - - https://www.googleapis.com/compute/v1/projects/project/global/snapshots/snapshot - - projects/project/global/snapshots/snapshot - - global/snapshots/snapshot - source_snapshot_encryption_key (google.cloud.compute_v1.types.CustomerEncryptionKey): - The customer-supplied encryption key of the - source snapshot. Required if the source snapshot - is protected by a customer-supplied encryption - key. - source_snapshot_id (str): - [Output Only] The unique ID of the snapshot used to create - this disk. This value identifies the exact snapshot that was - used to create this persistent disk. For example, if you - created the persistent disk from a snapshot that was later - deleted and recreated under the same name, the source - snapshot ID would identify the exact version of the snapshot - that was used. - source_storage_object (str): - The full Google Cloud Storage URI where the - disk image is stored. This file must be a gzip- - compressed tarball whose name ends in .tar.gz or - virtual machine disk whose name ends in vmdk. - Valid URIs may start with gs:// or - https://storage.googleapis.com/. This flag is - not optimized for creating multiple disks from a - source storage object. To create many disks from - a source storage object, use gcloud compute - images import instead. - status (google.cloud.compute_v1.types.Disk.Status): - [Output Only] The status of disk creation. +class BackendBucketCdnPolicy(proto.Message): + r"""Message containing Cloud CDN configuration for a backend + bucket. - - CREATING: Disk is provisioning. - - RESTORING: Source data is being copied into the disk. - - FAILED: Disk creation failed. - - READY: Disk is ready for use. - - DELETING: Disk is deleting. - type_ (str): - URL of the disk type resource describing - which disk type to use to create the disk. - Provide this when creating the disk. For - example: - projects/project/zones/zone/diskTypes/pd- - standard or pd-ssd - users (Sequence[str]): - [Output Only] Links to the users of the disk (attached - instances) in form: - projects/project/zones/zone/instances/instance - zone (str): - [Output Only] URL of the zone where the disk resides. You - must specify this field as part of the HTTP request URL. It - is not settable as a field in the request body. + Attributes: + bypass_cache_on_request_headers (Sequence[google.cloud.compute_v1.types.BackendBucketCdnPolicyBypassCacheOnRequestHeader]): + Bypass the cache when the specified request + headers are matched - e.g. Pragma or + Authorization headers. Up to 5 headers can be + specified. The cache is bypassed for all + cdnPolicy.cacheMode settings. + cache_mode (google.cloud.compute_v1.types.BackendBucketCdnPolicy.CacheMode): + Specifies the cache setting for all responses from this + backend. The possible values are: USE_ORIGIN_HEADERS + Requires the origin to set valid caching headers to cache + content. Responses without these headers will not be cached + at Google's edge, and will require a full trip to the origin + on every request, potentially impacting performance and + increasing load on the origin server. FORCE_CACHE_ALL Cache + all content, ignoring any "private", "no-store" or + "no-cache" directives in Cache-Control response headers. + Warning: this may result in Cloud CDN caching private, + per-user (user identifiable) content. CACHE_ALL_STATIC + Automatically cache static content, including common image + formats, media (video and audio), and web assets (JavaScript + and CSS). Requests and responses that are marked as + uncacheable, as well as dynamic content (including HTML), + will not be cached. + client_ttl (int): + Specifies a separate client (e.g. browser client) maximum + TTL. This is used to clamp the max-age (or Expires) value + sent to the client. With FORCE_CACHE_ALL, the lesser of + client_ttl and default_ttl is used for the response max-age + directive, along with a "public" directive. For cacheable + content in CACHE_ALL_STATIC mode, client_ttl clamps the + max-age from the origin (if specified), or else sets the + response max-age directive to the lesser of the client_ttl + and default_ttl, and also ensures a "public" cache-control + directive is present. If a client TTL is not specified, a + default value (1 hour) will be used. The maximum allowed + value is 86400s (1 day). + default_ttl (int): + Specifies the default TTL for cached content served by this + origin for responses that do not have an existing valid TTL + (max-age or s-max-age). Setting a TTL of "0" means "always + revalidate". The value of defaultTTL cannot be set to a + value greater than that of maxTTL, but can be equal. When + the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL will + overwrite the TTL set in all responses. The maximum allowed + value is 31,622,400s (1 year), noting that infrequently + accessed objects may be evicted from the cache before the + defined TTL. + max_ttl (int): + Specifies the maximum allowed TTL for cached + content served by this origin. Cache directives + that attempt to set a max-age or s-maxage higher + than this, or an Expires header more than maxTTL + seconds in the future will be capped at the + value of maxTTL, as if it were the value of an + s-maxage Cache-Control directive. Headers sent + to the client will not be modified. Setting a + TTL of "0" means "always revalidate". The + maximum allowed value is 31,622,400s (1 year), + noting that infrequently accessed objects may be + evicted from the cache before the defined TTL. + negative_caching (bool): + Negative caching allows per-status code TTLs to be set, in + order to apply fine-grained caching for common errors or + redirects. This can reduce the load on your origin and + improve end-user experience by reducing response latency. + When the cache mode is set to CACHE_ALL_STATIC or + USE_ORIGIN_HEADERS, negative caching applies to responses + with the specified response code that lack any + Cache-Control, Expires, or Pragma: no-cache directives. When + the cache mode is set to FORCE_CACHE_ALL, negative caching + applies to all responses with the specified response code, + and override any caching headers. By default, Cloud CDN will + apply the following default TTLs to these status codes: HTTP + 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m + HTTP 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal + Reasons): 120s HTTP 405 (Method Not Found), 421 (Misdirected + Request), 501 (Not Implemented): 60s. These defaults can be + overridden in negative_caching_policy. + negative_caching_policy (Sequence[google.cloud.compute_v1.types.BackendBucketCdnPolicyNegativeCachingPolicy]): + Sets a cache TTL for the specified HTTP status code. + negative_caching must be enabled to configure + negative_caching_policy. Omitting the policy and leaving + negative_caching enabled will use Cloud CDN's default cache + TTLs. Note that when specifying an explicit + negative_caching_policy, you should take care to specify a + cache TTL for all response codes that you wish to cache. + Cloud CDN will not apply any default negative caching when a + policy exists. + request_coalescing (bool): + If true then Cloud CDN will combine multiple + concurrent cache fill requests into a small + number of requests to the origin. + serve_while_stale (int): + Serve existing content from the cache (if + available) when revalidating content with the + origin, or when an error is encountered when + refreshing the cache. This setting defines the + default "max-stale" duration for any cached + responses that do not specify a max-stale + directive. Stale responses that exceed the TTL + configured here will not be served. The default + limit (max-stale) is 86400s (1 day), which will + allow stale content to be served up to this + limit beyond the max-age (or s-max-age) of a + cached response. The maximum allowed value is + 604800 (1 week). Set this to zero (0) to disable + serve-while-stale. + signed_url_cache_max_age_sec (int): + Maximum number of seconds the response to a signed URL + request will be considered fresh. After this time period, + the response will be revalidated before being served. + Defaults to 1hr (3600s). When serving responses to signed + URL requests, Cloud CDN will internally behave as though all + responses from this backend had a "Cache-Control: public, + max-age=[TTL]" header, regardless of any existing + Cache-Control header. The actual headers served in responses + will not be altered. + signed_url_key_names (Sequence[str]): + [Output Only] Names of the keys for signing request URLs. """ - class Status(proto.Enum): - r"""[Output Only] The status of disk creation. - - - CREATING: Disk is provisioning. - - RESTORING: Source data is being copied into the disk. - - FAILED: Disk creation failed. - - READY: Disk is ready for use. - - DELETING: Disk is deleting. + class CacheMode(proto.Enum): + r"""Specifies the cache setting for all responses from this backend. The + possible values are: USE_ORIGIN_HEADERS Requires the origin to set + valid caching headers to cache content. Responses without these + headers will not be cached at Google's edge, and will require a full + trip to the origin on every request, potentially impacting + performance and increasing load on the origin server. + FORCE_CACHE_ALL Cache all content, ignoring any "private", + "no-store" or "no-cache" directives in Cache-Control response + headers. Warning: this may result in Cloud CDN caching private, + per-user (user identifiable) content. CACHE_ALL_STATIC Automatically + cache static content, including common image formats, media (video + and audio), and web assets (JavaScript and CSS). Requests and + responses that are marked as uncacheable, as well as dynamic content + (including HTML), will not be cached. """ - UNDEFINED_STATUS = 0 - CREATING = 455564985 - DELETING = 528602024 - FAILED = 455706685 - READY = 77848963 - RESTORING = 404263851 + UNDEFINED_CACHE_MODE = 0 + CACHE_ALL_STATIC = 355027945 + FORCE_CACHE_ALL = 486026928 + INVALID_CACHE_MODE = 381295560 + USE_ORIGIN_HEADERS = 55380261 - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - disk_encryption_key = proto.Field( - proto.MESSAGE, number=271660677, optional=True, message="CustomerEncryptionKey", - ) - guest_os_features = proto.RepeatedField( - proto.MESSAGE, number=79294545, message="GuestOsFeature", + bypass_cache_on_request_headers = proto.RepeatedField( + proto.MESSAGE, + number=486203082, + message="BackendBucketCdnPolicyBypassCacheOnRequestHeader", ) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - label_fingerprint = proto.Field(proto.STRING, number=178124825, optional=True,) - labels = proto.MapField(proto.STRING, proto.STRING, number=500195327,) - last_attach_timestamp = proto.Field(proto.STRING, number=42159653, optional=True,) - last_detach_timestamp = proto.Field(proto.STRING, number=56471027, optional=True,) - license_codes = proto.RepeatedField(proto.INT64, number=45482664,) - licenses = proto.RepeatedField(proto.STRING, number=337642578,) - location_hint = proto.Field(proto.STRING, number=350519505, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - options = proto.Field(proto.STRING, number=361137822, optional=True,) - physical_block_size_bytes = proto.Field( - proto.INT64, number=420007943, optional=True, + cache_mode = proto.Field( + proto.ENUM, number=28877888, optional=True, enum=CacheMode, ) - provisioned_iops = proto.Field(proto.INT64, number=186769108, optional=True,) - region = proto.Field(proto.STRING, number=138946292, optional=True,) - replica_zones = proto.RepeatedField(proto.STRING, number=48438272,) - resource_policies = proto.RepeatedField(proto.STRING, number=22220385,) - satisfies_pzs = proto.Field(proto.BOOL, number=480964267, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - size_gb = proto.Field(proto.INT64, number=494929369, optional=True,) - source_disk = proto.Field(proto.STRING, number=451753793, optional=True,) - source_disk_id = proto.Field(proto.STRING, number=454190809, optional=True,) - source_image = proto.Field(proto.STRING, number=50443319, optional=True,) - source_image_encryption_key = proto.Field( - proto.MESSAGE, number=381503659, optional=True, message="CustomerEncryptionKey", + client_ttl = proto.Field(proto.INT32, number=29034360, optional=True,) + default_ttl = proto.Field(proto.INT32, number=100253422, optional=True,) + max_ttl = proto.Field(proto.INT32, number=307578001, optional=True,) + negative_caching = proto.Field(proto.BOOL, number=336110005, optional=True,) + negative_caching_policy = proto.RepeatedField( + proto.MESSAGE, + number=155359996, + message="BackendBucketCdnPolicyNegativeCachingPolicy", ) - source_image_id = proto.Field(proto.STRING, number=55328291, optional=True,) - source_snapshot = proto.Field(proto.STRING, number=126061928, optional=True,) - source_snapshot_encryption_key = proto.Field( - proto.MESSAGE, number=303679322, optional=True, message="CustomerEncryptionKey", + request_coalescing = proto.Field(proto.BOOL, number=532808276, optional=True,) + serve_while_stale = proto.Field(proto.INT32, number=236682203, optional=True,) + signed_url_cache_max_age_sec = proto.Field( + proto.INT64, number=269374534, optional=True, ) - source_snapshot_id = proto.Field(proto.STRING, number=98962258, optional=True,) - source_storage_object = proto.Field(proto.STRING, number=233052711, optional=True,) - status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) - type_ = proto.Field(proto.STRING, number=3575610, optional=True,) - users = proto.RepeatedField(proto.STRING, number=111578632,) - zone = proto.Field(proto.STRING, number=3744684, optional=True,) + signed_url_key_names = proto.RepeatedField(proto.STRING, number=371848885,) + + +class BackendBucketCdnPolicyBypassCacheOnRequestHeader(proto.Message): + r"""Bypass the cache when the specified request headers are present, + e.g. Pragma or Authorization headers. Values are case insensitive. + The presence of such a header overrides the cache_mode setting. + Attributes: + header_name (str): + The header field name to match on when + bypassing cache. Values are case-insensitive. + """ -class DisksScopedList(proto.Message): - r""" + header_name = proto.Field(proto.STRING, number=110223613, optional=True,) + + +class BackendBucketCdnPolicyNegativeCachingPolicy(proto.Message): + r"""Specify CDN TTLs for response error codes. Attributes: - disks (Sequence[google.cloud.compute_v1.types.Disk]): - [Output Only] A list of disks contained in this scope. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning which replaces the list - of disks when the list is empty. + code (int): + The HTTP status code to define a TTL against. + Only HTTP status codes 300, 301, 302, 307, 308, + 404, 405, 410, 421, 451 and 501 are can be + specified as values, and you cannot specify a + status code more than once. + ttl (int): + The TTL (in seconds) for which to cache + responses with the corresponding status code. + The maximum allowed value is 1800s (30 minutes), + noting that infrequently accessed objects may be + evicted from the cache before the defined TTL. """ - disks = proto.RepeatedField(proto.MESSAGE, number=95594102, message="Disk",) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) + code = proto.Field(proto.INT32, number=3059181, optional=True,) + ttl = proto.Field(proto.INT32, number=115180, optional=True,) -class DiskAggregatedList(proto.Message): - r""" +class BackendBucketList(proto.Message): + r"""Contains a list of BackendBucket resources. Attributes: id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.DiskAggregatedList.ItemsEntry]): - A list of DisksScopedList resources. + items (Sequence[google.cloud.compute_v1.types.BackendBucket]): + A list of BackendBucket resources. kind (str): - [Output Only] Type of resource. Always - compute#diskAggregatedList for aggregated lists of - persistent disks. + Type of resource. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -6246,8 +6859,6 @@ class DiskAggregatedList(proto.Message): to continue paging through the results. self_link (str): [Output Only] Server-defined URL for this resource. - unreachables (Sequence[str]): - [Output Only] Unreachable resources. warning (google.cloud.compute_v1.types.Warning): [Output Only] Informational warning message. """ @@ -6257,98 +6868,437 @@ def raw_page(self): return self id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.MapField( - proto.STRING, proto.MESSAGE, number=100526016, message="DisksScopedList", + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="BackendBucket", ) kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - unreachables = proto.RepeatedField(proto.STRING, number=243372063,) warning = proto.Field( proto.MESSAGE, number=50704284, optional=True, message="Warning", ) -class DiskInstantiationConfig(proto.Message): - r"""A specification of the desired way to instantiate a disk in - the instance template when its created from a source instance. +class BackendService(proto.Message): + r"""Represents a Backend Service resource. A backend service defines how + Google Cloud load balancers distribute traffic. The backend service + configuration contains a set of values, such as the protocol used to + connect to backends, various distribution and session settings, + health checks, and timeouts. These settings provide fine-grained + control over how your load balancer behaves. Most of the settings + have default values that allow for easy configuration if you need to + get started quickly. Backend services in Google Compute Engine can + be either regionally or globally scoped. \* + `Global `__ + \* + `Regional `__ + For more information, see Backend Services. Attributes: - auto_delete (bool): - Specifies whether the disk will be auto- - eleted when the instance is deleted (but not - when the disk is detached from the instance). - custom_image (str): - The custom source image to be used to restore - this disk when instantiating this instance - template. - device_name (str): - Specifies the device name of the disk to - which the configurations apply to. - instantiate_from (google.cloud.compute_v1.types.DiskInstantiationConfig.InstantiateFrom): - Specifies whether to include the disk and - what image to use. Possible values are: - - source-image: to use the same image that was - used to create the source instance's - corresponding disk. Applicable to the boot disk - and additional read-write disks. - source-image- - family: to use the same image family that was - used to create the source instance's - corresponding disk. Applicable to the boot disk - and additional read-write disks. - custom-image: - to use a user-provided image url for disk - creation. Applicable to the boot disk and - additional read-write disks. - attach-read-only: - to attach a read-only disk. Applicable to read- - only disks. - do-not-include: to exclude a disk - from the template. Applicable to additional - read-write disks, local SSDs, and read-only - disks. + affinity_cookie_ttl_sec (int): + Lifetime of cookies in seconds. This setting is applicable + to external and internal HTTP(S) load balancers and Traffic + Director and requires GENERATED_COOKIE or HTTP_COOKIE + session affinity. If set to 0, the cookie is non-persistent + and lasts only until the end of the browser session (or + equivalent). The maximum allowed value is one day (86,400). + Not supported when the backend service is referenced by a + URL map that is bound to target gRPC proxy that has + validateForProxyless field set to true. + backends (Sequence[google.cloud.compute_v1.types.Backend]): + The list of backends that serve this + BackendService. + cdn_policy (google.cloud.compute_v1.types.BackendServiceCdnPolicy): + Cloud CDN configuration for this + BackendService. Only available for specified + load balancer types. + circuit_breakers (google.cloud.compute_v1.types.CircuitBreakers): + + connection_draining (google.cloud.compute_v1.types.ConnectionDraining): + + consistent_hash (google.cloud.compute_v1.types.ConsistentHashLoadBalancerSettings): + Consistent Hash-based load balancing can be used to provide + soft session affinity based on HTTP headers, cookies or + other properties. This load balancing policy is applicable + only for HTTP connections. The affinity to a particular + destination host will be lost when one or more hosts are + added/removed from the destination service. This field + specifies parameters that control consistent hashing. This + field is only applicable when localityLbPolicy is set to + MAGLEV or RING_HASH. This field is applicable to either: - A + regional backend service with the service_protocol set to + HTTP, HTTPS, or HTTP2, and load_balancing_scheme set to + INTERNAL_MANAGED. - A global backend service with the + load_balancing_scheme set to INTERNAL_SELF_MANAGED. Not + supported when the backend service is referenced by a URL + map that is bound to target gRPC proxy that has + validateForProxyless field set to true. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + custom_request_headers (Sequence[str]): + Headers that the load balancer adds to proxied requests. See + `Creating custom + headers `__. + custom_response_headers (Sequence[str]): + Headers that the load balancer adds to proxied responses. + See `Creating custom + headers `__. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + enable_c_d_n (bool): + If true, enables Cloud CDN for the backend + service of an external HTTP(S) load balancer. + failover_policy (google.cloud.compute_v1.types.BackendServiceFailoverPolicy): + Requires at least one backend instance group to be defined + as a backup (failover) backend. For load balancers that have + configurable failover: `Internal TCP/UDP Load + Balancing `__ + and `external TCP/UDP Load + Balancing `__. + fingerprint (str): + Fingerprint of this resource. A hash of the + contents stored in this object. This field is + used in optimistic locking. This field will be + ignored when inserting a BackendService. An up- + to-date fingerprint must be provided in order to + update the BackendService, otherwise the request + will fail with error 412 conditionNotMet. To see + the latest fingerprint, make a get() request to + retrieve a BackendService. + health_checks (Sequence[str]): + The list of URLs to the healthChecks, + httpHealthChecks (legacy), or httpsHealthChecks + (legacy) resource for health checking this + backend service. Not all backend services + support legacy health checks. See Load balancer + guide. Currently, at most one health check can + be specified for each backend service. Backend + services with instance group or zonal NEG + backends must have a health check. Backend + services with internet or serverless NEG + backends must not have a health check. + iap (google.cloud.compute_v1.types.BackendServiceIAP): + The configurations for Identity-Aware Proxy + on this resource. Not available for Internal + TCP/UDP Load Balancing and Network Load + Balancing. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + kind (str): + [Output Only] Type of resource. Always + compute#backendService for backend services. + load_balancing_scheme (google.cloud.compute_v1.types.BackendService.LoadBalancingScheme): + Specifies the load balancer type. A backend + service created for one type of load balancer + cannot be used with another. For more + information, refer to Choosing a load balancer. + locality_lb_policy (google.cloud.compute_v1.types.BackendService.LocalityLbPolicy): + The load balancing algorithm used within the scope of the + locality. The possible values are: - ROUND_ROBIN: This is a + simple policy in which each healthy backend is selected in + round robin order. This is the default. - LEAST_REQUEST: An + O(1) algorithm which selects two random healthy hosts and + picks the host which has fewer active requests. - RING_HASH: + The ring/modulo hash load balancer implements consistent + hashing to backends. The algorithm has the property that the + addition/removal of a host from a set of N hosts only + affects 1/N of the requests. - RANDOM: The load balancer + selects a random healthy host. - ORIGINAL_DESTINATION: + Backend host is selected based on the client connection + metadata, i.e., connections are opened to the same address + as the destination address of the incoming connection before + the connection was redirected to the load balancer. - + MAGLEV: used as a drop in replacement for the ring hash load + balancer. Maglev is not as stable as ring hash but has + faster table lookup build times and host selection times. + For more information about Maglev, see + https://ai.google/research/pubs/pub44824 This field is + applicable to either: - A regional backend service with the + service_protocol set to HTTP, HTTPS, or HTTP2, and + load_balancing_scheme set to INTERNAL_MANAGED. - A global + backend service with the load_balancing_scheme set to + INTERNAL_SELF_MANAGED. If sessionAffinity is not NONE, and + this field is not set to MAGLEV or RING_HASH, session + affinity settings will not take effect. Only the default + ROUND_ROBIN policy is supported when the backend service is + referenced by a URL map that is bound to target gRPC proxy + that has validateForProxyless field set to true. + log_config (google.cloud.compute_v1.types.BackendServiceLogConfig): + This field denotes the logging options for + the load balancer traffic served by this backend + service. If logging is enabled, logs will be + exported to Stackdriver. + max_stream_duration (google.cloud.compute_v1.types.Duration): + Specifies the default maximum duration (timeout) for streams + to this service. Duration is computed from the beginning of + the stream until the response has been completely processed, + including all retries. A stream that does not complete in + this duration is closed. If not specified, there will be no + timeout limit, i.e. the maximum duration is infinite. This + value can be overridden in the PathMatcher configuration of + the UrlMap that references this backend service. This field + is only allowed when the loadBalancingScheme of the backend + service is INTERNAL_SELF_MANAGED. + name (str): + Name of the resource. Provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. + network (str): + The URL of the network to which this backend + service belongs. This field can only be + specified when the load balancing scheme is set + to INTERNAL. + outlier_detection (google.cloud.compute_v1.types.OutlierDetection): + Settings controlling the eviction of unhealthy hosts from + the load balancing pool for the backend service. If not set, + this feature is considered disabled. This field is + applicable to either: - A regional backend service with the + service_protocol set to HTTP, HTTPS, or HTTP2, and + load_balancing_scheme set to INTERNAL_MANAGED. - A global + backend service with the load_balancing_scheme set to + INTERNAL_SELF_MANAGED. Not supported when the backend + service is referenced by a URL map that is bound to target + gRPC proxy that has validateForProxyless field set to true. + port (int): + Deprecated in favor of portName. The TCP port + to connect on the backend. The default value is + 80. For Internal TCP/UDP Load Balancing and + Network Load Balancing, omit port. + port_name (str): + A named port on a backend instance group representing the + port for communication to the backend VMs in that group. The + named port must be `defined on each backend instance + group `__. + This parameter has no meaning if the backends are NEGs. For + Internal TCP/UDP Load Balancing and Network Load Balancing, + omit port_name. + protocol (google.cloud.compute_v1.types.BackendService.Protocol): + The protocol this BackendService uses to + communicate with backends. Possible values are + HTTP, HTTPS, HTTP2, TCP, SSL, UDP or GRPC. + depending on the chosen load balancer or Traffic + Director configuration. Refer to the + documentation for the load balancers or for + Traffic Director for more information. Must be + set to GRPC when the backend service is + referenced by a URL map that is bound to target + gRPC proxy. + region (str): + [Output Only] URL of the region where the regional backend + service resides. This field is not applicable to global + backend services. You must specify this field as part of the + HTTP request URL. It is not settable as a field in the + request body. + security_policy (str): + [Output Only] The resource URL for the security policy + associated with this backend service. + security_settings (google.cloud.compute_v1.types.SecuritySettings): + This field specifies the security policy that applies to + this backend service. This field is applicable to either: - + A regional backend service with the service_protocol set to + HTTP, HTTPS, or HTTP2, and load_balancing_scheme set to + INTERNAL_MANAGED. - A global backend service with the + load_balancing_scheme set to INTERNAL_SELF_MANAGED. + self_link (str): + [Output Only] Server-defined URL for the resource. + session_affinity (google.cloud.compute_v1.types.BackendService.SessionAffinity): + Type of session affinity to use. The default is NONE. For a + detailed description of session affinity options, see: + `Session + affinity `__. + Not supported when the backend service is referenced by a + URL map that is bound to target gRPC proxy that has + validateForProxyless field set to true. + subsetting (google.cloud.compute_v1.types.Subsetting): + + timeout_sec (int): + Not supported when the backend service is + referenced by a URL map that is bound to target + gRPC proxy that has validateForProxyless field + set to true. Instead, use maxStreamDuration. """ - class InstantiateFrom(proto.Enum): - r"""Specifies whether to include the disk and what image to use. - Possible values are: - source-image: to use the same image that - was used to create the source instance's corresponding disk. - Applicable to the boot disk and additional read-write disks. - - source-image-family: to use the same image family that was used - to create the source instance's corresponding disk. Applicable - to the boot disk and additional read-write disks. - custom- - image: to use a user-provided image url for disk creation. - Applicable to the boot disk and additional read-write disks. - - attach-read-only: to attach a read-only disk. Applicable to - read-only disks. - do-not-include: to exclude a disk from the - template. Applicable to additional read-write disks, local SSDs, - and read-only disks. + class LoadBalancingScheme(proto.Enum): + r"""Specifies the load balancer type. A backend service created + for one type of load balancer cannot be used with another. For + more information, refer to Choosing a load balancer. """ - UNDEFINED_INSTANTIATE_FROM = 0 - ATTACH_READ_ONLY = 513775419 - BLANK = 63281460 - CUSTOM_IMAGE = 196311789 - DEFAULT = 115302945 - DO_NOT_INCLUDE = 104218952 - SOURCE_IMAGE = 62631959 - SOURCE_IMAGE_FAMILY = 76850316 + UNDEFINED_LOAD_BALANCING_SCHEME = 0 + EXTERNAL = 35607499 + INTERNAL = 279295677 + INTERNAL_MANAGED = 37350397 + INTERNAL_SELF_MANAGED = 236211150 + INVALID_LOAD_BALANCING_SCHEME = 275352060 - auto_delete = proto.Field(proto.BOOL, number=464761403, optional=True,) - custom_image = proto.Field(proto.STRING, number=184123149, optional=True,) - device_name = proto.Field(proto.STRING, number=67541716, optional=True,) - instantiate_from = proto.Field( - proto.ENUM, number=393383903, optional=True, enum=InstantiateFrom, + class LocalityLbPolicy(proto.Enum): + r"""The load balancing algorithm used within the scope of the locality. + The possible values are: - ROUND_ROBIN: This is a simple policy in + which each healthy backend is selected in round robin order. This is + the default. - LEAST_REQUEST: An O(1) algorithm which selects two + random healthy hosts and picks the host which has fewer active + requests. - RING_HASH: The ring/modulo hash load balancer implements + consistent hashing to backends. The algorithm has the property that + the addition/removal of a host from a set of N hosts only affects + 1/N of the requests. - RANDOM: The load balancer selects a random + healthy host. - ORIGINAL_DESTINATION: Backend host is selected based + on the client connection metadata, i.e., connections are opened to + the same address as the destination address of the incoming + connection before the connection was redirected to the load + balancer. - MAGLEV: used as a drop in replacement for the ring hash + load balancer. Maglev is not as stable as ring hash but has faster + table lookup build times and host selection times. For more + information about Maglev, see + https://ai.google/research/pubs/pub44824 This field is applicable to + either: - A regional backend service with the service_protocol set + to HTTP, HTTPS, or HTTP2, and load_balancing_scheme set to + INTERNAL_MANAGED. - A global backend service with the + load_balancing_scheme set to INTERNAL_SELF_MANAGED. If + sessionAffinity is not NONE, and this field is not set to MAGLEV or + RING_HASH, session affinity settings will not take effect. Only the + default ROUND_ROBIN policy is supported when the backend service is + referenced by a URL map that is bound to target gRPC proxy that has + validateForProxyless field set to true. + """ + UNDEFINED_LOCALITY_LB_POLICY = 0 + INVALID_LB_POLICY = 323318707 + LEAST_REQUEST = 46604921 + MAGLEV = 119180266 + ORIGINAL_DESTINATION = 166297216 + RANDOM = 262527171 + RING_HASH = 432795069 + ROUND_ROBIN = 153895801 + + class Protocol(proto.Enum): + r"""The protocol this BackendService uses to communicate with + backends. Possible values are HTTP, HTTPS, HTTP2, TCP, SSL, UDP + or GRPC. depending on the chosen load balancer or Traffic + Director configuration. Refer to the documentation for the load + balancers or for Traffic Director for more information. Must be + set to GRPC when the backend service is referenced by a URL map + that is bound to target gRPC proxy. + """ + UNDEFINED_PROTOCOL = 0 + GRPC = 2196510 + HTTP = 2228360 + HTTP2 = 69079210 + HTTPS = 69079243 + SSL = 82412 + TCP = 82881 + UDP = 83873 + + class SessionAffinity(proto.Enum): + r"""Type of session affinity to use. The default is NONE. For a detailed + description of session affinity options, see: `Session + affinity `__. + Not supported when the backend service is referenced by a URL map + that is bound to target gRPC proxy that has validateForProxyless + field set to true. + """ + UNDEFINED_SESSION_AFFINITY = 0 + CLIENT_IP = 345665051 + CLIENT_IP_NO_DESTINATION = 106122516 + CLIENT_IP_PORT_PROTO = 221722926 + CLIENT_IP_PROTO = 25322148 + GENERATED_COOKIE = 370321204 + HEADER_FIELD = 200737960 + HTTP_COOKIE = 494981627 + NONE = 2402104 + + affinity_cookie_ttl_sec = proto.Field(proto.INT32, number=369996954, optional=True,) + backends = proto.RepeatedField(proto.MESSAGE, number=510839903, message="Backend",) + cdn_policy = proto.Field( + proto.MESSAGE, + number=213976452, + optional=True, + message="BackendServiceCdnPolicy", + ) + circuit_breakers = proto.Field( + proto.MESSAGE, number=421340061, optional=True, message="CircuitBreakers", + ) + connection_draining = proto.Field( + proto.MESSAGE, number=461096747, optional=True, message="ConnectionDraining", + ) + consistent_hash = proto.Field( + proto.MESSAGE, + number=905883, + optional=True, + message="ConsistentHashLoadBalancerSettings", + ) + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + custom_request_headers = proto.RepeatedField(proto.STRING, number=27977992,) + custom_response_headers = proto.RepeatedField(proto.STRING, number=387539094,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + enable_c_d_n = proto.Field(proto.BOOL, number=250733499, optional=True,) + failover_policy = proto.Field( + proto.MESSAGE, + number=105658655, + optional=True, + message="BackendServiceFailoverPolicy", ) + fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) + health_checks = proto.RepeatedField(proto.STRING, number=448370606,) + iap = proto.Field( + proto.MESSAGE, number=104024, optional=True, message="BackendServiceIAP", + ) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + load_balancing_scheme = proto.Field( + proto.ENUM, number=363890244, optional=True, enum=LoadBalancingScheme, + ) + locality_lb_policy = proto.Field( + proto.ENUM, number=131431487, optional=True, enum=LocalityLbPolicy, + ) + log_config = proto.Field( + proto.MESSAGE, + number=351299741, + optional=True, + message="BackendServiceLogConfig", + ) + max_stream_duration = proto.Field( + proto.MESSAGE, number=61428376, optional=True, message="Duration", + ) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + network = proto.Field(proto.STRING, number=232872494, optional=True,) + outlier_detection = proto.Field( + proto.MESSAGE, number=354625086, optional=True, message="OutlierDetection", + ) + port = proto.Field(proto.INT32, number=3446913, optional=True,) + port_name = proto.Field(proto.STRING, number=41534345, optional=True,) + protocol = proto.Field(proto.ENUM, number=84577944, optional=True, enum=Protocol,) + region = proto.Field(proto.STRING, number=138946292, optional=True,) + security_policy = proto.Field(proto.STRING, number=171082513, optional=True,) + security_settings = proto.Field( + proto.MESSAGE, number=478649922, optional=True, message="SecuritySettings", + ) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + session_affinity = proto.Field( + proto.ENUM, number=463888561, optional=True, enum=SessionAffinity, + ) + subsetting = proto.Field( + proto.MESSAGE, number=450283536, optional=True, message="Subsetting", + ) + timeout_sec = proto.Field(proto.INT32, number=79994995, optional=True,) -class DiskList(proto.Message): - r"""A list of Disk resources. +class BackendServiceAggregatedList(proto.Message): + r"""Contains a list of BackendServicesScopedList. Attributes: id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.Disk]): - A list of Disk resources. + items (Sequence[google.cloud.compute_v1.types.BackendServiceAggregatedList.ItemsEntry]): + A list of BackendServicesScopedList + resources. kind (str): - [Output Only] Type of resource. Always compute#diskList for - lists of disks. + Type of resource. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -6358,6 +7308,8 @@ class DiskList(proto.Message): to continue paging through the results. self_link (str): [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. warning (google.cloud.compute_v1.types.Warning): [Output Only] Informational warning message. """ @@ -6367,137 +7319,350 @@ def raw_page(self): return self id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Disk",) + items = proto.MapField( + proto.STRING, + proto.MESSAGE, + number=100526016, + message="BackendServicesScopedList", + ) kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) warning = proto.Field( proto.MESSAGE, number=50704284, optional=True, message="Warning", ) -class DiskMoveRequest(proto.Message): - r""" +class BackendServiceCdnPolicy(proto.Message): + r"""Message containing Cloud CDN configuration for a backend + service. + + Attributes: + bypass_cache_on_request_headers (Sequence[google.cloud.compute_v1.types.BackendServiceCdnPolicyBypassCacheOnRequestHeader]): + Bypass the cache when the specified request + headers are matched - e.g. Pragma or + Authorization headers. Up to 5 headers can be + specified. The cache is bypassed for all + cdnPolicy.cacheMode settings. + cache_key_policy (google.cloud.compute_v1.types.CacheKeyPolicy): + The CacheKeyPolicy for this CdnPolicy. + cache_mode (google.cloud.compute_v1.types.BackendServiceCdnPolicy.CacheMode): + Specifies the cache setting for all responses from this + backend. The possible values are: USE_ORIGIN_HEADERS + Requires the origin to set valid caching headers to cache + content. Responses without these headers will not be cached + at Google's edge, and will require a full trip to the origin + on every request, potentially impacting performance and + increasing load on the origin server. FORCE_CACHE_ALL Cache + all content, ignoring any "private", "no-store" or + "no-cache" directives in Cache-Control response headers. + Warning: this may result in Cloud CDN caching private, + per-user (user identifiable) content. CACHE_ALL_STATIC + Automatically cache static content, including common image + formats, media (video and audio), and web assets (JavaScript + and CSS). Requests and responses that are marked as + uncacheable, as well as dynamic content (including HTML), + will not be cached. + client_ttl (int): + Specifies a separate client (e.g. browser client) maximum + TTL. This is used to clamp the max-age (or Expires) value + sent to the client. With FORCE_CACHE_ALL, the lesser of + client_ttl and default_ttl is used for the response max-age + directive, along with a "public" directive. For cacheable + content in CACHE_ALL_STATIC mode, client_ttl clamps the + max-age from the origin (if specified), or else sets the + response max-age directive to the lesser of the client_ttl + and default_ttl, and also ensures a "public" cache-control + directive is present. If a client TTL is not specified, a + default value (1 hour) will be used. The maximum allowed + value is 86400s (1 day). + default_ttl (int): + Specifies the default TTL for cached content served by this + origin for responses that do not have an existing valid TTL + (max-age or s-max-age). Setting a TTL of "0" means "always + revalidate". The value of defaultTTL cannot be set to a + value greater than that of maxTTL, but can be equal. When + the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL will + overwrite the TTL set in all responses. The maximum allowed + value is 31,622,400s (1 year), noting that infrequently + accessed objects may be evicted from the cache before the + defined TTL. + max_ttl (int): + Specifies the maximum allowed TTL for cached + content served by this origin. Cache directives + that attempt to set a max-age or s-maxage higher + than this, or an Expires header more than maxTTL + seconds in the future will be capped at the + value of maxTTL, as if it were the value of an + s-maxage Cache-Control directive. Headers sent + to the client will not be modified. Setting a + TTL of "0" means "always revalidate". The + maximum allowed value is 31,622,400s (1 year), + noting that infrequently accessed objects may be + evicted from the cache before the defined TTL. + negative_caching (bool): + Negative caching allows per-status code TTLs to be set, in + order to apply fine-grained caching for common errors or + redirects. This can reduce the load on your origin and + improve end-user experience by reducing response latency. + When the cache mode is set to CACHE_ALL_STATIC or + USE_ORIGIN_HEADERS, negative caching applies to responses + with the specified response code that lack any + Cache-Control, Expires, or Pragma: no-cache directives. When + the cache mode is set to FORCE_CACHE_ALL, negative caching + applies to all responses with the specified response code, + and override any caching headers. By default, Cloud CDN will + apply the following default TTLs to these status codes: HTTP + 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m + HTTP 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal + Reasons): 120s HTTP 405 (Method Not Found), 421 (Misdirected + Request), 501 (Not Implemented): 60s. These defaults can be + overridden in negative_caching_policy. + negative_caching_policy (Sequence[google.cloud.compute_v1.types.BackendServiceCdnPolicyNegativeCachingPolicy]): + Sets a cache TTL for the specified HTTP status code. + negative_caching must be enabled to configure + negative_caching_policy. Omitting the policy and leaving + negative_caching enabled will use Cloud CDN's default cache + TTLs. Note that when specifying an explicit + negative_caching_policy, you should take care to specify a + cache TTL for all response codes that you wish to cache. + Cloud CDN will not apply any default negative caching when a + policy exists. + request_coalescing (bool): + If true then Cloud CDN will combine multiple + concurrent cache fill requests into a small + number of requests to the origin. + serve_while_stale (int): + Serve existing content from the cache (if + available) when revalidating content with the + origin, or when an error is encountered when + refreshing the cache. This setting defines the + default "max-stale" duration for any cached + responses that do not specify a max-stale + directive. Stale responses that exceed the TTL + configured here will not be served. The default + limit (max-stale) is 86400s (1 day), which will + allow stale content to be served up to this + limit beyond the max-age (or s-max-age) of a + cached response. The maximum allowed value is + 604800 (1 week). Set this to zero (0) to disable + serve-while-stale. + signed_url_cache_max_age_sec (int): + Maximum number of seconds the response to a signed URL + request will be considered fresh. After this time period, + the response will be revalidated before being served. + Defaults to 1hr (3600s). When serving responses to signed + URL requests, Cloud CDN will internally behave as though all + responses from this backend had a "Cache-Control: public, + max-age=[TTL]" header, regardless of any existing + Cache-Control header. The actual headers served in responses + will not be altered. + signed_url_key_names (Sequence[str]): + [Output Only] Names of the keys for signing request URLs. + """ + + class CacheMode(proto.Enum): + r"""Specifies the cache setting for all responses from this backend. The + possible values are: USE_ORIGIN_HEADERS Requires the origin to set + valid caching headers to cache content. Responses without these + headers will not be cached at Google's edge, and will require a full + trip to the origin on every request, potentially impacting + performance and increasing load on the origin server. + FORCE_CACHE_ALL Cache all content, ignoring any "private", + "no-store" or "no-cache" directives in Cache-Control response + headers. Warning: this may result in Cloud CDN caching private, + per-user (user identifiable) content. CACHE_ALL_STATIC Automatically + cache static content, including common image formats, media (video + and audio), and web assets (JavaScript and CSS). Requests and + responses that are marked as uncacheable, as well as dynamic content + (including HTML), will not be cached. + """ + UNDEFINED_CACHE_MODE = 0 + CACHE_ALL_STATIC = 355027945 + FORCE_CACHE_ALL = 486026928 + INVALID_CACHE_MODE = 381295560 + USE_ORIGIN_HEADERS = 55380261 + + bypass_cache_on_request_headers = proto.RepeatedField( + proto.MESSAGE, + number=486203082, + message="BackendServiceCdnPolicyBypassCacheOnRequestHeader", + ) + cache_key_policy = proto.Field( + proto.MESSAGE, number=159263727, optional=True, message="CacheKeyPolicy", + ) + cache_mode = proto.Field( + proto.ENUM, number=28877888, optional=True, enum=CacheMode, + ) + client_ttl = proto.Field(proto.INT32, number=29034360, optional=True,) + default_ttl = proto.Field(proto.INT32, number=100253422, optional=True,) + max_ttl = proto.Field(proto.INT32, number=307578001, optional=True,) + negative_caching = proto.Field(proto.BOOL, number=336110005, optional=True,) + negative_caching_policy = proto.RepeatedField( + proto.MESSAGE, + number=155359996, + message="BackendServiceCdnPolicyNegativeCachingPolicy", + ) + request_coalescing = proto.Field(proto.BOOL, number=532808276, optional=True,) + serve_while_stale = proto.Field(proto.INT32, number=236682203, optional=True,) + signed_url_cache_max_age_sec = proto.Field( + proto.INT64, number=269374534, optional=True, + ) + signed_url_key_names = proto.RepeatedField(proto.STRING, number=371848885,) + + +class BackendServiceCdnPolicyBypassCacheOnRequestHeader(proto.Message): + r"""Bypass the cache when the specified request headers are present, + e.g. Pragma or Authorization headers. Values are case insensitive. + The presence of such a header overrides the cache_mode setting. + Attributes: - destination_zone (str): - The URL of the destination zone to move the - disk. This can be a full or partial URL. For - example, the following are all valid URLs to a - zone: - - https://www.googleapis.com/compute/v1/projects/project/zones/zone - - projects/project/zones/zone - - zones/zone - target_disk (str): - The URL of the target disk to move. This can - be a full or partial URL. For example, the - following are all valid URLs to a disk: - - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk - - projects/project/zones/zone/disks/disk - - zones/zone/disks/disk + header_name (str): + The header field name to match on when + bypassing cache. Values are case-insensitive. """ - destination_zone = proto.Field(proto.STRING, number=131854653, optional=True,) - target_disk = proto.Field(proto.STRING, number=62433163, optional=True,) + header_name = proto.Field(proto.STRING, number=110223613, optional=True,) -class DiskType(proto.Message): - r"""Represents a Disk Type resource. +class BackendServiceCdnPolicyNegativeCachingPolicy(proto.Message): + r"""Specify CDN TTLs for response error codes. + Attributes: + code (int): + The HTTP status code to define a TTL against. + Only HTTP status codes 300, 301, 302, 307, 308, + 404, 405, 410, 421, 451 and 501 are can be + specified as values, and you cannot specify a + status code more than once. + ttl (int): + The TTL (in seconds) for which to cache + responses with the corresponding status code. + The maximum allowed value is 1800s (30 minutes), + noting that infrequently accessed objects may be + evicted from the cache before the defined TTL. + """ - Google Compute Engine has two Disk Type resources: + code = proto.Field(proto.INT32, number=3059181, optional=True,) + ttl = proto.Field(proto.INT32, number=115180, optional=True,) - - `Regional `__ - \* - `Zonal `__ - You can choose from a variety of disk types based on your needs. For - more information, read Storage options. +class BackendServiceFailoverPolicy(proto.Message): + r"""For load balancers that have configurable failover: `Internal + TCP/UDP Load + Balancing `__ + and `external TCP/UDP Load + Balancing `__. On failover or + failback, this field indicates whether connection draining will be + honored. Google Cloud has a fixed connection draining timeout of 10 + minutes. A setting of true terminates existing TCP connections to + the active pool during failover and failback, immediately draining + traffic. A setting of false allows existing TCP connections to + persist, even on VMs no longer in the active pool, for up to the + duration of the connection draining timeout (10 minutes). + + Attributes: + disable_connection_drain_on_failover (bool): + This can be set to true only if the protocol + is TCP. The default is false. + drop_traffic_if_unhealthy (bool): + If set to true, connections to the load balancer are dropped + when all primary and all backup backend VMs are unhealthy.If + set to false, connections are distributed among all primary + VMs when all primary and all backup backend VMs are + unhealthy. For load balancers that have configurable + failover: `Internal TCP/UDP Load + Balancing `__ + and `external TCP/UDP Load + Balancing `__. The + default is false. + failover_ratio (float): + The value of the field must be in the range [0, 1]. If the + value is 0, the load balancer performs a failover when the + number of healthy primary VMs equals zero. For all other + values, the load balancer performs a failover when the total + number of healthy primary VMs is less than this ratio. For + load balancers that have configurable failover: `Internal + TCP/UDP Load + Balancing `__ + and `external TCP/UDP Load + Balancing `__. + """ - The diskTypes resource represents disk types for a zonal persistent - disk. For more information, read Zonal persistent disks. + disable_connection_drain_on_failover = proto.Field( + proto.BOOL, number=182150753, optional=True, + ) + drop_traffic_if_unhealthy = proto.Field( + proto.BOOL, number=112289428, optional=True, + ) + failover_ratio = proto.Field(proto.FLOAT, number=212667006, optional=True,) - The regionDiskTypes resource represents disk types for a regional - persistent disk. For more information, read Regional persistent - disks. (== resource_for {$api_version}.diskTypes ==) (== - resource_for {$api_version}.regionDiskTypes ==) +class BackendServiceGroupHealth(proto.Message): + r""" Attributes: - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - default_disk_size_gb (int): - [Output Only] Server-defined default disk size in GB. - deprecated (google.cloud.compute_v1.types.DeprecationStatus): - [Output Only] The deprecation status associated with this - disk type. - description (str): - [Output Only] An optional description of this resource. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. + annotations (Sequence[google.cloud.compute_v1.types.BackendServiceGroupHealth.AnnotationsEntry]): + Metadata defined as annotations on the + network endpoint group. + health_status (Sequence[google.cloud.compute_v1.types.HealthStatus]): + Health state of the backend instances or + endpoints in requested instance or network + endpoint group, determined based on configured + health checks. kind (str): - [Output Only] Type of the resource. Always compute#diskType - for disk types. - name (str): - [Output Only] Name of the resource. - region (str): - [Output Only] URL of the region where the disk type resides. - Only applicable for regional resources. You must specify - this field as part of the HTTP request URL. It is not - settable as a field in the request body. - self_link (str): - [Output Only] Server-defined URL for the resource. - valid_disk_size (str): - [Output Only] An optional textual description of the valid - disk size, such as "10GB-10TB". - zone (str): - [Output Only] URL of the zone where the disk type resides. - You must specify this field as part of the HTTP request URL. - It is not settable as a field in the request body. + [Output Only] Type of resource. Always + compute#backendServiceGroupHealth for the health of backend + services. """ - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - default_disk_size_gb = proto.Field(proto.INT64, number=270619253, optional=True,) - deprecated = proto.Field( - proto.MESSAGE, number=515138995, optional=True, message="DeprecationStatus", + annotations = proto.MapField(proto.STRING, proto.STRING, number=112032548,) + health_status = proto.RepeatedField( + proto.MESSAGE, number=380545845, message="HealthStatus", ) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) kind = proto.Field(proto.STRING, number=3292052, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - region = proto.Field(proto.STRING, number=138946292, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - valid_disk_size = proto.Field(proto.STRING, number=493962464, optional=True,) - zone = proto.Field(proto.STRING, number=3744684, optional=True,) -class DiskTypesScopedList(proto.Message): - r""" +class BackendServiceIAP(proto.Message): + r"""Identity-Aware Proxy Attributes: - disk_types (Sequence[google.cloud.compute_v1.types.DiskType]): - [Output Only] A list of disk types contained in this scope. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning which replaces the list - of disk types when the list is empty. + enabled (bool): + Whether the serving infrastructure will + authenticate and authorize all incoming + requests. If true, the oauth2ClientId and + oauth2ClientSecret fields must be non-empty. + oauth2_client_id (str): + OAuth2 client ID to use for the + authentication flow. + oauth2_client_secret (str): + OAuth2 client secret to use for the + authentication flow. For security reasons, this + value cannot be retrieved via the API. Instead, + the SHA-256 hash of the value is returned in the + oauth2ClientSecretSha256 field. @InputOnly + oauth2_client_secret_sha256 (str): + [Output Only] SHA256 hash value for the field + oauth2_client_secret above. """ - disk_types = proto.RepeatedField( - proto.MESSAGE, number=198926167, message="DiskType", - ) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + enabled = proto.Field(proto.BOOL, number=1018689, optional=True,) + oauth2_client_id = proto.Field(proto.STRING, number=314017611, optional=True,) + oauth2_client_secret = proto.Field(proto.STRING, number=50999520, optional=True,) + oauth2_client_secret_sha256 = proto.Field( + proto.STRING, number=112903782, optional=True, ) -class DiskTypeAggregatedList(proto.Message): - r""" +class BackendServiceList(proto.Message): + r"""Contains a list of BackendService resources. Attributes: id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.DiskTypeAggregatedList.ItemsEntry]): - A list of DiskTypesScopedList resources. + items (Sequence[google.cloud.compute_v1.types.BackendService]): + A list of BackendService resources. kind (str): [Output Only] Type of resource. Always - compute#diskTypeAggregatedList. + compute#backendServiceList for lists of backend services. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -6507,8 +7672,6 @@ class DiskTypeAggregatedList(proto.Message): to continue paging through the results. self_link (str): [Output Only] Server-defined URL for this resource. - unreachables (Sequence[str]): - [Output Only] Unreachable resources. warning (google.cloud.compute_v1.types.Warning): [Output Only] Informational warning message. """ @@ -6518,291 +7681,456 @@ def raw_page(self): return self id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.MapField( - proto.STRING, proto.MESSAGE, number=100526016, message="DiskTypesScopedList", + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="BackendService", ) kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - unreachables = proto.RepeatedField(proto.STRING, number=243372063,) warning = proto.Field( proto.MESSAGE, number=50704284, optional=True, message="Warning", ) -class DiskTypeList(proto.Message): - r"""Contains a list of disk types. +class BackendServiceLogConfig(proto.Message): + r"""The available logging options for the load balancer traffic + served by this backend service. + Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.DiskType]): - A list of DiskType resources. - kind (str): - [Output Only] Type of resource. Always compute#diskTypeList - for disk types. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + enable (bool): + This field denotes whether to enable logging + for the load balancer traffic served by this + backend service. + sample_rate (float): + This field can only be specified if logging is enabled for + this backend service. The value of the field must be in [0, + 1]. This configures the sampling rate of requests to the + load balancer where 1.0 means all logged requests are + reported and 0.0 means no logged requests are reported. The + default value is 1.0. """ - @property - def raw_page(self): - return self + enable = proto.Field(proto.BOOL, number=311764355, optional=True,) + sample_rate = proto.Field(proto.FLOAT, number=153193045, optional=True,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="DiskType",) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + +class BackendServiceReference(proto.Message): + r""" + Attributes: + backend_service (str): + + """ + + backend_service = proto.Field(proto.STRING, number=306946058, optional=True,) + + +class BackendServicesScopedList(proto.Message): + r""" + Attributes: + backend_services (Sequence[google.cloud.compute_v1.types.BackendService]): + A list of BackendServices contained in this + scope. + warning (google.cloud.compute_v1.types.Warning): + Informational warning which replaces the list + of backend services when the list is empty. + """ + + backend_services = proto.RepeatedField( + proto.MESSAGE, number=388522409, message="BackendService", + ) warning = proto.Field( proto.MESSAGE, number=50704284, optional=True, message="Warning", ) -class DisksAddResourcePoliciesRequest(proto.Message): - r""" +class Binding(proto.Message): + r"""Associates ``members`` with a ``role``. Attributes: - resource_policies (Sequence[str]): - Resource policies to be added to this disk. - Currently you can only specify one policy here. + binding_id (str): + This is deprecated and has no effect. Do not + use. + condition (google.cloud.compute_v1.types.Expr): + The condition that is associated with this binding. If the + condition evaluates to ``true``, then this binding applies + to the current request. If the condition evaluates to + ``false``, then this binding does not apply to the current + request. However, a different role binding might grant the + same role to one or more of the members in this binding. To + learn which resources support conditions in their IAM + policies, see the `IAM + documentation `__. + members (Sequence[str]): + Specifies the identities requesting access for a Cloud + Platform resource. ``members`` can have the following + values: \* ``allUsers``: A special identifier that + represents anyone who is on the internet; with or without a + Google account. \* ``allAuthenticatedUsers``: A special + identifier that represents anyone who is authenticated with + a Google account or a service account. \* + ``user:{emailid}``: An email address that represents a + specific Google account. For example, ``alice@example.com`` + . \* ``serviceAccount:{emailid}``: An email address that + represents a service account. For example, + ``my-other-app@appspot.gserviceaccount.com``. \* + ``group:{emailid}``: An email address that represents a + Google group. For example, ``admins@example.com``. \* + ``deleted:user:{emailid}?uid={uniqueid}``: An email address + (plus unique identifier) representing a user that has been + recently deleted. For example, + ``alice@example.com?uid=123456789012345678901``. If the user + is recovered, this value reverts to ``user:{emailid}`` and + the recovered user retains the role in the binding. \* + ``deleted:serviceAccount:{emailid}?uid={uniqueid}``: An + email address (plus unique identifier) representing a + service account that has been recently deleted. For example, + ``my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901``. + If the service account is undeleted, this value reverts to + ``serviceAccount:{emailid}`` and the undeleted service + account retains the role in the binding. \* + ``deleted:group:{emailid}?uid={uniqueid}``: An email address + (plus unique identifier) representing a Google group that + has been recently deleted. For example, + ``admins@example.com?uid=123456789012345678901``. If the + group is recovered, this value reverts to + ``group:{emailid}`` and the recovered group retains the role + in the binding. \* ``domain:{domain}``: The G Suite domain + (primary) that represents all the users of that domain. For + example, ``google.com`` or ``example.com``. + role (str): + Role that is assigned to ``members``. For example, + ``roles/viewer``, ``roles/editor``, or ``roles/owner``. """ - resource_policies = proto.RepeatedField(proto.STRING, number=22220385,) + binding_id = proto.Field(proto.STRING, number=441088277, optional=True,) + condition = proto.Field( + proto.MESSAGE, number=212430107, optional=True, message="Expr", + ) + members = proto.RepeatedField(proto.STRING, number=412010777,) + role = proto.Field(proto.STRING, number=3506294, optional=True,) -class DisksRemoveResourcePoliciesRequest(proto.Message): - r""" +class BulkInsertInstanceRequest(proto.Message): + r"""A request message for Instances.BulkInsert. See the method + description for details. + Attributes: - resource_policies (Sequence[str]): - Resource policies to be removed from this - disk. + bulk_insert_instance_resource_resource (google.cloud.compute_v1.types.BulkInsertInstanceResource): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. """ - resource_policies = proto.RepeatedField(proto.STRING, number=22220385,) + bulk_insert_instance_resource_resource = proto.Field( + proto.MESSAGE, number=41427278, message="BulkInsertInstanceResource", + ) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class DisksResizeRequest(proto.Message): - r""" +class BulkInsertInstanceResource(proto.Message): + r"""A transient resource used in compute.instances.bulkInsert and + compute.regionInstances.bulkInsert . This resource is not + persisted anywhere, it is used only for processing the requests. + Attributes: - size_gb (int): - The new size of the persistent disk, which is - specified in GB. + count (int): + The maximum number of instances to create. + instance_properties (google.cloud.compute_v1.types.InstanceProperties): + The instance properties defining the VM + instances to be created. Required if + sourceInstanceTemplate is not provided. + location_policy (google.cloud.compute_v1.types.LocationPolicy): + Policy for chosing target zone. + min_count (int): + The minimum number of instances to create. If no min_count + is specified then count is used as the default value. If + min_count instances cannot be created, then no instances + will be created and instances already created will be + deleted. + name_pattern (str): + The string pattern used for the names of the VMs. Either + name_pattern or per_instance_properties must be set. The + pattern must contain one continuous sequence of placeholder + hash characters (#) with each character corresponding to one + digit of the generated instance name. Example: a + name_pattern of inst-#### generates instance names such as + inst-0001 and inst-0002. If existing instances in the same + project and zone have names that match the name pattern then + the generated instance numbers start after the biggest + existing number. For example, if there exists an instance + with name inst-0050, then instance names generated using the + pattern inst-#### begin with inst-0051. The name pattern + placeholder #...# can contain up to 18 characters. + per_instance_properties (Sequence[google.cloud.compute_v1.types.BulkInsertInstanceResource.PerInstancePropertiesEntry]): + Per-instance properties to be set on individual instances. + Keys of this map specify requested instance names. Can be + empty if name_pattern is used. + source_instance_template (str): + Specifies the instance template from which to + create instances. You may combine + sourceInstanceTemplate with instanceProperties + to override specific values from an existing + instance template. Bulk API follows the + semantics of JSON Merge Patch described by RFC + 7396. It can be a full or partial URL. For + example, the following are all valid URLs to an + instance template: - + https://www.googleapis.com/compute/v1/projects/project + /global/instanceTemplates/instanceTemplate - + projects/project/global/instanceTemplates/instanceTemplate + - global/instanceTemplates/instanceTemplate This + field is optional. """ - size_gb = proto.Field(proto.INT64, number=494929369, optional=True,) + count = proto.Field(proto.INT64, number=94851343, optional=True,) + instance_properties = proto.Field( + proto.MESSAGE, number=215355165, optional=True, message="InstanceProperties", + ) + location_policy = proto.Field( + proto.MESSAGE, number=465689852, optional=True, message="LocationPolicy", + ) + min_count = proto.Field(proto.INT64, number=523228386, optional=True,) + name_pattern = proto.Field(proto.STRING, number=413815260, optional=True,) + per_instance_properties = proto.MapField( + proto.STRING, + proto.MESSAGE, + number=108502267, + message="BulkInsertInstanceResourcePerInstanceProperties", + ) + source_instance_template = proto.Field( + proto.STRING, number=332423616, optional=True, + ) -class DisplayDevice(proto.Message): - r"""A set of Display Device options +class BulkInsertInstanceResourcePerInstanceProperties(proto.Message): + r"""Per-instance properties to be set on individual instances. To + be extended in the future. + Attributes: - enable_display (bool): - Defines whether the instance has Display - enabled. + name (str): + This field is only temporary. It will be + removed. Do not use it. """ - enable_display = proto.Field(proto.BOOL, number=14266886, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) -class DistributionPolicyZoneConfiguration(proto.Message): - r""" +class BulkInsertRegionInstanceRequest(proto.Message): + r"""A request message for RegionInstances.BulkInsert. See the + method description for details. + Attributes: - zone (str): - The URL of the zone. The zone must exist in - the region where the managed instance group is - located. + bulk_insert_instance_resource_resource (google.cloud.compute_v1.types.BulkInsertInstanceResource): + The body resource for this request + project (str): + Project ID for this request. + region (str): + The name of the region for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - zone = proto.Field(proto.STRING, number=3744684, optional=True,) + bulk_insert_instance_resource_resource = proto.Field( + proto.MESSAGE, number=41427278, message="BulkInsertInstanceResource", + ) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class DistributionPolicy(proto.Message): +class CacheInvalidationRule(proto.Message): r""" Attributes: - target_shape (google.cloud.compute_v1.types.DistributionPolicy.TargetShape): - The distribution shape to which the group - converges either proactively or on resize events - (depending on the value set in - updatePolicy.instanceRedistributionType). - zones (Sequence[google.cloud.compute_v1.types.DistributionPolicyZoneConfiguration]): - Zones where the regional managed instance - group will create and manage its instances. + host (str): + If set, this invalidation rule will only + apply to requests with a Host header matching + host. + path (str): + """ - class TargetShape(proto.Enum): - r"""The distribution shape to which the group converges either - proactively or on resize events (depending on the value set in - updatePolicy.instanceRedistributionType). - """ - UNDEFINED_TARGET_SHAPE = 0 - ANY = 64972 - BALANCED = 468409608 - EVEN = 2140442 + host = proto.Field(proto.STRING, number=3208616, optional=True,) + path = proto.Field(proto.STRING, number=3433509, optional=True,) - target_shape = proto.Field( - proto.ENUM, number=338621299, optional=True, enum=TargetShape, - ) - zones = proto.RepeatedField( - proto.MESSAGE, number=116085319, message="DistributionPolicyZoneConfiguration", - ) +class CacheKeyPolicy(proto.Message): + r"""Message containing what to include in the cache key for a + request for Cloud CDN. -class ExchangedPeeringRoute(proto.Message): - r""" Attributes: - dest_range (str): - The destination range of the route. - imported (bool): - True if the peering route has been imported - from a peer. The actual import happens if the - field networkPeering.importCustomRoutes is true - for this network, and - networkPeering.exportCustomRoutes is true for - the peer network, and the import does not result - in a route conflict. - next_hop_region (str): - The region of peering route next hop, only - applies to dynamic routes. - priority (int): - The priority of the peering route. - type_ (google.cloud.compute_v1.types.ExchangedPeeringRoute.Type): - The type of the peering route. + include_host (bool): + If true, requests to different hosts will be + cached separately. + include_protocol (bool): + If true, http and https requests will be + cached separately. + include_query_string (bool): + If true, include query string parameters in the cache key + according to query_string_whitelist and + query_string_blacklist. If neither is set, the entire query + string will be included. If false, the query string will be + excluded from the cache key entirely. + query_string_blacklist (Sequence[str]): + Names of query string parameters to exclude in cache keys. + All other parameters will be included. Either specify + query_string_whitelist or query_string_blacklist, not both. + '&' and '=' will be percent encoded and not treated as + delimiters. + query_string_whitelist (Sequence[str]): + Names of query string parameters to include in cache keys. + All other parameters will be excluded. Either specify + query_string_whitelist or query_string_blacklist, not both. + '&' and '=' will be percent encoded and not treated as + delimiters. """ - class Type(proto.Enum): - r"""The type of the peering route.""" - UNDEFINED_TYPE = 0 - DYNAMIC_PEERING_ROUTE = 469794858 - STATIC_PEERING_ROUTE = 473407545 - SUBNET_PEERING_ROUTE = 465782504 + include_host = proto.Field(proto.BOOL, number=486867679, optional=True,) + include_protocol = proto.Field(proto.BOOL, number=303507535, optional=True,) + include_query_string = proto.Field(proto.BOOL, number=474036639, optional=True,) + query_string_blacklist = proto.RepeatedField(proto.STRING, number=354964742,) + query_string_whitelist = proto.RepeatedField(proto.STRING, number=52456496,) - dest_range = proto.Field(proto.STRING, number=381327712, optional=True,) - imported = proto.Field(proto.BOOL, number=114502404, optional=True,) - next_hop_region = proto.Field(proto.STRING, number=122577014, optional=True,) - priority = proto.Field(proto.UINT32, number=445151652, optional=True,) - type_ = proto.Field(proto.ENUM, number=3575610, optional=True, enum=Type,) +class CircuitBreakers(proto.Message): + r"""Settings controlling the volume of requests, connections and + retries to this backend service. -class ExchangedPeeringRoutesList(proto.Message): - r""" Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.ExchangedPeeringRoute]): - A list of ExchangedPeeringRoute resources. - kind (str): - [Output Only] Type of resource. Always - compute#exchangedPeeringRoutesList for exchanged peering - routes lists. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + max_connections (int): + Not supported when the backend service is + referenced by a URL map that is bound to target + gRPC proxy that has validateForProxyless field + set to true. + max_pending_requests (int): + Not supported when the backend service is + referenced by a URL map that is bound to target + gRPC proxy that has validateForProxyless field + set to true. + max_requests (int): + The maximum number of parallel requests that + allowed to the backend service. If not + specified, there is no limit. + max_requests_per_connection (int): + Not supported when the backend service is + referenced by a URL map that is bound to target + gRPC proxy that has validateForProxyless field + set to true. + max_retries (int): + Not supported when the backend service is + referenced by a URL map that is bound to target + gRPC proxy that has validateForProxyless field + set to true. """ - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="ExchangedPeeringRoute", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + max_connections = proto.Field(proto.INT32, number=110652154, optional=True,) + max_pending_requests = proto.Field(proto.INT32, number=375558887, optional=True,) + max_requests = proto.Field(proto.INT32, number=28097599, optional=True,) + max_requests_per_connection = proto.Field( + proto.INT32, number=361630528, optional=True, ) + max_retries = proto.Field(proto.INT32, number=55546219, optional=True,) -class ExternalVpnGatewayInterface(proto.Message): - r"""The interface for the external VPN gateway. +class CloneRulesFirewallPolicyRequest(proto.Message): + r"""A request message for FirewallPolicies.CloneRules. See the + method description for details. + Attributes: - id (int): - The numeric ID of this interface. The allowed input values - for this id for different redundancy types of external VPN - gateway: SINGLE_IP_INTERNALLY_REDUNDANT - 0 - TWO_IPS_REDUNDANCY - 0, 1 FOUR_IPS_REDUNDANCY - 0, 1, 2, 3 - ip_address (str): - IP address of the interface in the external - VPN gateway. Only IPv4 is supported. This IP - address can be either from your on-premise - gateway or another Cloud provider's VPN gateway, - it cannot be an IP address from Google Compute - Engine. + firewall_policy (str): + Name of the firewall policy to update. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + source_firewall_policy (str): + The firewall policy from which to copy rules. """ - id = proto.Field(proto.UINT32, number=3355, optional=True,) - ip_address = proto.Field(proto.STRING, number=406272220, optional=True,) - - -class ExternalVpnGateway(proto.Message): - r"""Represents an external VPN gateway. - - External VPN gateway is the on-premises VPN gateway(s) or another - cloud provider's VPN gateway that connects to your Google Cloud VPN - gateway. + firewall_policy = proto.Field(proto.STRING, number=498173265,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + source_firewall_policy = proto.Field(proto.STRING, number=25013549, optional=True,) - To create a highly available VPN from Google Cloud Platform to your - VPN gateway or another cloud provider's VPN gateway, you must create - a external VPN gateway resource with information about the other - gateway. - For more information about using external VPN gateways, see Creating - an HA VPN gateway and tunnel pair to a peer VPN. (== resource_for - {$api_version}.externalVpnGateways ==) +class Commitment(proto.Message): + r"""Represents a regional Commitment resource. Creating a + commitment resource means that you are purchasing a committed + use contract with an explicit start and end time. You can create + commitments based on vCPUs and memory usage and receive + discounted rates. For full details, read Signing Up for + Committed Use Discounts. Attributes: + category (google.cloud.compute_v1.types.Commitment.Category): + The category of the commitment. Category + MACHINE specifies commitments composed of + machine resources such as VCPU or MEMORY, listed + in resources. Category LICENSE specifies + commitments composed of software licenses, + listed in licenseResources. Note that only + MACHINE commitments should have a Type + specified. creation_timestamp (str): [Output Only] Creation timestamp in RFC3339 text format. description (str): An optional description of this resource. Provide this property when you create the resource. + end_timestamp (str): + [Output Only] Commitment end time in RFC3339 text format. id (int): [Output Only] The unique identifier for the resource. This identifier is defined by the server. - interfaces (Sequence[google.cloud.compute_v1.types.ExternalVpnGatewayInterface]): - List of interfaces for this external VPN - gateway. kind (str): [Output Only] Type of the resource. Always - compute#externalVpnGateway for externalVpnGateways. - label_fingerprint (str): - A fingerprint for the labels being applied to - this ExternalVpnGateway, which is essentially a - hash of the labels set used for optimistic - locking. The fingerprint is initially generated - by Compute Engine and changes after every - request to modify or update labels. You must - always provide an up-to-date fingerprint hash in - order to update or change labels, otherwise the - request will fail with error 412 - conditionNotMet. To see the latest fingerprint, - make a get() request to retrieve an - ExternalVpnGateway. - labels (Sequence[google.cloud.compute_v1.types.ExternalVpnGateway.LabelsEntry]): - Labels for this resource. These can only be - added or modified by the setLabels method. Each - label key/value pair must comply with RFC1035. - Label values may be empty. + compute#commitment for commitments. + license_resource (google.cloud.compute_v1.types.LicenseResourceCommitment): + The license specification required as part of + a license commitment. name (str): Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, @@ -6812,377 +8140,173 @@ class ExternalVpnGateway(proto.Message): character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. - redundancy_type (google.cloud.compute_v1.types.ExternalVpnGateway.RedundancyType): - Indicates the user-supplied redundancy type - of this external VPN gateway. + plan (google.cloud.compute_v1.types.Commitment.Plan): + The plan for this commitment, which determines duration and + discount rate. The currently supported plans are + TWELVE_MONTH (1 year), and THIRTY_SIX_MONTH (3 years). + region (str): + [Output Only] URL of the region where this commitment may be + used. + reservations (Sequence[google.cloud.compute_v1.types.Reservation]): + List of reservations in this commitment. + resources (Sequence[google.cloud.compute_v1.types.ResourceCommitment]): + A list of commitment amounts for particular + resources. Note that VCPU and MEMORY resource + commitments must occur together. self_link (str): [Output Only] Server-defined URL for the resource. + start_timestamp (str): + [Output Only] Commitment start time in RFC3339 text format. + status (google.cloud.compute_v1.types.Commitment.Status): + [Output Only] Status of the commitment with regards to + eventual expiration (each commitment has an end date + defined). One of the following values: NOT_YET_ACTIVE, + ACTIVE, EXPIRED. + status_message (str): + [Output Only] An optional, human-readable explanation of the + status. + type_ (google.cloud.compute_v1.types.Commitment.Type): + The type of commitment, which affects the discount rate and + the eligible resources. Type MEMORY_OPTIMIZED specifies a + commitment that will only apply to memory optimized + machines. Type ACCELERATOR_OPTIMIZED specifies a commitment + that will only apply to accelerator optimized machines. """ - class RedundancyType(proto.Enum): - r"""Indicates the user-supplied redundancy type of this external - VPN gateway. + class Category(proto.Enum): + r"""The category of the commitment. Category MACHINE specifies + commitments composed of machine resources such as VCPU or + MEMORY, listed in resources. Category LICENSE specifies + commitments composed of software licenses, listed in + licenseResources. Note that only MACHINE commitments should have + a Type specified. """ - UNDEFINED_REDUNDANCY_TYPE = 0 - FOUR_IPS_REDUNDANCY = 520087913 - SINGLE_IP_INTERNALLY_REDUNDANT = 133914873 - TWO_IPS_REDUNDANCY = 367049635 + UNDEFINED_CATEGORY = 0 + CATEGORY_UNSPECIFIED = 509189462 + LICENSE = 347869217 + MACHINE = 469553191 + + class Plan(proto.Enum): + r"""The plan for this commitment, which determines duration and discount + rate. The currently supported plans are TWELVE_MONTH (1 year), and + THIRTY_SIX_MONTH (3 years). + """ + UNDEFINED_PLAN = 0 + INVALID = 530283991 + THIRTY_SIX_MONTH = 266295942 + TWELVE_MONTH = 173083962 + + class Status(proto.Enum): + r"""[Output Only] Status of the commitment with regards to eventual + expiration (each commitment has an end date defined). One of the + following values: NOT_YET_ACTIVE, ACTIVE, EXPIRED. + """ + UNDEFINED_STATUS = 0 + ACTIVE = 314733318 + CREATING = 455564985 + EXPIRED = 482489093 + NOT_YET_ACTIVE = 20607337 + + class Type(proto.Enum): + r"""The type of commitment, which affects the discount rate and the + eligible resources. Type MEMORY_OPTIMIZED specifies a commitment + that will only apply to memory optimized machines. Type + ACCELERATOR_OPTIMIZED specifies a commitment that will only apply to + accelerator optimized machines. + """ + UNDEFINED_TYPE = 0 + ACCELERATOR_OPTIMIZED = 280848403 + COMPUTE_OPTIMIZED = 158349023 + GENERAL_PURPOSE = 299793543 + GENERAL_PURPOSE_E2 = 301911877 + GENERAL_PURPOSE_N2 = 301912156 + GENERAL_PURPOSE_N2D = 232471400 + MEMORY_OPTIMIZED = 281753417 + TYPE_UNSPECIFIED = 437714322 + category = proto.Field(proto.ENUM, number=50511102, optional=True, enum=Category,) creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) description = proto.Field(proto.STRING, number=422937596, optional=True,) + end_timestamp = proto.Field(proto.STRING, number=468096690, optional=True,) id = proto.Field(proto.UINT64, number=3355, optional=True,) - interfaces = proto.RepeatedField( - proto.MESSAGE, number=12073562, message="ExternalVpnGatewayInterface", - ) kind = proto.Field(proto.STRING, number=3292052, optional=True,) - label_fingerprint = proto.Field(proto.STRING, number=178124825, optional=True,) - labels = proto.MapField(proto.STRING, proto.STRING, number=500195327,) + license_resource = proto.Field( + proto.MESSAGE, + number=437955148, + optional=True, + message="LicenseResourceCommitment", + ) name = proto.Field(proto.STRING, number=3373707, optional=True,) - redundancy_type = proto.Field( - proto.ENUM, number=271443740, optional=True, enum=RedundancyType, + plan = proto.Field(proto.ENUM, number=3443497, optional=True, enum=Plan,) + region = proto.Field(proto.STRING, number=138946292, optional=True,) + reservations = proto.RepeatedField( + proto.MESSAGE, number=399717927, message="Reservation", + ) + resources = proto.RepeatedField( + proto.MESSAGE, number=164412965, message="ResourceCommitment", ) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + start_timestamp = proto.Field(proto.STRING, number=83645817, optional=True,) + status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) + status_message = proto.Field(proto.STRING, number=297428154, optional=True,) + type_ = proto.Field(proto.ENUM, number=3575610, optional=True, enum=Type,) -class ExternalVpnGatewayList(proto.Message): - r"""Response to the list request, and contains a list of - externalVpnGateways. - +class CommitmentAggregatedList(proto.Message): + r""" Attributes: - etag (str): - id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.ExternalVpnGateway]): - A list of ExternalVpnGateway resources. + items (Sequence[google.cloud.compute_v1.types.CommitmentAggregatedList.ItemsEntry]): + A list of CommitmentsScopedList resources. kind (str): [Output Only] Type of resource. Always - compute#externalVpnGatewayList for lists of - externalVpnGateways. + compute#commitmentAggregatedList for aggregated lists of + commitments. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. - """ - - @property - def raw_page(self): - return self - - etag = proto.Field(proto.STRING, number=3123477, optional=True,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="ExternalVpnGateway", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) - - -class FileContentBuffer(proto.Message): - r""" - Attributes: - content (str): - The raw content in the secure keys file. - file_type (google.cloud.compute_v1.types.FileContentBuffer.FileType): - The file type of source file. - """ - - class FileType(proto.Enum): - r"""The file type of source file.""" - UNDEFINED_FILE_TYPE = 0 - BIN = 65767 - UNDEFINED = 137851184 - X509 = 2674086 - - content = proto.Field(proto.STRING, number=414659705, optional=True,) - file_type = proto.Field(proto.ENUM, number=294346781, optional=True, enum=FileType,) - - -class Allowed(proto.Message): - r""" - Attributes: - I_p_protocol (str): - The IP protocol to which this rule applies. - The protocol type is required when creating a - firewall rule. This value can either be one of - the following well known protocol strings (tcp, - udp, icmp, esp, ah, ipip, sctp) or the IP - protocol number. - ports (Sequence[str]): - An optional list of ports to which this rule applies. This - field is only applicable for the UDP or TCP protocol. Each - entry must be either an integer or a range. If not - specified, this rule applies to connections through any - port. - - Example inputs include: ["22"], ["80","443"], and - ["12345-12349"]. - """ - - I_p_protocol = proto.Field(proto.STRING, number=488094525, optional=True,) - ports = proto.RepeatedField(proto.STRING, number=106854418,) - - -class Denied(proto.Message): - r""" - Attributes: - I_p_protocol (str): - The IP protocol to which this rule applies. - The protocol type is required when creating a - firewall rule. This value can either be one of - the following well known protocol strings (tcp, - udp, icmp, esp, ah, ipip, sctp) or the IP - protocol number. - ports (Sequence[str]): - An optional list of ports to which this rule applies. This - field is only applicable for the UDP or TCP protocol. Each - entry must be either an integer or a range. If not - specified, this rule applies to connections through any - port. - - Example inputs include: ["22"], ["80","443"], and - ["12345-12349"]. - """ - - I_p_protocol = proto.Field(proto.STRING, number=488094525, optional=True,) - ports = proto.RepeatedField(proto.STRING, number=106854418,) - - -class FirewallLogConfig(proto.Message): - r"""The available logging options for a firewall rule. - Attributes: - enable (bool): - This field denotes whether to enable logging - for a particular firewall rule. - metadata (google.cloud.compute_v1.types.FirewallLogConfig.Metadata): - This field can only be specified for a - particular firewall rule if logging is enabled - for that rule. This field denotes whether to - include or exclude metadata for firewall logs. - """ - - class Metadata(proto.Enum): - r"""This field can only be specified for a particular firewall - rule if logging is enabled for that rule. This field denotes - whether to include or exclude metadata for firewall logs. - """ - UNDEFINED_METADATA = 0 - EXCLUDE_ALL_METADATA = 334519954 - INCLUDE_ALL_METADATA = 164619908 - - enable = proto.Field(proto.BOOL, number=311764355, optional=True,) - metadata = proto.Field(proto.ENUM, number=86866735, optional=True, enum=Metadata,) - - -class Firewall(proto.Message): - r"""Represents a Firewall Rule resource. - Firewall rules allow or deny ingress traffic to, and egress - traffic from your instances. For more information, read Firewall - rules. - - Attributes: - allowed (Sequence[google.cloud.compute_v1.types.Allowed]): - The list of ALLOW rules specified by this - firewall. Each rule specifies a protocol and - port-range tuple that describes a permitted - connection. - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - denied (Sequence[google.cloud.compute_v1.types.Denied]): - The list of DENY rules specified by this - firewall. Each rule specifies a protocol and - port-range tuple that describes a denied - connection. - description (str): - An optional description of this resource. - Provide this field when you create the resource. - destination_ranges (Sequence[str]): - If destination ranges are specified, the - firewall rule applies only to traffic that has - destination IP address in these ranges. These - ranges must be expressed in CIDR format. Only - IPv4 is supported. - direction (google.cloud.compute_v1.types.Firewall.Direction): - Direction of traffic to which this firewall applies, either - ``INGRESS`` or ``EGRESS``. The default is ``INGRESS``. For - ``INGRESS`` traffic, you cannot specify the - destinationRanges field, and for ``EGRESS`` traffic, you - cannot specify the sourceRanges or sourceTags fields. - disabled (bool): - Denotes whether the firewall rule is - disabled. When set to true, the firewall rule is - not enforced and the network behaves as if it - did not exist. If this is unspecified, the - firewall rule will be enabled. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - kind (str): - [Output Only] Type of the resource. Always compute#firewall - for firewall rules. - log_config (google.cloud.compute_v1.types.FirewallLogConfig): - This field denotes the logging options for a - particular firewall rule. If logging is enabled, - logs will be exported to Cloud Logging. - name (str): - Name of the resource; provided by the client when the - resource is created. The name must be 1-63 characters long, - and comply with RFC1035. Specifically, the name must be 1-63 - characters long and match the regular expression - \`\ `a-z <[-a-z0-9]*[a-z0-9]>`__?. The first character must - be a lowercase letter, and all following characters (except - for the last character) must be a dash, lowercase letter, or - digit. The last character must be a lowercase letter or - digit. - network (str): - URL of the network resource for this firewall - rule. If not specified when creating a firewall - rule, the default network is used: - global/networks/default If you choose to specify - this field, you can specify the network as a - full or partial URL. For example, the following - are all valid URLs: - - https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my- - network - projects/myproject/global/networks/my- - network - global/networks/default - priority (int): - Priority for this rule. This is an integer between ``0`` and - ``65535``, both inclusive. The default value is ``1000``. - Relative priorities determine which rule takes effect if - multiple rules apply. Lower values indicate higher priority. - For example, a rule with priority ``0`` has higher - precedence than a rule with priority ``1``. DENY rules take - precedence over ALLOW rules if they have equal priority. - Note that VPC networks have implied rules with a priority of - ``65535``. To avoid conflicts with the implied rules, use a - priority number less than ``65535``. - self_link (str): - [Output Only] Server-defined URL for the resource. - source_ranges (Sequence[str]): - If source ranges are specified, the firewall - rule applies only to traffic that has a source - IP address in these ranges. These ranges must be - expressed in CIDR format. One or both of - sourceRanges and sourceTags may be set. If both - fields are set, the rule applies to traffic that - has a source IP address within sourceRanges OR a - source IP from a resource with a matching tag - listed in the sourceTags field. The connection - does not need to match both fields for the rule - to apply. Only IPv4 is supported. - source_service_accounts (Sequence[str]): - If source service accounts are specified, the - firewall rules apply only to traffic originating - from an instance with a service account in this - list. Source service accounts cannot be used to - control traffic to an instance's external IP - address because service accounts are associated - with an instance, not an IP address. - sourceRanges can be set at the same time as - sourceServiceAccounts. If both are set, the - firewall applies to traffic that has a source IP - address within the sourceRanges OR a source IP - that belongs to an instance with service account - listed in sourceServiceAccount. The connection - does not need to match both fields for the - firewall to apply. sourceServiceAccounts cannot - be used at the same time as sourceTags or - targetTags. - source_tags (Sequence[str]): - If source tags are specified, the firewall - rule applies only to traffic with source IPs - that match the primary network interfaces of VM - instances that have the tag and are in the same - VPC network. Source tags cannot be used to - control traffic to an instance's external IP - address, it only applies to traffic between - instances in the same virtual network. Because - tags are associated with instances, not IP - addresses. One or both of sourceRanges and - sourceTags may be set. If both fields are set, - the firewall applies to traffic that has a - source IP address within sourceRanges OR a - source IP from a resource with a matching tag - listed in the sourceTags field. The connection - does not need to match both fields for the - firewall to apply. - target_service_accounts (Sequence[str]): - A list of service accounts indicating sets of instances - located in the network that may make network connections as - specified in allowed[]. targetServiceAccounts cannot be used - at the same time as targetTags or sourceTags. If neither - targetServiceAccounts nor targetTags are specified, the - firewall rule applies to all instances on the specified - network. - target_tags (Sequence[str]): - A list of tags that controls which instances - the firewall rule applies to. If targetTags are - specified, then the firewall rule applies only - to instances in the VPC network that have one of - those tags. If no targetTags are specified, the - firewall rule applies to all instances on the - specified network. + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - class Direction(proto.Enum): - r"""Direction of traffic to which this firewall applies, either - ``INGRESS`` or ``EGRESS``. The default is ``INGRESS``. For - ``INGRESS`` traffic, you cannot specify the destinationRanges field, - and for ``EGRESS`` traffic, you cannot specify the sourceRanges or - sourceTags fields. - """ - UNDEFINED_DIRECTION = 0 - EGRESS = 432880501 - INGRESS = 516931221 + @property + def raw_page(self): + return self - allowed = proto.RepeatedField(proto.MESSAGE, number=162398632, message="Allowed",) - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - denied = proto.RepeatedField(proto.MESSAGE, number=275217307, message="Denied",) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - destination_ranges = proto.RepeatedField(proto.STRING, number=305699879,) - direction = proto.Field( - proto.ENUM, number=111150975, optional=True, enum=Direction, + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.MapField( + proto.STRING, proto.MESSAGE, number=100526016, message="CommitmentsScopedList", ) - disabled = proto.Field(proto.BOOL, number=270940796, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) kind = proto.Field(proto.STRING, number=3292052, optional=True,) - log_config = proto.Field( - proto.MESSAGE, number=351299741, optional=True, message="FirewallLogConfig", - ) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - network = proto.Field(proto.STRING, number=232872494, optional=True,) - priority = proto.Field(proto.INT32, number=445151652, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - source_ranges = proto.RepeatedField(proto.STRING, number=200097658,) - source_service_accounts = proto.RepeatedField(proto.STRING, number=105100756,) - source_tags = proto.RepeatedField(proto.STRING, number=452222397,) - target_service_accounts = proto.RepeatedField(proto.STRING, number=457639710,) - target_tags = proto.RepeatedField(proto.STRING, number=62901767,) + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class FirewallList(proto.Message): - r"""Contains a list of firewalls. +class CommitmentList(proto.Message): + r"""Contains a list of Commitment resources. Attributes: id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.Firewall]): - A list of Firewall resources. + items (Sequence[google.cloud.compute_v1.types.Commitment]): + A list of Commitment resources. kind (str): - [Output Only] Type of resource. Always compute#firewallList - for lists of firewalls. + [Output Only] Type of resource. Always + compute#commitmentList for lists of commitments. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -7201,7 +8325,7 @@ def raw_page(self): return self id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Firewall",) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Commitment",) kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) @@ -7210,3946 +8334,3559 @@ def raw_page(self): ) -class FirewallPolicyAssociation(proto.Message): +class CommitmentsScopedList(proto.Message): r""" Attributes: - attachment_target (str): - The target that the firewall policy is - attached to. - display_name (str): - [Output Only] Deprecated, please use short name instead. The - display name of the firewall policy of the association. - firewall_policy_id (str): - [Output Only] The firewall policy ID of the association. - name (str): - The name for an association. - short_name (str): - [Output Only] The short name of the firewall policy of the - association. + commitments (Sequence[google.cloud.compute_v1.types.Commitment]): + [Output Only] A list of commitments contained in this scope. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning which replaces the list + of commitments when the list is empty. """ - attachment_target = proto.Field(proto.STRING, number=175773741, optional=True,) - display_name = proto.Field(proto.STRING, number=4473832, optional=True,) - firewall_policy_id = proto.Field(proto.STRING, number=357211849, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - short_name = proto.Field(proto.STRING, number=492051566, optional=True,) + commitments = proto.RepeatedField( + proto.MESSAGE, number=450664446, message="Commitment", + ) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class FirewallPoliciesListAssociationsResponse(proto.Message): - r""" +class Condition(proto.Message): + r"""This is deprecated and has no effect. Do not use. Attributes: - associations (Sequence[google.cloud.compute_v1.types.FirewallPolicyAssociation]): - A list of associations. - kind (str): - [Output Only] Type of firewallPolicy associations. Always - compute#FirewallPoliciesListAssociations for lists of - firewallPolicy associations. + iam (str): + This is deprecated and has no effect. Do not + use. + op (str): + This is deprecated and has no effect. Do not + use. + svc (str): + This is deprecated and has no effect. Do not + use. + sys (str): + This is deprecated and has no effect. Do not + use. + values (Sequence[str]): + This is deprecated and has no effect. Do not + use. """ - associations = proto.RepeatedField( - proto.MESSAGE, number=508736530, message="FirewallPolicyAssociation", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) + iam = proto.Field(proto.STRING, number=104021, optional=True,) + op = proto.Field(proto.STRING, number=3553, optional=True,) + svc = proto.Field(proto.STRING, number=114272, optional=True,) + sys = proto.Field(proto.STRING, number=114381, optional=True,) + values = proto.RepeatedField(proto.STRING, number=249928994,) -class FirewallPolicyRule(proto.Message): - r"""Represents a rule that describes one or more match conditions - along with the action to be taken when traffic matches this - condition (allow or deny). +class ConfidentialInstanceConfig(proto.Message): + r"""A set of Confidential Instance options. + Attributes: + enable_confidential_compute (bool): + Defines whether the instance should have + confidential compute enabled. + """ + + enable_confidential_compute = proto.Field( + proto.BOOL, number=102135228, optional=True, + ) + +class ConnectionDraining(proto.Message): + r"""Message containing connection draining configuration. Attributes: - action (str): - The Action to perform when the client - connection triggers the rule. Can currently be - either "allow" or "deny()" where valid values - for status are 403, 404, and 502. - description (str): - An optional description for this resource. - direction (google.cloud.compute_v1.types.FirewallPolicyRule.Direction): - The direction in which this rule applies. - disabled (bool): - Denotes whether the firewall policy rule is - disabled. When set to true, the firewall policy - rule is not enforced and traffic behaves as if - it did not exist. If this is unspecified, the - firewall policy rule will be enabled. - enable_logging (bool): - Denotes whether to enable logging for a particular rule. If - logging is enabled, logs will be exported to the configured - export destination in Stackdriver. Logs may be exported to - BigQuery or Pub/Sub. Note: you cannot enable logging on - "goto_next" rules. - kind (str): - [Output only] Type of the resource. Always - compute#firewallPolicyRule for firewall policy rules - match (google.cloud.compute_v1.types.FirewallPolicyRuleMatcher): - A match condition that incoming traffic is - evaluated against. If it evaluates to true, the - corresponding 'action' is enforced. - priority (int): - An integer indicating the priority of a rule - in the list. The priority must be a positive - value between 0 and 2147483647. Rules are - evaluated from highest to lowest priority where - 0 is the highest priority and 2147483647 is the - lowest prority. - rule_tuple_count (int): - [Output Only] Calculation of the complexity of a single - firewall policy rule. - target_resources (Sequence[str]): - A list of network resource URLs to which this - rule applies. This field allows you to control - which network's VMs get this rule. If this field - is left blank, all VMs within the organization - will receive the rule. - target_service_accounts (Sequence[str]): - A list of service accounts indicating the - sets of instances that are applied with this - rule. + draining_timeout_sec (int): + Configures a duration timeout for existing + requests on a removed backend instance. For + supported load balancers and protocols, as + described in Enabling connection draining. """ - class Direction(proto.Enum): - r"""The direction in which this rule applies.""" - UNDEFINED_DIRECTION = 0 - EGRESS = 432880501 - INGRESS = 516931221 + draining_timeout_sec = proto.Field(proto.INT32, number=225127070, optional=True,) - action = proto.Field(proto.STRING, number=187661878, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - direction = proto.Field( - proto.ENUM, number=111150975, optional=True, enum=Direction, - ) - disabled = proto.Field(proto.BOOL, number=270940796, optional=True,) - enable_logging = proto.Field(proto.BOOL, number=295396515, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - match = proto.Field( + +class ConsistentHashLoadBalancerSettings(proto.Message): + r"""This message defines settings for a consistent hash style + load balancer. + + Attributes: + http_cookie (google.cloud.compute_v1.types.ConsistentHashLoadBalancerSettingsHttpCookie): + Hash is based on HTTP Cookie. This field describes a HTTP + cookie that will be used as the hash key for the consistent + hash load balancer. If the cookie is not present, it will be + generated. This field is applicable if the sessionAffinity + is set to HTTP_COOKIE. + http_header_name (str): + The hash based on the value of the specified header field. + This field is applicable if the sessionAffinity is set to + HEADER_FIELD. + minimum_ring_size (int): + The minimum number of virtual nodes to use + for the hash ring. Defaults to 1024. Larger ring + sizes result in more granular load + distributions. If the number of hosts in the + load balancing pool is larger than the ring + size, each host will be assigned a single + virtual node. + """ + + http_cookie = proto.Field( proto.MESSAGE, - number=103668165, + number=6673915, optional=True, - message="FirewallPolicyRuleMatcher", + message="ConsistentHashLoadBalancerSettingsHttpCookie", ) - priority = proto.Field(proto.INT32, number=445151652, optional=True,) - rule_tuple_count = proto.Field(proto.INT32, number=388342037, optional=True,) - target_resources = proto.RepeatedField(proto.STRING, number=528230647,) - target_service_accounts = proto.RepeatedField(proto.STRING, number=457639710,) + http_header_name = proto.Field(proto.STRING, number=234798022, optional=True,) + minimum_ring_size = proto.Field(proto.INT64, number=234380735, optional=True,) -class FirewallPolicy(proto.Message): - r"""Represents a Firewall Policy resource. (== resource_for - {$api_version}.firewallPolicies ==) +class ConsistentHashLoadBalancerSettingsHttpCookie(proto.Message): + r"""The information about the HTTP Cookie on which the hash + function is based for load balancing policies that use a + consistent hash. Attributes: - associations (Sequence[google.cloud.compute_v1.types.FirewallPolicyAssociation]): - A list of associations that belong to this - firewall policy. - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - description (str): - An optional description of this resource. - Provide this property when you create the - resource. - display_name (str): - Depreacted, please use short name instead. User-provided - name of the Organization firewall plicy. The name should be - unique in the organization in which the firewall policy is - created. The name must be 1-63 characters long, and comply - with RFC1035. Specifically, the name must be 1-63 characters - long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. - fingerprint (str): - Specifies a fingerprint for this resource, - which is essentially a hash of the metadata's - contents and used for optimistic locking. The - fingerprint is initially generated by Compute - Engine and changes after every request to modify - or update metadata. You must always provide an - up-to-date fingerprint hash in order to update - or change metadata, otherwise the request will - fail with error 412 conditionNotMet. To see the - latest fingerprint, make get() request to the - firewall policy. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - kind (str): - [Output only] Type of the resource. Always - compute#firewallPolicyfor firewall policies name (str): - [Output Only] Name of the resource. It is a numeric ID - allocated by GCP which uniquely identifies the Firewall - Policy. - parent (str): - [Output Only] The parent of the firewall policy. - rule_tuple_count (int): - [Output Only] Total count of all firewall policy rule - tuples. A firewall policy can not exceed a set number of - tuples. - rules (Sequence[google.cloud.compute_v1.types.FirewallPolicyRule]): - A list of rules that belong to this policy. There must - always be a default rule (rule with priority 2147483647 and - match "*"). If no rules are provided when creating a - firewall policy, a default rule with action "allow" will be - added. - self_link (str): - [Output Only] Server-defined URL for the resource. - self_link_with_id (str): - [Output Only] Server-defined URL for this resource with the - resource id. - short_name (str): - User-provided name of the Organization firewall plicy. The - name should be unique in the organization in which the - firewall policy is created. The name must be 1-63 characters - long, and comply with RFC1035. Specifically, the name must - be 1-63 characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. + Name of the cookie. + path (str): + Path to set for the cookie. + ttl (google.cloud.compute_v1.types.Duration): + Lifetime of the cookie. """ - associations = proto.RepeatedField( - proto.MESSAGE, number=508736530, message="FirewallPolicyAssociation", - ) - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - display_name = proto.Field(proto.STRING, number=4473832, optional=True,) - fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) name = proto.Field(proto.STRING, number=3373707, optional=True,) - parent = proto.Field(proto.STRING, number=78317738, optional=True,) - rule_tuple_count = proto.Field(proto.INT32, number=388342037, optional=True,) - rules = proto.RepeatedField( - proto.MESSAGE, number=108873975, message="FirewallPolicyRule", + path = proto.Field(proto.STRING, number=3433509, optional=True,) + ttl = proto.Field(proto.MESSAGE, number=115180, optional=True, message="Duration",) + + +class CorsPolicy(proto.Message): + r"""The specification for allowing client side cross-origin + requests. Please see W3C Recommendation for Cross Origin + Resource Sharing + + Attributes: + allow_credentials (bool): + In response to a preflight request, setting + this to true indicates that the actual request + can include user credentials. This translates to + the Access-Control-Allow-Credentials header. + Default is false. + allow_headers (Sequence[str]): + Specifies the content for the Access-Control- + llow-Headers header. + allow_methods (Sequence[str]): + Specifies the content for the Access-Control- + llow-Methods header. + allow_origin_regexes (Sequence[str]): + Specifies the regualar expression patterns + that match allowed origins. For regular + expression grammar please see + github.com/google/re2/wiki/Syntax An origin is + allowed if it matches either an item in + allowOrigins or an item in allowOriginRegexes. + allow_origins (Sequence[str]): + Specifies the list of origins that will be + allowed to do CORS requests. An origin is + allowed if it matches either an item in + allowOrigins or an item in allowOriginRegexes. + disabled (bool): + If true, specifies the CORS policy is + disabled. The default value of false, which + indicates that the CORS policy is in effect. + expose_headers (Sequence[str]): + Specifies the content for the Access-Control- + xpose-Headers header. + max_age (int): + Specifies how long results of a preflight + request can be cached in seconds. This + translates to the Access-Control-Max-Age header. + """ + + allow_credentials = proto.Field(proto.BOOL, number=481263366, optional=True,) + allow_headers = proto.RepeatedField(proto.STRING, number=45179024,) + allow_methods = proto.RepeatedField(proto.STRING, number=205405372,) + allow_origin_regexes = proto.RepeatedField(proto.STRING, number=215385810,) + allow_origins = proto.RepeatedField(proto.STRING, number=194914071,) + disabled = proto.Field(proto.BOOL, number=270940796, optional=True,) + expose_headers = proto.RepeatedField(proto.STRING, number=247604747,) + max_age = proto.Field(proto.INT32, number=307559332, optional=True,) + + +class CreateInstancesInstanceGroupManagerRequest(proto.Message): + r"""A request message for InstanceGroupManagers.CreateInstances. + See the method description for details. + + Attributes: + instance_group_manager (str): + The name of the managed instance group. It + should conform to RFC1035. + instance_group_managers_create_instances_request_resource (google.cloud.compute_v1.types.InstanceGroupManagersCreateInstancesRequest): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. The request ID must be a valid UUID + with the exception that zero UUID is not + supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone where the managed + instance group is located. It should conform to + RFC1035. + """ + + instance_group_manager = proto.Field(proto.STRING, number=249363395,) + instance_group_managers_create_instances_request_resource = proto.Field( + proto.MESSAGE, + number=24558867, + message="InstanceGroupManagersCreateInstancesRequest", ) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - self_link_with_id = proto.Field(proto.STRING, number=44520962, optional=True,) - short_name = proto.Field(proto.STRING, number=492051566, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class FirewallPolicyList(proto.Message): - r""" +class CreateInstancesRegionInstanceGroupManagerRequest(proto.Message): + r"""A request message for + RegionInstanceGroupManagers.CreateInstances. See the method + description for details. + Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.FirewallPolicy]): - A list of FirewallPolicy resources. - kind (str): - [Output Only] Type of resource. Always - compute#firewallPolicyList for listsof FirewallPolicies - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + instance_group_manager (str): + The name of the managed instance group. It + should conform to RFC1035. + project (str): + Project ID for this request. + region (str): + The name of the region where the managed + instance group is located. It should conform to + RFC1035. + region_instance_group_managers_create_instances_request_resource (google.cloud.compute_v1.types.RegionInstanceGroupManagersCreateInstancesRequest): + The body resource for this request + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. The request ID must be a valid UUID + with the exception that zero UUID is not + supported ( + 00000000-0000-0000-0000-000000000000). """ - @property - def raw_page(self): - return self + instance_group_manager = proto.Field(proto.STRING, number=249363395,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + region_instance_group_managers_create_instances_request_resource = proto.Field( + proto.MESSAGE, + number=359014280, + message="RegionInstanceGroupManagersCreateInstancesRequest", + ) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + + +class CreateSnapshotDiskRequest(proto.Message): + r"""A request message for Disks.CreateSnapshot. See the method + description for details. + + Attributes: + disk (str): + Name of the persistent disk to snapshot. + guest_flush (bool): + [Input Only] Whether to attempt an application consistent + snapshot by informing the OS to prepare for the snapshot + process. Currently only supported on Windows instances using + the Volume Shadow Copy Service (VSS). + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + snapshot_resource (google.cloud.compute_v1.types.Snapshot): + The body resource for this request + zone (str): + The name of the zone for this request. + """ - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="FirewallPolicy", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + disk = proto.Field(proto.STRING, number=3083677,) + guest_flush = proto.Field(proto.BOOL, number=385550813, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + snapshot_resource = proto.Field( + proto.MESSAGE, number=481319977, message="Snapshot", ) + zone = proto.Field(proto.STRING, number=3744684,) -class FirewallPolicyRuleMatcher(proto.Message): - r"""Represents a match condition that incoming traffic is - evaluated against. Exactly one field must be specified. +class CreateSnapshotRegionDiskRequest(proto.Message): + r"""A request message for RegionDisks.CreateSnapshot. See the + method description for details. Attributes: - dest_ip_ranges (Sequence[str]): - CIDR IP address range. Maximum number of - destination CIDR IP ranges allowed is 256. - layer4_configs (Sequence[google.cloud.compute_v1.types.FirewallPolicyRuleMatcherLayer4Config]): - Pairs of IP protocols and ports that the rule - should match. - src_ip_ranges (Sequence[str]): - CIDR IP address range. Maximum number of - source CIDR IP ranges allowed is 256. + disk (str): + Name of the regional persistent disk to + snapshot. + project (str): + Project ID for this request. + region (str): + Name of the region for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + snapshot_resource (google.cloud.compute_v1.types.Snapshot): + The body resource for this request """ - dest_ip_ranges = proto.RepeatedField(proto.STRING, number=337357713,) - layer4_configs = proto.RepeatedField( - proto.MESSAGE, - number=373534261, - message="FirewallPolicyRuleMatcherLayer4Config", + disk = proto.Field(proto.STRING, number=3083677,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + snapshot_resource = proto.Field( + proto.MESSAGE, number=481319977, message="Snapshot", ) - src_ip_ranges = proto.RepeatedField(proto.STRING, number=432128083,) -class FirewallPolicyRuleMatcherLayer4Config(proto.Message): +class CustomerEncryptionKey(proto.Message): r""" Attributes: - ip_protocol (str): - The IP protocol to which this rule applies. - The protocol type is required when creating a - firewall rule. This value can either be one of - the following well known protocol strings (tcp, - udp, icmp, esp, ah, ipip, sctp), or the IP - protocol number. - ports (Sequence[str]): - An optional list of ports to which this rule applies. This - field is only applicable for UDP or TCP protocol. Each entry - must be either an integer or a range. If not specified, this - rule applies to connections through any port. - - Example inputs include: ["22"], ["80","443"], and - ["12345-12349"]. + kms_key_name (str): + The name of the encryption key that is stored in Google + Cloud KMS. For example: "kmsKeyName": + "projects/kms_project_id/locations/region/keyRings/ + key_region/cryptoKeys/key + kms_key_service_account (str): + The service account being used for the encryption request + for the given KMS key. If absent, the Compute Engine default + service account is used. For example: + "kmsKeyServiceAccount": + "name@project_id.iam.gserviceaccount.com/ + raw_key (str): + Specifies a 256-bit customer-supplied + encryption key, encoded in RFC 4648 base64 to + either encrypt or decrypt this resource. You can + provide either the rawKey or the + rsaEncryptedKey. For example: "rawKey": + "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=". + rsa_encrypted_key (str): + Specifies an RFC 4648 base64 encoded, RSA- + rapped 2048-bit customer-supplied encryption key + to either encrypt or decrypt this resource. You + can provide either the rawKey or the + rsaEncryptedKey. For example: "rsaEncryptedKey": + "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH + z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD + D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==" + The key must meet the following requirements + before you can provide it to Compute Engine: 1. + The key is wrapped using a RSA public key + certificate provided by Google. 2. After being + wrapped, the key must be encoded in RFC 4648 + base64 encoding. Gets the RSA public key + certificate provided by Google at: + https://cloud- + certs.storage.googleapis.com/google-cloud-csek- + ingress.pem + sha256 (str): + [Output only] The RFC 4648 base64 encoded SHA-256 hash of + the customer-supplied encryption key that protects this + resource. """ - ip_protocol = proto.Field(proto.STRING, number=475958960, optional=True,) - ports = proto.RepeatedField(proto.STRING, number=106854418,) - + kms_key_name = proto.Field(proto.STRING, number=484373913, optional=True,) + kms_key_service_account = proto.Field( + proto.STRING, number=209986261, optional=True, + ) + raw_key = proto.Field(proto.STRING, number=449196488, optional=True,) + rsa_encrypted_key = proto.Field(proto.STRING, number=335487397, optional=True,) + sha256 = proto.Field(proto.STRING, number=170112551, optional=True,) -class MetadataFilter(proto.Message): - r"""Opaque filter criteria used by loadbalancers to restrict routing - configuration to a limited set of loadbalancing proxies. Proxies and - sidecars involved in loadbalancing would typically present metadata - to the loadbalancers which need to match criteria specified here. If - a match takes place, the relevant configuration is made available to - those proxies. For each metadataFilter in this list, if its - filterMatchCriteria is set to MATCH_ANY, at least one of the - filterLabels must match the corresponding label provided in the - metadata. If its filterMatchCriteria is set to MATCH_ALL, then all - of its filterLabels must match with corresponding labels provided in - the metadata. An example for using metadataFilters would be: if - loadbalancing involves Envoys, they will only receive routing - configuration when values in metadataFilters match values supplied - in `__ - \* - `Regional `__ + Attributes: + address (str): + Name of the address resource to delete. + project (str): + Project ID for this request. + region (str): + Name of the region for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + """ - A forwarding rule and its corresponding IP address represent the - frontend configuration of a Google Cloud Platform load balancer. - Forwarding rules can also reference target instances and Cloud VPN - Classic gateways (targetVpnGateway). + address = proto.Field(proto.STRING, number=462920692,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - For more information, read Forwarding rule concepts and Using - protocol forwarding. - (== resource_for {$api_version}.forwardingRules ==) (== resource_for - {$api_version}.globalForwardingRules ==) (== resource_for - {$api_version}.regionForwardingRules ==) +class DeleteAutoscalerRequest(proto.Message): + r"""A request message for Autoscalers.Delete. See the method + description for details. Attributes: - I_p_address (str): - IP address that this forwarding rule serves. When a client - sends traffic to this IP address, the forwarding rule - directs the traffic to the target that you specify in the - forwarding rule. + autoscaler (str): + Name of the autoscaler to delete. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + Name of the zone for this request. + """ - If you don't specify a reserved IP address, an ephemeral IP - address is assigned. Methods for specifying an IP address: + autoscaler = proto.Field(proto.STRING, number=517258967,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) - - IPv4 dotted decimal, as in ``100.1.2.3`` \* Full URL, as - in - https://www.googleapis.com/compute/v1/projects/project_id/regions/region/addresses/address-name - \* Partial URL or by name, as in: - - projects/project_id/regions/region/addresses/address-name - - regions/region/addresses/address-name - - global/addresses/address-name - - address-name +class DeleteBackendBucketRequest(proto.Message): + r"""A request message for BackendBuckets.Delete. See the method + description for details. - The loadBalancingScheme and the forwarding rule's target - determine the type of IP address that you can use. For - detailed information, refer to `IP address - specifications `__. + Attributes: + backend_bucket (str): + Name of the BackendBucket resource to delete. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + """ - Must be set to ``0.0.0.0`` when the target is - targetGrpcProxy that has validateForProxyless field set to - true. + backend_bucket = proto.Field(proto.STRING, number=91714037,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - For Private Service Connect forwarding rules that forward - traffic to Google APIs, IP address must be provided. - I_p_protocol (google.cloud.compute_v1.types.ForwardingRule.IPProtocol): - The IP protocol to which this rule applies. - For protocol forwarding, valid options are TCP, UDP, ESP, - AH, SCTP and ICMP. - - The valid IP protocols are different for different load - balancing products: - - - Internal TCP/UDP Load Balancing: The load balancing - scheme is INTERNAL, and one of TCP, UDP or ALL is valid. - - Traffic Director: The load balancing scheme is - INTERNAL_SELF_MANAGED, and only TCP is valid. - - Internal HTTP(S) Load Balancing: The load balancing - scheme is INTERNAL_MANAGED, and only TCP is valid. - - HTTP(S), SSL Proxy, and TCP Proxy Load Balancing: The - load balancing scheme is EXTERNAL and only TCP is valid. - - Network Load Balancing: The load balancing scheme is - EXTERNAL, and one of TCP or UDP is valid. - all_ports (bool): - This field is used along with the backend_service field for - internal load balancing or with the target field for - internal TargetInstance. This field cannot be used with port - or portRange fields. +class DeleteBackendServiceRequest(proto.Message): + r"""A request message for BackendServices.Delete. See the method + description for details. - When the load balancing scheme is INTERNAL and protocol is - TCP/UDP, specify this field to allow packets addressed to - any ports will be forwarded to the backends configured with - this forwarding rule. - allow_global_access (bool): - This field is used along with the backend_service field for - internal load balancing or with the target field for - internal TargetInstance. If the field is set to TRUE, - clients can access ILB from all regions. Otherwise only - allows access from clients in the same region as the - internal load balancer. + Attributes: backend_service (str): - Identifies the backend service to which the - forwarding rule sends traffic. Required for - Internal TCP/UDP Load Balancing and Network Load - Balancing; must be omitted for all other load - balancer types. - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - description (str): - An optional description of this resource. - Provide this property when you create the - resource. - fingerprint (str): - Fingerprint of this resource. A hash of the - contents stored in this object. This field is - used in optimistic locking. This field will be - ignored when inserting a ForwardingRule. Include - the fingerprint in patch request to ensure that - you do not overwrite changes that were applied - from another concurrent request. To see the - latest fingerprint, make a get() request to - retrieve a ForwardingRule. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - ip_version (google.cloud.compute_v1.types.ForwardingRule.IpVersion): - The IP Version that will be used by this - forwarding rule. Valid options are IPV4 or IPV6. - This can only be specified for an external - global forwarding rule. - is_mirroring_collector (bool): - Indicates whether or not this load balancer - can be used as a collector for packet mirroring. - To prevent mirroring loops, instances behind - this load balancer will not have their traffic - mirrored even if a PacketMirroring rule applies - to them. This can only be set to true for load - balancers that have their loadBalancingScheme - set to INTERNAL. - kind (str): - [Output Only] Type of the resource. Always - compute#forwardingRule for Forwarding Rule resources. - label_fingerprint (str): - A fingerprint for the labels being applied to - this resource, which is essentially a hash of - the labels set used for optimistic locking. The - fingerprint is initially generated by Compute - Engine and changes after every request to modify - or update labels. You must always provide an up- - to-date fingerprint hash in order to update or - change labels, otherwise the request will fail - with error 412 conditionNotMet. To see the - latest fingerprint, make a get() request to - retrieve a ForwardingRule. - labels (Sequence[google.cloud.compute_v1.types.ForwardingRule.LabelsEntry]): - Labels for this resource. These can only be - added or modified by the setLabels method. Each - label key/value pair must comply with RFC1035. - Label values may be empty. - load_balancing_scheme (google.cloud.compute_v1.types.ForwardingRule.LoadBalancingScheme): - Specifies the forwarding rule type. - - - EXTERNAL is used for: - - Classic Cloud VPN gateways - - Protocol forwarding to VMs from an external IP address - - HTTP(S), SSL Proxy, TCP Proxy, and Network Load Balancing - - INTERNAL is used for: - - Protocol forwarding to VMs from an internal IP address - - Internal TCP/UDP Load Balancing - - INTERNAL_MANAGED is used for: - - Internal HTTP(S) Load Balancing - - INTERNAL_SELF_MANAGED is used for: - - Traffic Director - - For more information about forwarding rules, refer to - Forwarding rule concepts. - metadata_filters (Sequence[google.cloud.compute_v1.types.MetadataFilter]): - Opaque filter criteria used by Loadbalancer to restrict - routing configuration to a limited set of xDS compliant - clients. In their xDS requests to Loadbalancer, xDS clients - present node metadata. When there is a match, the relevant - configuration is made available to those proxies. Otherwise, - all the resources (e.g. TargetHttpProxy, UrlMap) referenced - by the ForwardingRule will not be visible to those proxies. - For each metadataFilter in this list, if its - filterMatchCriteria is set to MATCH_ANY, at least one of the - filterLabels must match the corresponding label provided in - the metadata. If its filterMatchCriteria is set to - MATCH_ALL, then all of its filterLabels must match with - corresponding labels provided in the metadata. If multiple - metadataFilters are specified, all of them need to be - satisfied in order to be considered a match. metadataFilters - specified here will be applifed before those specified in - the UrlMap that this ForwardingRule references. - metadataFilters only applies to Loadbalancers that have - their loadBalancingScheme set to INTERNAL_SELF_MANAGED. - name (str): - Name of the resource; provided by the client when the - resource is created. The name must be 1-63 characters long, - and comply with RFC1035. Specifically, the name must be 1-63 - characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. - network (str): - This field is not used for external load - balancing. - For Internal TCP/UDP Load Balancing, this field - identifies the network that the load balanced IP - should belong to for this Forwarding Rule. If - this field is not specified, the default network - will be used. - For Private Service Connect forwarding rules - that forward traffic to Google APIs, a network - must be provided. - network_tier (google.cloud.compute_v1.types.ForwardingRule.NetworkTier): - This signifies the networking tier used for - configuring this load balancer and can only take - the following values: PREMIUM, STANDARD. For - regional ForwardingRule, the valid values are - PREMIUM and STANDARD. For GlobalForwardingRule, - the valid value is PREMIUM. - If this field is not specified, it is assumed to - be PREMIUM. If IPAddress is specified, this - value must be equal to the networkTier of the - Address. - port_range (str): - This field can be used only if: \* Load balancing scheme is - one of EXTERNAL, INTERNAL_SELF_MANAGED or INTERNAL_MANAGED, - and \* IPProtocol is one of TCP, UDP, or SCTP. - - Packets addressed to ports in the specified range will be - forwarded to target or backend_service. You can only use one - of ports, port_range, or allPorts. The three are mutually - exclusive. Forwarding rules with the same [IPAddress, - IPProtocol] pair must have disjoint port ranges. - - Some types of forwarding target have constraints on the - acceptable ports: - - - TargetHttpProxy: 80, 8080 - - TargetHttpsProxy: 443 - - TargetGrpcProxy: no constraints - - TargetTcpProxy: 25, 43, 110, 143, 195, 443, 465, 587, - 700, 993, 995, 1688, 1883, 5222 - - TargetSslProxy: 25, 43, 110, 143, 195, 443, 465, 587, - 700, 993, 995, 1688, 1883, 5222 - - TargetVpnGateway: 500, 4500 - ports (Sequence[str]): - The ports field is only supported when the forwarding rule - references a backend_service directly. Supported load - balancing products are Internal TCP/UDP Load Balancing and - Network Load Balancing. Only packets addressed to the - specified list of ports are forwarded to backends. + Name of the BackendService resource to + delete. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + """ - You can only use one of ports and port_range, or allPorts. - The three are mutually exclusive. + backend_service = proto.Field(proto.STRING, number=306946058,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - You can specify a list of up to five ports, which can be - non-contiguous. - For Internal TCP/UDP Load Balancing, if you specify - allPorts, you should not specify ports. +class DeleteDiskRequest(proto.Message): + r"""A request message for Disks.Delete. See the method + description for details. - For more information, see `Port - specifications `__. - psc_connection_id (int): - [Output Only] The PSC connection id of the PSC Forwarding - Rule. - region (str): - [Output Only] URL of the region where the regional - forwarding rule resides. This field is not applicable to - global forwarding rules. You must specify this field as part - of the HTTP request URL. It is not settable as a field in - the request body. - self_link (str): - [Output Only] Server-defined URL for the resource. - service_directory_registrations (Sequence[google.cloud.compute_v1.types.ForwardingRuleServiceDirectoryRegistration]): - Service Directory resources to register this - forwarding rule with. Currently, only supports a - single Service Directory resource. It is only - supported for Internal TCP/UDP Load Balancing - and Internal HTTP(S) Load Balancing. - service_label (str): - An optional prefix to the service name for this Forwarding - Rule. If specified, the prefix is the first label of the - fully qualified service name. + Attributes: + disk (str): + Name of the persistent disk to delete. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. + """ - The label must be 1-63 characters long, and comply with - RFC1035. Specifically, the label must be 1-63 characters - long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. + disk = proto.Field(proto.STRING, number=3083677,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) - This field is only used for internal load balancing. - service_name (str): - [Output Only] The internal fully qualified service name for - this Forwarding Rule. - This field is only used for internal load balancing. - subnetwork (str): - This field is only used for internal load - balancing. - For internal load balancing, this field - identifies the subnetwork that the load balanced - IP should belong to for this Forwarding Rule. - If the network specified is in auto subnet mode, - this field is optional. However, if the network - is in custom subnet mode, a subnetwork must be - specified. - target (str): +class DeleteExternalVpnGatewayRequest(proto.Message): + r"""A request message for ExternalVpnGateways.Delete. See the + method description for details. + Attributes: + external_vpn_gateway (str): + Name of the externalVpnGateways to delete. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - class IPProtocol(proto.Enum): - r"""The IP protocol to which this rule applies. - - For protocol forwarding, valid options are TCP, UDP, ESP, AH, SCTP - and ICMP. - - The valid IP protocols are different for different load balancing - products: - - - Internal TCP/UDP Load Balancing: The load balancing scheme is - INTERNAL, and one of TCP, UDP or ALL is valid. - - Traffic Director: The load balancing scheme is - INTERNAL_SELF_MANAGED, and only TCP is valid. - - Internal HTTP(S) Load Balancing: The load balancing scheme is - INTERNAL_MANAGED, and only TCP is valid. - - HTTP(S), SSL Proxy, and TCP Proxy Load Balancing: The load - balancing scheme is EXTERNAL and only TCP is valid. - - Network Load Balancing: The load balancing scheme is EXTERNAL, - and one of TCP or UDP is valid. - """ - UNDEFINED_I_P_PROTOCOL = 0 - AH = 2087 - ESP = 68962 - ICMP = 2241597 - SCTP = 2539724 - TCP = 82881 - UDP = 83873 + external_vpn_gateway = proto.Field(proto.STRING, number=109898629,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - class IpVersion(proto.Enum): - r"""The IP Version that will be used by this forwarding rule. - Valid options are IPV4 or IPV6. This can only be specified for - an external global forwarding rule. - """ - UNDEFINED_IP_VERSION = 0 - IPV4 = 2254341 - IPV6 = 2254343 - UNSPECIFIED_VERSION = 21850000 - class LoadBalancingScheme(proto.Enum): - r"""Specifies the forwarding rule type. - - - EXTERNAL is used for: - - Classic Cloud VPN gateways - - Protocol forwarding to VMs from an external IP address - - HTTP(S), SSL Proxy, TCP Proxy, and Network Load Balancing - - INTERNAL is used for: - - Protocol forwarding to VMs from an internal IP address - - Internal TCP/UDP Load Balancing - - INTERNAL_MANAGED is used for: - - Internal HTTP(S) Load Balancing - - INTERNAL_SELF_MANAGED is used for: - - Traffic Director - - For more information about forwarding rules, refer to Forwarding - rule concepts. - """ - UNDEFINED_LOAD_BALANCING_SCHEME = 0 - EXTERNAL = 35607499 - INTERNAL = 279295677 - INTERNAL_MANAGED = 37350397 - INTERNAL_SELF_MANAGED = 236211150 - INVALID = 530283991 +class DeleteFirewallPolicyRequest(proto.Message): + r"""A request message for FirewallPolicies.Delete. See the method + description for details. - class NetworkTier(proto.Enum): - r"""This signifies the networking tier used for configuring this - load balancer and can only take the following values: PREMIUM, - STANDARD. For regional ForwardingRule, the valid values are - PREMIUM and STANDARD. For GlobalForwardingRule, the valid value - is PREMIUM. - If this field is not specified, it is assumed to be PREMIUM. If - IPAddress is specified, this value must be equal to the - networkTier of the Address. - """ - UNDEFINED_NETWORK_TIER = 0 - PREMIUM = 399530551 - STANDARD = 484642493 + Attributes: + firewall_policy (str): + Name of the firewall policy to delete. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + """ - I_p_address = proto.Field(proto.STRING, number=42976943, optional=True,) - I_p_protocol = proto.Field( - proto.ENUM, number=488094525, optional=True, enum=IPProtocol, - ) - all_ports = proto.Field(proto.BOOL, number=445175796, optional=True,) - allow_global_access = proto.Field(proto.BOOL, number=499409674, optional=True,) - backend_service = proto.Field(proto.STRING, number=306946058, optional=True,) - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - ip_version = proto.Field( - proto.ENUM, number=294959552, optional=True, enum=IpVersion, - ) - is_mirroring_collector = proto.Field(proto.BOOL, number=119255164, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - label_fingerprint = proto.Field(proto.STRING, number=178124825, optional=True,) - labels = proto.MapField(proto.STRING, proto.STRING, number=500195327,) - load_balancing_scheme = proto.Field( - proto.ENUM, number=363890244, optional=True, enum=LoadBalancingScheme, - ) - metadata_filters = proto.RepeatedField( - proto.MESSAGE, number=464725739, message="MetadataFilter", - ) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - network = proto.Field(proto.STRING, number=232872494, optional=True,) - network_tier = proto.Field( - proto.ENUM, number=517397843, optional=True, enum=NetworkTier, - ) - port_range = proto.Field(proto.STRING, number=217518079, optional=True,) - ports = proto.RepeatedField(proto.STRING, number=106854418,) - psc_connection_id = proto.Field(proto.UINT64, number=292082397, optional=True,) - region = proto.Field(proto.STRING, number=138946292, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - service_directory_registrations = proto.RepeatedField( - proto.MESSAGE, - number=223549694, - message="ForwardingRuleServiceDirectoryRegistration", - ) - service_label = proto.Field(proto.STRING, number=417008874, optional=True,) - service_name = proto.Field(proto.STRING, number=359880149, optional=True,) - subnetwork = proto.Field(proto.STRING, number=307827694, optional=True,) - target = proto.Field(proto.STRING, number=192835985, optional=True,) + firewall_policy = proto.Field(proto.STRING, number=498173265,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class ForwardingRulesScopedList(proto.Message): - r""" +class DeleteFirewallRequest(proto.Message): + r"""A request message for Firewalls.Delete. See the method + description for details. + Attributes: - forwarding_rules (Sequence[google.cloud.compute_v1.types.ForwardingRule]): - A list of forwarding rules contained in this - scope. - warning (google.cloud.compute_v1.types.Warning): - Informational warning which replaces the list - of forwarding rules when the list is empty. + firewall (str): + Name of the firewall rule to delete. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - forwarding_rules = proto.RepeatedField( - proto.MESSAGE, number=315821365, message="ForwardingRule", - ) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) + firewall = proto.Field(proto.STRING, number=511016192,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class ForwardingRuleAggregatedList(proto.Message): - r""" +class DeleteForwardingRuleRequest(proto.Message): + r"""A request message for ForwardingRules.Delete. See the method + description for details. + Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.ForwardingRuleAggregatedList.ItemsEntry]): - A list of ForwardingRulesScopedList - resources. - kind (str): - [Output Only] Type of resource. Always - compute#forwardingRuleAggregatedList for lists of forwarding - rules. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - unreachables (Sequence[str]): - [Output Only] Unreachable resources. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + forwarding_rule (str): + Name of the ForwardingRule resource to + delete. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - @property - def raw_page(self): - return self + forwarding_rule = proto.Field(proto.STRING, number=269964030,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.MapField( - proto.STRING, - proto.MESSAGE, - number=100526016, - message="ForwardingRulesScopedList", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - unreachables = proto.RepeatedField(proto.STRING, number=243372063,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) +class DeleteGlobalAddressRequest(proto.Message): + r"""A request message for GlobalAddresses.Delete. See the method + description for details. -class ForwardingRuleList(proto.Message): - r"""Contains a list of ForwardingRule resources. Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.ForwardingRule]): - A list of ForwardingRule resources. - kind (str): - Type of resource. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + address (str): + Name of the address resource to delete. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - @property - def raw_page(self): - return self + address = proto.Field(proto.STRING, number=462920692,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="ForwardingRule", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) +class DeleteGlobalForwardingRuleRequest(proto.Message): + r"""A request message for GlobalForwardingRules.Delete. See the + method description for details. -class ForwardingRuleReference(proto.Message): - r""" Attributes: forwarding_rule (str): - + Name of the ForwardingRule resource to + delete. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - forwarding_rule = proto.Field(proto.STRING, number=269964030, optional=True,) + forwarding_rule = proto.Field(proto.STRING, number=269964030,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class GRPCHealthCheck(proto.Message): - r""" +class DeleteGlobalNetworkEndpointGroupRequest(proto.Message): + r"""A request message for GlobalNetworkEndpointGroups.Delete. See + the method description for details. + Attributes: - grpc_service_name (str): - The gRPC service name for the health check. This field is - optional. The value of grpc_service_name has the following - meanings by convention: + network_endpoint_group (str): + The name of the network endpoint group to + delete. It should comply with RFC1035. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + """ - - Empty service_name means the overall status of all - services at the backend. - - Non-empty service_name means the health of that gRPC - service, as defined by the owner of the service. The - grpc_service_name can only be ASCII. - port (int): - The port number for the health check request. Must be - specified if port_name and port_specification are not set or - if port_specification is USE_FIXED_PORT. Valid values are 1 - through 65535. - port_name (str): - Port name as defined in InstanceGroup#NamedPort#name. If - both port and port_name are defined, port takes precedence. - The port_name should conform to RFC1035. - port_specification (google.cloud.compute_v1.types.GRPCHealthCheck.PortSpecification): - Specifies how port is selected for health checking, can be - one of following values: USE_FIXED_PORT: The port number in - port is used for health checking. USE_NAMED_PORT: The - portName is used for health checking. USE_SERVING_PORT: For - NetworkEndpointGroup, the port specified for each network - endpoint is used for health checking. For other backends, - the port or named port specified in the Backend Service is - used for health checking. + network_endpoint_group = proto.Field(proto.STRING, number=433907078,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + + +class DeleteGlobalOperationRequest(proto.Message): + r"""A request message for GlobalOperations.Delete. See the method + description for details. - If not specified, gRPC health check follows behavior - specified in port and portName fields. + Attributes: + operation (str): + Name of the Operations resource to delete. + project (str): + Project ID for this request. """ - class PortSpecification(proto.Enum): - r"""Specifies how port is selected for health checking, can be one of - following values: USE_FIXED_PORT: The port number in port is used - for health checking. USE_NAMED_PORT: The portName is used for health - checking. USE_SERVING_PORT: For NetworkEndpointGroup, the port - specified for each network endpoint is used for health checking. For - other backends, the port or named port specified in the Backend - Service is used for health checking. + operation = proto.Field(proto.STRING, number=52090215,) + project = proto.Field(proto.STRING, number=227560217,) + - If not specified, gRPC health check follows behavior specified in - port and portName fields. +class DeleteGlobalOperationResponse(proto.Message): + r"""A response message for GlobalOperations.Delete. See the + method description for details. """ - UNDEFINED_PORT_SPECIFICATION = 0 - USE_FIXED_PORT = 190235748 - USE_NAMED_PORT = 349300671 - USE_SERVING_PORT = 362637516 - grpc_service_name = proto.Field(proto.STRING, number=136533078, optional=True,) - port = proto.Field(proto.INT32, number=3446913, optional=True,) - port_name = proto.Field(proto.STRING, number=41534345, optional=True,) - port_specification = proto.Field( - proto.ENUM, number=51590597, optional=True, enum=PortSpecification, - ) +class DeleteGlobalOrganizationOperationRequest(proto.Message): + r"""A request message for GlobalOrganizationOperations.Delete. + See the method description for details. -class NetworkEndpoint(proto.Message): - r"""The network endpoint. Attributes: - annotations (Sequence[google.cloud.compute_v1.types.NetworkEndpoint.AnnotationsEntry]): - Metadata defined as annotations on the - network endpoint. - fqdn (str): - Optional fully qualified domain name of network endpoint. - This can only be specified when - NetworkEndpointGroup.network_endpoint_type is - NON_GCP_FQDN_PORT. - instance (str): - The name for a specific VM instance that the IP address - belongs to. This is required for network endpoints of type - GCE_VM_IP_PORT. The instance must be in the same zone of - network endpoint group. - - The name must be 1-63 characters long, and comply with - RFC1035. - ip_address (str): - Optional IPv4 address of network endpoint. - The IP address must belong to a VM in Compute - Engine (either the primary IP or as part of an - aliased IP range). If the IP address is not - specified, then the primary IP address for the - VM instance in the network that the network - endpoint group belongs to will be used. - port (int): - Optional port number of network endpoint. If - not specified, the defaultPort for the network - endpoint group will be used. + operation (str): + Name of the Operations resource to delete. + parent_id (str): + Parent ID for this request. """ - annotations = proto.MapField(proto.STRING, proto.STRING, number=112032548,) - fqdn = proto.Field(proto.STRING, number=3150485, optional=True,) - instance = proto.Field(proto.STRING, number=18257045, optional=True,) - ip_address = proto.Field(proto.STRING, number=406272220, optional=True,) - port = proto.Field(proto.INT32, number=3446913, optional=True,) + operation = proto.Field(proto.STRING, number=52090215,) + parent_id = proto.Field(proto.STRING, number=459714768, optional=True,) -class GlobalNetworkEndpointGroupsAttachEndpointsRequest(proto.Message): - r""" - Attributes: - network_endpoints (Sequence[google.cloud.compute_v1.types.NetworkEndpoint]): - The list of network endpoints to be attached. - """ +class DeleteGlobalOrganizationOperationResponse(proto.Message): + r"""A response message for GlobalOrganizationOperations.Delete. + See the method description for details. + """ - network_endpoints = proto.RepeatedField( - proto.MESSAGE, number=149850285, message="NetworkEndpoint", - ) +class DeleteGlobalPublicDelegatedPrefixeRequest(proto.Message): + r"""A request message for GlobalPublicDelegatedPrefixes.Delete. + See the method description for details. -class GlobalNetworkEndpointGroupsDetachEndpointsRequest(proto.Message): - r""" Attributes: - network_endpoints (Sequence[google.cloud.compute_v1.types.NetworkEndpoint]): - The list of network endpoints to be detached. + project (str): + Project ID for this request. + public_delegated_prefix (str): + Name of the PublicDelegatedPrefix resource to + delete. + request_id (str): + An optional request ID to identify requests. Specify a + unique request ID so that if you must retry your request, + the server will know to ignore the request if it has already + been completed. For example, consider a situation where you + make an initial request and the request times out. If you + make the request again with the same request ID, the server + can check if original operation with the same request ID was + received, and if so, will ignore the second request. This + prevents clients from accidentally creating duplicate + commitments. The request ID must be a valid UUID with the + exception that zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). end_interface: + MixerMutationRequestBuilder """ - network_endpoints = proto.RepeatedField( - proto.MESSAGE, number=149850285, message="NetworkEndpoint", - ) - + project = proto.Field(proto.STRING, number=227560217,) + public_delegated_prefix = proto.Field(proto.STRING, number=204238440,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class Policy(proto.Message): - r"""An Identity and Access Management (IAM) policy, which specifies - access controls for Google Cloud resources. - - A ``Policy`` is a collection of ``bindings``. A ``binding`` binds - one or more ``members`` to a single ``role``. Members can be user - accounts, service accounts, Google groups, and domains (such as G - Suite). A ``role`` is a named list of permissions; each ``role`` can - be an IAM predefined role or a user-created custom role. - - For some types of Google Cloud resources, a ``binding`` can also - specify a ``condition``, which is a logical expression that allows - access to a resource only if the expression evaluates to ``true``. A - condition can add constraints based on attributes of the request, - the resource, or both. To learn which resources support conditions - in their IAM policies, see the `IAM - documentation `__. - **JSON example:** +class DeleteHealthCheckRequest(proto.Message): + r"""A request message for HealthChecks.Delete. See the method + description for details. - { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", - "members": [ "user:mike@example.com", "group:admins@example.com", - "domain:google.com", - "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { - "role": "roles/resourcemanager.organizationViewer", "members": [ - "user:eve@example.com" ], "condition": { "title": "expirable - access", "description": "Does not grant access after Sep 2020", - "expression": "request.time < - timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": - "BwWWja0YfJA=", "version": 3 } + Attributes: + health_check (str): + Name of the HealthCheck resource to delete. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + """ - **YAML example:** + health_check = proto.Field(proto.STRING, number=308876645,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - bindings: - members: - user:mike@example.com - - group:admins@example.com - domain:google.com - - serviceAccount:my-project-id@appspot.gserviceaccount.com role: - roles/resourcemanager.organizationAdmin - members: - - user:eve@example.com role: roles/resourcemanager.organizationViewer - condition: title: expirable access description: Does not grant - access after Sep 2020 expression: request.time < - timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - - version: 3 - For a description of IAM and its features, see the `IAM - documentation `__. +class DeleteImageRequest(proto.Message): + r"""A request message for Images.Delete. See the method + description for details. Attributes: - audit_configs (Sequence[google.cloud.compute_v1.types.AuditConfig]): - Specifies cloud audit logging configuration - for this policy. - bindings (Sequence[google.cloud.compute_v1.types.Binding]): - Associates a list of ``members`` to a ``role``. Optionally, - may specify a ``condition`` that determines how and when the - ``bindings`` are applied. Each of the ``bindings`` must - contain at least one member. - etag (str): - ``etag`` is used for optimistic concurrency control as a way - to help prevent simultaneous updates of a policy from - overwriting each other. It is strongly suggested that - systems make use of the ``etag`` in the read-modify-write - cycle to perform policy updates in order to avoid race - conditions: An ``etag`` is returned in the response to - ``getIamPolicy``, and systems are expected to put that etag - in the request to ``setIamPolicy`` to ensure that their - change will be applied to the same version of the policy. + image (str): + Name of the image resource to delete. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + """ - **Important:** If you use IAM Conditions, you must include - the ``etag`` field whenever you call ``setIamPolicy``. If - you omit this field, then IAM allows you to overwrite a - version ``3`` policy with a version ``1`` policy, and all of - the conditions in the version ``3`` policy are lost. - iam_owned (bool): + image = proto.Field(proto.STRING, number=100313435,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - rules (Sequence[google.cloud.compute_v1.types.Rule]): - If more than one rule is specified, the rules are applied in - the following manner: - All matching LOG rules are always - applied. - If any DENY/DENY_WITH_LOG rule matches, - permission is denied. Logging will be applied if one or more - matching rule requires logging. - Otherwise, if any - ALLOW/ALLOW_WITH_LOG rule matches, permission is granted. - Logging will be applied if one or more matching rule - requires logging. - Otherwise, if no rule applies, - permission is denied. - version (int): - Specifies the format of the policy. - Valid values are ``0``, ``1``, and ``3``. Requests that - specify an invalid value are rejected. +class DeleteInstanceGroupManagerRequest(proto.Message): + r"""A request message for InstanceGroupManagers.Delete. See the + method description for details. - Any operation that affects conditional role bindings must - specify version ``3``. This requirement applies to the - following operations: + Attributes: + instance_group_manager (str): + The name of the managed instance group to + delete. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone where the managed + instance group is located. + """ - - Getting a policy that includes a conditional role binding - \* Adding a conditional role binding to a policy \* - Changing a conditional role binding in a policy \* - Removing any role binding, with or without a condition, - from a policy that includes conditions + instance_group_manager = proto.Field(proto.STRING, number=249363395,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) - **Important:** If you use IAM Conditions, you must include - the ``etag`` field whenever you call ``setIamPolicy``. If - you omit this field, then IAM allows you to overwrite a - version ``3`` policy with a version ``1`` policy, and all of - the conditions in the version ``3`` policy are lost. - If a policy does not include any conditions, operations on - that policy may specify any valid version or leave the field - unset. +class DeleteInstanceGroupRequest(proto.Message): + r"""A request message for InstanceGroups.Delete. See the method + description for details. - To learn which resources support conditions in their IAM - policies, see the `IAM - documentation `__. + Attributes: + instance_group (str): + The name of the instance group to delete. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone where the instance group + is located. """ - audit_configs = proto.RepeatedField( - proto.MESSAGE, number=328080653, message="AuditConfig", - ) - bindings = proto.RepeatedField(proto.MESSAGE, number=403251854, message="Binding",) - etag = proto.Field(proto.STRING, number=3123477, optional=True,) - iam_owned = proto.Field(proto.BOOL, number=450566203, optional=True,) - rules = proto.RepeatedField(proto.MESSAGE, number=108873975, message="Rule",) - version = proto.Field(proto.INT32, number=351608024, optional=True,) + instance_group = proto.Field(proto.STRING, number=81095253,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class GlobalOrganizationSetPolicyRequest(proto.Message): - r""" +class DeleteInstanceRequest(proto.Message): + r"""A request message for Instances.Delete. See the method + description for details. + Attributes: - bindings (Sequence[google.cloud.compute_v1.types.Binding]): - Flatten Policy to create a backward - compatible wire-format. Deprecated. Use 'policy' - to specify bindings. - etag (str): - Flatten Policy to create a backward - compatible wire-format. Deprecated. Use 'policy' - to specify the etag. - policy (google.cloud.compute_v1.types.Policy): - REQUIRED: The complete policy to be applied - to the 'resource'. The size of the policy is - limited to a few 10s of KB. An empty policy is - in general a valid policy but certain services - (like Projects) might reject them. + instance (str): + Name of the instance resource to delete. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. """ - bindings = proto.RepeatedField(proto.MESSAGE, number=403251854, message="Binding",) - etag = proto.Field(proto.STRING, number=3123477, optional=True,) - policy = proto.Field( - proto.MESSAGE, number=91071794, optional=True, message="Policy", - ) + instance = proto.Field(proto.STRING, number=18257045,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class GlobalSetLabelsRequest(proto.Message): - r""" +class DeleteInstanceTemplateRequest(proto.Message): + r"""A request message for InstanceTemplates.Delete. See the + method description for details. + Attributes: - label_fingerprint (str): - The fingerprint of the previous set of labels - for this resource, used to detect conflicts. The - fingerprint is initially generated by Compute - Engine and changes after every request to modify - or update labels. You must always provide an up- - to-date fingerprint hash when updating or - changing labels, otherwise the request will fail - with error 412 conditionNotMet. Make a get() - request to the resource to get the latest - fingerprint. - labels (Sequence[google.cloud.compute_v1.types.GlobalSetLabelsRequest.LabelsEntry]): - A list of labels to apply for this resource. Each label key - & value must comply with RFC1035. Specifically, the name - must be 1-63 characters long and match the regular - expression ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the - first character must be a lowercase letter, and all - following characters must be a dash, lowercase letter, or - digit, except the last character, which cannot be a dash. - For example, "webserver-frontend": "images". A label value - can also be empty (e.g. "my-label": ""). + instance_template (str): + The name of the instance template to delete. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - label_fingerprint = proto.Field(proto.STRING, number=178124825, optional=True,) - labels = proto.MapField(proto.STRING, proto.STRING, number=500195327,) + instance_template = proto.Field(proto.STRING, number=309248228,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class GlobalSetPolicyRequest(proto.Message): - r""" +class DeleteInstancesInstanceGroupManagerRequest(proto.Message): + r"""A request message for InstanceGroupManagers.DeleteInstances. + See the method description for details. + Attributes: - bindings (Sequence[google.cloud.compute_v1.types.Binding]): - Flatten Policy to create a backward - compatible wire-format. Deprecated. Use 'policy' - to specify bindings. - etag (str): - Flatten Policy to create a backward - compatible wire-format. Deprecated. Use 'policy' - to specify the etag. - policy (google.cloud.compute_v1.types.Policy): - REQUIRED: The complete policy to be applied - to the 'resource'. The size of the policy is - limited to a few 10s of KB. An empty policy is - in general a valid policy but certain services - (like Projects) might reject them. + instance_group_manager (str): + The name of the managed instance group. + instance_group_managers_delete_instances_request_resource (google.cloud.compute_v1.types.InstanceGroupManagersDeleteInstancesRequest): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone where the managed + instance group is located. """ - bindings = proto.RepeatedField(proto.MESSAGE, number=403251854, message="Binding",) - etag = proto.Field(proto.STRING, number=3123477, optional=True,) - policy = proto.Field( - proto.MESSAGE, number=91071794, optional=True, message="Policy", + instance_group_manager = proto.Field(proto.STRING, number=249363395,) + instance_group_managers_delete_instances_request_resource = proto.Field( + proto.MESSAGE, + number=166421252, + message="InstanceGroupManagersDeleteInstancesRequest", ) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class GuestAttributesValue(proto.Message): - r"""Array of guest attribute namespace/key/value tuples. - Attributes: - items (Sequence[google.cloud.compute_v1.types.GuestAttributesEntry]): +class DeleteInstancesRegionInstanceGroupManagerRequest(proto.Message): + r"""A request message for + RegionInstanceGroupManagers.DeleteInstances. See the method + description for details. + Attributes: + instance_group_manager (str): + Name of the managed instance group. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + region_instance_group_managers_delete_instances_request_resource (google.cloud.compute_v1.types.RegionInstanceGroupManagersDeleteInstancesRequest): + The body resource for this request + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="GuestAttributesEntry", + instance_group_manager = proto.Field(proto.STRING, number=249363395,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + region_instance_group_managers_delete_instances_request_resource = proto.Field( + proto.MESSAGE, + number=500876665, + message="RegionInstanceGroupManagersDeleteInstancesRequest", ) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class GuestAttributes(proto.Message): - r"""A guest attributes entry. +class DeleteInterconnectAttachmentRequest(proto.Message): + r"""A request message for InterconnectAttachments.Delete. See the + method description for details. + Attributes: - kind (str): - [Output Only] Type of the resource. Always - compute#guestAttributes for guest attributes entry. - query_path (str): - The path to be queried. This can be the - default namespace ('/') or a nested namespace - ('/\/') or a specified key ('/\/\') - query_value (google.cloud.compute_v1.types.GuestAttributesValue): - [Output Only] The value of the requested queried path. - self_link (str): - [Output Only] Server-defined URL for this resource. - variable_key (str): - The key to search for. - variable_value (str): - [Output Only] The value found for the requested key. + interconnect_attachment (str): + Name of the interconnect attachment to + delete. + project (str): + Project ID for this request. + region (str): + Name of the region for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - query_path = proto.Field(proto.STRING, number=368591164, optional=True,) - query_value = proto.Field( - proto.MESSAGE, number=157570874, optional=True, message="GuestAttributesValue", - ) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - variable_key = proto.Field(proto.STRING, number=164364828, optional=True,) - variable_value = proto.Field(proto.STRING, number=124582382, optional=True,) + interconnect_attachment = proto.Field(proto.STRING, number=308135284,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class GuestAttributesEntry(proto.Message): - r"""A guest attributes namespace/key/value entry. +class DeleteInterconnectRequest(proto.Message): + r"""A request message for Interconnects.Delete. See the method + description for details. + Attributes: - key (str): - Key for the guest attribute entry. - namespace (str): - Namespace for the guest attribute entry. - value (str): - Value for the guest attribute entry. + interconnect (str): + Name of the interconnect to delete. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - key = proto.Field(proto.STRING, number=106079, optional=True,) - namespace = proto.Field(proto.STRING, number=178476379, optional=True,) - value = proto.Field(proto.STRING, number=111972721, optional=True,) + interconnect = proto.Field(proto.STRING, number=224601230,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class HTTP2HealthCheck(proto.Message): - r""" - Attributes: - host (str): - The value of the host header in the HTTP/2 - health check request. If left empty (default - value), the IP on behalf of which this health - check is performed will be used. - port (int): - The TCP port number for the health check - request. The default value is 443. Valid values - are 1 through 65535. - port_name (str): - Port name as defined in InstanceGroup#NamedPort#name. If - both port and port_name are defined, port takes precedence. - port_specification (google.cloud.compute_v1.types.HTTP2HealthCheck.PortSpecification): - Specifies how port is selected for health checking, can be - one of following values: USE_FIXED_PORT: The port number in - port is used for health checking. USE_NAMED_PORT: The - portName is used for health checking. USE_SERVING_PORT: For - NetworkEndpointGroup, the port specified for each network - endpoint is used for health checking. For other backends, - the port or named port specified in the Backend Service is - used for health checking. +class DeleteLicenseRequest(proto.Message): + r"""A request message for Licenses.Delete. See the method + description for details. - If not specified, HTTP2 health check follows behavior - specified in port and portName fields. - proxy_header (google.cloud.compute_v1.types.HTTP2HealthCheck.ProxyHeader): - Specifies the type of proxy header to append before sending - data to the backend, either NONE or PROXY_V1. The default is - NONE. - request_path (str): - The request path of the HTTP/2 health check - request. The default value is /. - response (str): - The string to match anywhere in the first - 1024 bytes of the response body. If left empty - (the default value), the status code determines - health. The response data can only be ASCII. + Attributes: + license_ (str): + Name of the license resource to delete. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - class PortSpecification(proto.Enum): - r"""Specifies how port is selected for health checking, can be one of - following values: USE_FIXED_PORT: The port number in port is used - for health checking. USE_NAMED_PORT: The portName is used for health - checking. USE_SERVING_PORT: For NetworkEndpointGroup, the port - specified for each network endpoint is used for health checking. For - other backends, the port or named port specified in the Backend - Service is used for health checking. + license_ = proto.Field(proto.STRING, number=166757441,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - If not specified, HTTP2 health check follows behavior specified in - port and portName fields. - """ - UNDEFINED_PORT_SPECIFICATION = 0 - USE_FIXED_PORT = 190235748 - USE_NAMED_PORT = 349300671 - USE_SERVING_PORT = 362637516 - class ProxyHeader(proto.Enum): - r"""Specifies the type of proxy header to append before sending data to - the backend, either NONE or PROXY_V1. The default is NONE. - """ - UNDEFINED_PROXY_HEADER = 0 - NONE = 2402104 - PROXY_V1 = 334352940 +class DeleteNetworkEndpointGroupRequest(proto.Message): + r"""A request message for NetworkEndpointGroups.Delete. See the + method description for details. - host = proto.Field(proto.STRING, number=3208616, optional=True,) - port = proto.Field(proto.INT32, number=3446913, optional=True,) - port_name = proto.Field(proto.STRING, number=41534345, optional=True,) - port_specification = proto.Field( - proto.ENUM, number=51590597, optional=True, enum=PortSpecification, - ) - proxy_header = proto.Field( - proto.ENUM, number=160374142, optional=True, enum=ProxyHeader, - ) - request_path = proto.Field(proto.STRING, number=229403605, optional=True,) - response = proto.Field(proto.STRING, number=196547649, optional=True,) + Attributes: + network_endpoint_group (str): + The name of the network endpoint group to + delete. It should comply with RFC1035. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone where the network + endpoint group is located. It should comply with + RFC1035. + """ + network_endpoint_group = proto.Field(proto.STRING, number=433907078,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class HTTPHealthCheck(proto.Message): - r""" - Attributes: - host (str): - The value of the host header in the HTTP - health check request. If left empty (default - value), the IP on behalf of which this health - check is performed will be used. - port (int): - The TCP port number for the health check - request. The default value is 80. Valid values - are 1 through 65535. - port_name (str): - Port name as defined in InstanceGroup#NamedPort#name. If - both port and port_name are defined, port takes precedence. - port_specification (google.cloud.compute_v1.types.HTTPHealthCheck.PortSpecification): - Specifies how port is selected for health checking, can be - one of following values: USE_FIXED_PORT: The port number in - port is used for health checking. USE_NAMED_PORT: The - portName is used for health checking. USE_SERVING_PORT: For - NetworkEndpointGroup, the port specified for each network - endpoint is used for health checking. For other backends, - the port or named port specified in the Backend Service is - used for health checking. - If not specified, HTTP health check follows behavior - specified in port and portName fields. - proxy_header (google.cloud.compute_v1.types.HTTPHealthCheck.ProxyHeader): - Specifies the type of proxy header to append before sending - data to the backend, either NONE or PROXY_V1. The default is - NONE. - request_path (str): - The request path of the HTTP health check - request. The default value is /. - response (str): - The string to match anywhere in the first - 1024 bytes of the response body. If left empty - (the default value), the status code determines - health. The response data can only be ASCII. +class DeleteNetworkRequest(proto.Message): + r"""A request message for Networks.Delete. See the method + description for details. + + Attributes: + network (str): + Name of the network to delete. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - class PortSpecification(proto.Enum): - r"""Specifies how port is selected for health checking, can be one of - following values: USE_FIXED_PORT: The port number in port is used - for health checking. USE_NAMED_PORT: The portName is used for health - checking. USE_SERVING_PORT: For NetworkEndpointGroup, the port - specified for each network endpoint is used for health checking. For - other backends, the port or named port specified in the Backend - Service is used for health checking. + network = proto.Field(proto.STRING, number=232872494,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + - If not specified, HTTP health check follows behavior specified in - port and portName fields. - """ - UNDEFINED_PORT_SPECIFICATION = 0 - USE_FIXED_PORT = 190235748 - USE_NAMED_PORT = 349300671 - USE_SERVING_PORT = 362637516 +class DeleteNodeGroupRequest(proto.Message): + r"""A request message for NodeGroups.Delete. See the method + description for details. - class ProxyHeader(proto.Enum): - r"""Specifies the type of proxy header to append before sending data to - the backend, either NONE or PROXY_V1. The default is NONE. - """ - UNDEFINED_PROXY_HEADER = 0 - NONE = 2402104 - PROXY_V1 = 334352940 + Attributes: + node_group (str): + Name of the NodeGroup resource to delete. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. + """ - host = proto.Field(proto.STRING, number=3208616, optional=True,) - port = proto.Field(proto.INT32, number=3446913, optional=True,) - port_name = proto.Field(proto.STRING, number=41534345, optional=True,) - port_specification = proto.Field( - proto.ENUM, number=51590597, optional=True, enum=PortSpecification, - ) - proxy_header = proto.Field( - proto.ENUM, number=160374142, optional=True, enum=ProxyHeader, - ) - request_path = proto.Field(proto.STRING, number=229403605, optional=True,) - response = proto.Field(proto.STRING, number=196547649, optional=True,) + node_group = proto.Field(proto.STRING, number=469958146,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class HTTPSHealthCheck(proto.Message): - r""" - Attributes: - host (str): - The value of the host header in the HTTPS - health check request. If left empty (default - value), the IP on behalf of which this health - check is performed will be used. - port (int): - The TCP port number for the health check - request. The default value is 443. Valid values - are 1 through 65535. - port_name (str): - Port name as defined in InstanceGroup#NamedPort#name. If - both port and port_name are defined, port takes precedence. - port_specification (google.cloud.compute_v1.types.HTTPSHealthCheck.PortSpecification): - Specifies how port is selected for health checking, can be - one of following values: USE_FIXED_PORT: The port number in - port is used for health checking. USE_NAMED_PORT: The - portName is used for health checking. USE_SERVING_PORT: For - NetworkEndpointGroup, the port specified for each network - endpoint is used for health checking. For other backends, - the port or named port specified in the Backend Service is - used for health checking. +class DeleteNodeTemplateRequest(proto.Message): + r"""A request message for NodeTemplates.Delete. See the method + description for details. - If not specified, HTTPS health check follows behavior - specified in port and portName fields. - proxy_header (google.cloud.compute_v1.types.HTTPSHealthCheck.ProxyHeader): - Specifies the type of proxy header to append before sending - data to the backend, either NONE or PROXY_V1. The default is - NONE. - request_path (str): - The request path of the HTTPS health check - request. The default value is /. - response (str): - The string to match anywhere in the first - 1024 bytes of the response body. If left empty - (the default value), the status code determines - health. The response data can only be ASCII. + Attributes: + node_template (str): + Name of the NodeTemplate resource to delete. + project (str): + Project ID for this request. + region (str): + The name of the region for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - class PortSpecification(proto.Enum): - r"""Specifies how port is selected for health checking, can be one of - following values: USE_FIXED_PORT: The port number in port is used - for health checking. USE_NAMED_PORT: The portName is used for health - checking. USE_SERVING_PORT: For NetworkEndpointGroup, the port - specified for each network endpoint is used for health checking. For - other backends, the port or named port specified in the Backend - Service is used for health checking. + node_template = proto.Field(proto.STRING, number=323154455,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - If not specified, HTTPS health check follows behavior specified in - port and portName fields. - """ - UNDEFINED_PORT_SPECIFICATION = 0 - USE_FIXED_PORT = 190235748 - USE_NAMED_PORT = 349300671 - USE_SERVING_PORT = 362637516 - class ProxyHeader(proto.Enum): - r"""Specifies the type of proxy header to append before sending data to - the backend, either NONE or PROXY_V1. The default is NONE. - """ - UNDEFINED_PROXY_HEADER = 0 - NONE = 2402104 - PROXY_V1 = 334352940 +class DeleteNodesNodeGroupRequest(proto.Message): + r"""A request message for NodeGroups.DeleteNodes. See the method + description for details. - host = proto.Field(proto.STRING, number=3208616, optional=True,) - port = proto.Field(proto.INT32, number=3446913, optional=True,) - port_name = proto.Field(proto.STRING, number=41534345, optional=True,) - port_specification = proto.Field( - proto.ENUM, number=51590597, optional=True, enum=PortSpecification, - ) - proxy_header = proto.Field( - proto.ENUM, number=160374142, optional=True, enum=ProxyHeader, + Attributes: + node_group (str): + Name of the NodeGroup resource whose nodes + will be deleted. + node_groups_delete_nodes_request_resource (google.cloud.compute_v1.types.NodeGroupsDeleteNodesRequest): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. + """ + + node_group = proto.Field(proto.STRING, number=469958146,) + node_groups_delete_nodes_request_resource = proto.Field( + proto.MESSAGE, number=183298962, message="NodeGroupsDeleteNodesRequest", ) - request_path = proto.Field(proto.STRING, number=229403605, optional=True,) - response = proto.Field(proto.STRING, number=196547649, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class HealthCheckLogConfig(proto.Message): - r"""Configuration of logging on a health check. If logging is - enabled, logs will be exported to Stackdriver. +class DeletePacketMirroringRequest(proto.Message): + r"""A request message for PacketMirrorings.Delete. See the method + description for details. Attributes: - enable (bool): - Indicates whether or not to export logs. This - is false by default, which means no health check - logging will be done. + packet_mirroring (str): + Name of the PacketMirroring resource to + delete. + project (str): + Project ID for this request. + region (str): + Name of the region for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - enable = proto.Field(proto.BOOL, number=311764355, optional=True,) + packet_mirroring = proto.Field(proto.STRING, number=22305996,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class SSLHealthCheck(proto.Message): - r""" - Attributes: - port (int): - The TCP port number for the health check - request. The default value is 443. Valid values - are 1 through 65535. - port_name (str): - Port name as defined in InstanceGroup#NamedPort#name. If - both port and port_name are defined, port takes precedence. - port_specification (google.cloud.compute_v1.types.SSLHealthCheck.PortSpecification): - Specifies how port is selected for health checking, can be - one of following values: USE_FIXED_PORT: The port number in - port is used for health checking. USE_NAMED_PORT: The - portName is used for health checking. USE_SERVING_PORT: For - NetworkEndpointGroup, the port specified for each network - endpoint is used for health checking. For other backends, - the port or named port specified in the Backend Service is - used for health checking. +class DeletePerInstanceConfigsInstanceGroupManagerRequest(proto.Message): + r"""A request message for + InstanceGroupManagers.DeletePerInstanceConfigs. See the method + description for details. - If not specified, SSL health check follows behavior - specified in port and portName fields. - proxy_header (google.cloud.compute_v1.types.SSLHealthCheck.ProxyHeader): - Specifies the type of proxy header to append before sending - data to the backend, either NONE or PROXY_V1. The default is - NONE. - request (str): - The application data to send once the SSL - connection has been established (default value - is empty). If both request and response are - empty, the connection establishment alone will - indicate health. The request data can only be - ASCII. - response (str): - The bytes to match against the beginning of - the response data. If left empty (the default - value), any response will indicate health. The - response data can only be ASCII. + Attributes: + instance_group_manager (str): + The name of the managed instance group. It + should conform to RFC1035. + instance_group_managers_delete_per_instance_configs_req_resource (google.cloud.compute_v1.types.InstanceGroupManagersDeletePerInstanceConfigsReq): + The body resource for this request + project (str): + Project ID for this request. + zone (str): + The name of the zone where the managed + instance group is located. It should conform to + RFC1035. """ - class PortSpecification(proto.Enum): - r"""Specifies how port is selected for health checking, can be one of - following values: USE_FIXED_PORT: The port number in port is used - for health checking. USE_NAMED_PORT: The portName is used for health - checking. USE_SERVING_PORT: For NetworkEndpointGroup, the port - specified for each network endpoint is used for health checking. For - other backends, the port or named port specified in the Backend - Service is used for health checking. + instance_group_manager = proto.Field(proto.STRING, number=249363395,) + instance_group_managers_delete_per_instance_configs_req_resource = proto.Field( + proto.MESSAGE, + number=362427680, + message="InstanceGroupManagersDeletePerInstanceConfigsReq", + ) + project = proto.Field(proto.STRING, number=227560217,) + zone = proto.Field(proto.STRING, number=3744684,) - If not specified, SSL health check follows behavior specified in - port and portName fields. - """ - UNDEFINED_PORT_SPECIFICATION = 0 - USE_FIXED_PORT = 190235748 - USE_NAMED_PORT = 349300671 - USE_SERVING_PORT = 362637516 - class ProxyHeader(proto.Enum): - r"""Specifies the type of proxy header to append before sending data to - the backend, either NONE or PROXY_V1. The default is NONE. - """ - UNDEFINED_PROXY_HEADER = 0 - NONE = 2402104 - PROXY_V1 = 334352940 +class DeletePerInstanceConfigsRegionInstanceGroupManagerRequest(proto.Message): + r"""A request message for + RegionInstanceGroupManagers.DeletePerInstanceConfigs. See the + method description for details. - port = proto.Field(proto.INT32, number=3446913, optional=True,) - port_name = proto.Field(proto.STRING, number=41534345, optional=True,) - port_specification = proto.Field( - proto.ENUM, number=51590597, optional=True, enum=PortSpecification, - ) - proxy_header = proto.Field( - proto.ENUM, number=160374142, optional=True, enum=ProxyHeader, + Attributes: + instance_group_manager (str): + The name of the managed instance group. It + should conform to RFC1035. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request, + should conform to RFC1035. + region_instance_group_manager_delete_instance_config_req_resource (google.cloud.compute_v1.types.RegionInstanceGroupManagerDeleteInstanceConfigReq): + The body resource for this request + """ + + instance_group_manager = proto.Field(proto.STRING, number=249363395,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + region_instance_group_manager_delete_instance_config_req_resource = proto.Field( + proto.MESSAGE, + number=740741, + message="RegionInstanceGroupManagerDeleteInstanceConfigReq", ) - request = proto.Field(proto.STRING, number=21951119, optional=True,) - response = proto.Field(proto.STRING, number=196547649, optional=True,) -class TCPHealthCheck(proto.Message): - r""" - Attributes: - port (int): - The TCP port number for the health check - request. The default value is 80. Valid values - are 1 through 65535. - port_name (str): - Port name as defined in InstanceGroup#NamedPort#name. If - both port and port_name are defined, port takes precedence. - port_specification (google.cloud.compute_v1.types.TCPHealthCheck.PortSpecification): - Specifies how port is selected for health checking, can be - one of following values: USE_FIXED_PORT: The port number in - port is used for health checking. USE_NAMED_PORT: The - portName is used for health checking. USE_SERVING_PORT: For - NetworkEndpointGroup, the port specified for each network - endpoint is used for health checking. For other backends, - the port or named port specified in the Backend Service is - used for health checking. +class DeletePublicAdvertisedPrefixeRequest(proto.Message): + r"""A request message for PublicAdvertisedPrefixes.Delete. See + the method description for details. - If not specified, TCP health check follows behavior - specified in port and portName fields. - proxy_header (google.cloud.compute_v1.types.TCPHealthCheck.ProxyHeader): - Specifies the type of proxy header to append before sending - data to the backend, either NONE or PROXY_V1. The default is - NONE. - request (str): - The application data to send once the TCP - connection has been established (default value - is empty). If both request and response are - empty, the connection establishment alone will - indicate health. The request data can only be - ASCII. - response (str): - The bytes to match against the beginning of - the response data. If left empty (the default - value), any response will indicate health. The - response data can only be ASCII. + Attributes: + project (str): + Project ID for this request. + public_advertised_prefix (str): + Name of the PublicAdvertisedPrefix resource + to delete. + request_id (str): + An optional request ID to identify requests. Specify a + unique request ID so that if you must retry your request, + the server will know to ignore the request if it has already + been completed. For example, consider a situation where you + make an initial request and the request times out. If you + make the request again with the same request ID, the server + can check if original operation with the same request ID was + received, and if so, will ignore the second request. This + prevents clients from accidentally creating duplicate + commitments. The request ID must be a valid UUID with the + exception that zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). end_interface: + MixerMutationRequestBuilder """ - class PortSpecification(proto.Enum): - r"""Specifies how port is selected for health checking, can be one of - following values: USE_FIXED_PORT: The port number in port is used - for health checking. USE_NAMED_PORT: The portName is used for health - checking. USE_SERVING_PORT: For NetworkEndpointGroup, the port - specified for each network endpoint is used for health checking. For - other backends, the port or named port specified in the Backend - Service is used for health checking. + project = proto.Field(proto.STRING, number=227560217,) + public_advertised_prefix = proto.Field(proto.STRING, number=101874590,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - If not specified, TCP health check follows behavior specified in - port and portName fields. - """ - UNDEFINED_PORT_SPECIFICATION = 0 - USE_FIXED_PORT = 190235748 - USE_NAMED_PORT = 349300671 - USE_SERVING_PORT = 362637516 - class ProxyHeader(proto.Enum): - r"""Specifies the type of proxy header to append before sending data to - the backend, either NONE or PROXY_V1. The default is NONE. - """ - UNDEFINED_PROXY_HEADER = 0 - NONE = 2402104 - PROXY_V1 = 334352940 +class DeletePublicDelegatedPrefixeRequest(proto.Message): + r"""A request message for PublicDelegatedPrefixes.Delete. See the + method description for details. - port = proto.Field(proto.INT32, number=3446913, optional=True,) - port_name = proto.Field(proto.STRING, number=41534345, optional=True,) - port_specification = proto.Field( - proto.ENUM, number=51590597, optional=True, enum=PortSpecification, - ) - proxy_header = proto.Field( - proto.ENUM, number=160374142, optional=True, enum=ProxyHeader, - ) - request = proto.Field(proto.STRING, number=21951119, optional=True,) - response = proto.Field(proto.STRING, number=196547649, optional=True,) + Attributes: + project (str): + Project ID for this request. + public_delegated_prefix (str): + Name of the PublicDelegatedPrefix resource to + delete. + region (str): + Name of the region of this request. + request_id (str): + An optional request ID to identify requests. Specify a + unique request ID so that if you must retry your request, + the server will know to ignore the request if it has already + been completed. For example, consider a situation where you + make an initial request and the request times out. If you + make the request again with the same request ID, the server + can check if original operation with the same request ID was + received, and if so, will ignore the second request. This + prevents clients from accidentally creating duplicate + commitments. The request ID must be a valid UUID with the + exception that zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). end_interface: + MixerMutationRequestBuilder + """ + project = proto.Field(proto.STRING, number=227560217,) + public_delegated_prefix = proto.Field(proto.STRING, number=204238440,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class HealthCheck(proto.Message): - r"""Represents a Health Check resource. - Google Compute Engine has two Health Check resources: +class DeleteRegionAutoscalerRequest(proto.Message): + r"""A request message for RegionAutoscalers.Delete. See the + method description for details. - - `Global `__ - \* - `Regional `__ + Attributes: + autoscaler (str): + Name of the autoscaler to delete. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + """ - Internal HTTP(S) load balancers must use regional health checks - (``compute.v1.regionHealthChecks``). + autoscaler = proto.Field(proto.STRING, number=517258967,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - Traffic Director must use global health checks - (``compute.v1.HealthChecks``). - Internal TCP/UDP load balancers can use either regional or global - health checks (``compute.v1.regionHealthChecks`` or - ``compute.v1.HealthChecks``). +class DeleteRegionBackendServiceRequest(proto.Message): + r"""A request message for RegionBackendServices.Delete. See the + method description for details. - External HTTP(S), TCP proxy, and SSL proxy load balancers as well as - managed instance group auto-healing must use global health checks - (``compute.v1.HealthChecks``). + Attributes: + backend_service (str): + Name of the BackendService resource to + delete. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + """ + + backend_service = proto.Field(proto.STRING, number=306946058,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - Network load balancers must use legacy HTTP health checks - (httpHealthChecks). - For more information, see Health checks overview. +class DeleteRegionDiskRequest(proto.Message): + r"""A request message for RegionDisks.Delete. See the method + description for details. Attributes: - check_interval_sec (int): - How often (in seconds) to send a health - check. The default value is 5 seconds. - creation_timestamp (str): - [Output Only] Creation timestamp in 3339 text format. - description (str): - An optional description of this resource. - Provide this property when you create the - resource. - grpc_health_check (google.cloud.compute_v1.types.GRPCHealthCheck): + disk (str): + Name of the regional persistent disk to + delete. + project (str): + Project ID for this request. + region (str): + Name of the region for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + """ - healthy_threshold (int): - A so-far unhealthy instance will be marked - healthy after this many consecutive successes. - The default value is 2. - http2_health_check (google.cloud.compute_v1.types.HTTP2HealthCheck): + disk = proto.Field(proto.STRING, number=3083677,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - http_health_check (google.cloud.compute_v1.types.HTTPHealthCheck): - https_health_check (google.cloud.compute_v1.types.HTTPSHealthCheck): +class DeleteRegionHealthCheckRequest(proto.Message): + r"""A request message for RegionHealthChecks.Delete. See the + method description for details. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - kind (str): - Type of the resource. - log_config (google.cloud.compute_v1.types.HealthCheckLogConfig): - Configure logging on this health check. - name (str): - Name of the resource. Provided by the client when the - resource is created. The name must be 1-63 characters long, - and comply with RFC1035. For example, a name that is 1-63 - characters long, matches the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?``, and otherwise complies with - RFC1035. This regular expression describes a name where the - first character is a lowercase letter, and all following - characters are a dash, lowercase letter, or digit, except - the last character, which isn't a dash. + Attributes: + health_check (str): + Name of the HealthCheck resource to delete. + project (str): + Project ID for this request. region (str): - [Output Only] Region where the health check resides. Not - applicable to global health checks. - self_link (str): - [Output Only] Server-defined URL for the resource. - ssl_health_check (google.cloud.compute_v1.types.SSLHealthCheck): - - tcp_health_check (google.cloud.compute_v1.types.TCPHealthCheck): - - timeout_sec (int): - How long (in seconds) to wait before claiming - failure. The default value is 5 seconds. It is - invalid for timeoutSec to have greater value - than checkIntervalSec. - type_ (google.cloud.compute_v1.types.HealthCheck.Type): - Specifies the type of the healthCheck, either - TCP, SSL, HTTP, HTTPS or HTTP2. If not - specified, the default is TCP. Exactly one of - the protocol-specific health check field must be - specified, which must match type field. - unhealthy_threshold (int): - A so-far healthy instance will be marked - unhealthy after this many consecutive failures. - The default value is 2. + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - class Type(proto.Enum): - r"""Specifies the type of the healthCheck, either TCP, SSL, HTTP, - HTTPS or HTTP2. If not specified, the default is TCP. Exactly - one of the protocol-specific health check field must be - specified, which must match type field. - """ - UNDEFINED_TYPE = 0 - GRPC = 2196510 - HTTP = 2228360 - HTTP2 = 69079210 - HTTPS = 69079243 - INVALID = 530283991 - SSL = 82412 - TCP = 82881 + health_check = proto.Field(proto.STRING, number=308876645,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - check_interval_sec = proto.Field(proto.INT32, number=345561006, optional=True,) - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - grpc_health_check = proto.Field( - proto.MESSAGE, number=85529574, optional=True, message="GRPCHealthCheck", - ) - healthy_threshold = proto.Field(proto.INT32, number=403212361, optional=True,) - http2_health_check = proto.Field( - proto.MESSAGE, number=11360986, optional=True, message="HTTP2HealthCheck", - ) - http_health_check = proto.Field( - proto.MESSAGE, number=412586940, optional=True, message="HTTPHealthCheck", - ) - https_health_check = proto.Field( - proto.MESSAGE, number=436046905, optional=True, message="HTTPSHealthCheck", - ) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - log_config = proto.Field( - proto.MESSAGE, number=351299741, optional=True, message="HealthCheckLogConfig", - ) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - region = proto.Field(proto.STRING, number=138946292, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - ssl_health_check = proto.Field( - proto.MESSAGE, number=280032440, optional=True, message="SSLHealthCheck", - ) - tcp_health_check = proto.Field( - proto.MESSAGE, number=469980419, optional=True, message="TCPHealthCheck", - ) - timeout_sec = proto.Field(proto.INT32, number=79994995, optional=True,) - type_ = proto.Field(proto.ENUM, number=3575610, optional=True, enum=Type,) - unhealthy_threshold = proto.Field(proto.INT32, number=227958480, optional=True,) +class DeleteRegionHealthCheckServiceRequest(proto.Message): + r"""A request message for RegionHealthCheckServices.Delete. See + the method description for details. -class HealthCheckList(proto.Message): - r"""Contains a list of HealthCheck resources. Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.HealthCheck]): - A list of HealthCheck resources. - kind (str): - Type of resource. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + health_check_service (str): + Name of the HealthCheckService to delete. The + name must be 1-63 characters long, and comply + with RFC1035. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="HealthCheck",) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) + health_check_service = proto.Field(proto.STRING, number=408374747,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class HealthCheckReference(proto.Message): - r"""A full or valid partial URL to a health check. For example, - the following are valid URLs: - - https://www.googleapis.com/compute/beta/projects/project- - id/global/httpHealthChecks/health-check - projects/project- - id/global/httpHealthChecks/health-check - - global/httpHealthChecks/health-check +class DeleteRegionInstanceGroupManagerRequest(proto.Message): + r"""A request message for RegionInstanceGroupManagers.Delete. See + the method description for details. Attributes: - health_check (str): - + instance_group_manager (str): + Name of the managed instance group to delete. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - health_check = proto.Field(proto.STRING, number=308876645, optional=True,) - + instance_group_manager = proto.Field(proto.STRING, number=249363395,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class HealthCheckService(proto.Message): - r"""Represents a Health-Check as a Service resource. - (== resource_for {$api_version}.regionHealthCheckServices ==) +class DeleteRegionNetworkEndpointGroupRequest(proto.Message): + r"""A request message for RegionNetworkEndpointGroups.Delete. See + the method description for details. Attributes: - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - description (str): - An optional description of this resource. - Provide this property when you create the - resource. - fingerprint (str): - Fingerprint of this resource. A hash of the - contents stored in this object. This field is - used in optimistic locking. This field will be - ignored when inserting a HealthCheckService. An - up-to-date fingerprint must be provided in order - to patch/update the HealthCheckService; - Otherwise, the request will fail with error 412 - conditionNotMet. To see the latest fingerprint, - make a get() request to retrieve the - HealthCheckService. - health_checks (Sequence[str]): - List of URLs to the HealthCheck resources. Must have at - least one HealthCheck, and not more than 10. HealthCheck - resources must have portSpecification=USE_SERVING_PORT. For - regional HealthCheckService, the HealthCheck must be - regional and in the same region. For global - HealthCheckService, HealthCheck must be global. Mix of - regional and global HealthChecks is not supported. Multiple - regional HealthChecks must belong to the same region. - Regional HealthChecks 0. If not specified, defaults - to 1. - per_try_timeout (google.cloud.compute_v1.types.Duration): - Specifies a non-zero timeout per retry - attempt. If not specified, will use the timeout - set in HttpRouteAction. If timeout in - HttpRouteAction is not set, will use the largest - timeout among all backend services associated - with the route. - retry_conditions (Sequence[str]): - Specfies one or more conditions when this retry rule - applies. Valid values are: - - - 5xx: Loadbalancer will attempt a retry if the backend - service responds with any 5xx response code, or if the - backend service does not respond at all, example: - disconnects, reset, read timeout, connection failure, and - refused streams. - - gateway-error: Similar to 5xx, but only applies to - response codes 502, 503 or 504. - - - - connect-failure: Loadbalancer will retry on failures - connecting to backend services, for example due to - connection timeouts. - - retriable-4xx: Loadbalancer will retry for retriable 4xx - response codes. Currently the only retriable error - supported is 409. - - refused-stream:Loadbalancer will retry if the backend - service resets the stream with a REFUSED_STREAM error - code. This reset type indicates that it is safe to retry. - - cancelledLoadbalancer will retry if the gRPC status code - in the response header is set to cancelled - - deadline-exceeded: Loadbalancer will retry if the gRPC - status code in the response header is set to - deadline-exceeded - - resource-exhausted: Loadbalancer will retry if the gRPC - status code in the response header is set to - resource-exhausted - - unavailable: Loadbalancer will retry if the gRPC status - code in the response header is set to unavailable + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. Specify a + unique request ID so that if you must retry your request, + the server will know to ignore the request if it has already + been completed. For example, consider a situation where you + make an initial request and the request times out. If you + make the request again with the same request ID, the server + can check if original operation with the same request ID was + received, and if so, will ignore the second request. This + prevents clients from accidentally creating duplicate + commitments. The request ID must be a valid UUID with the + exception that zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). end_interface: + MixerMutationRequestBuilder + ssl_certificate (str): + Name of the SslCertificate resource to + delete. """ - num_retries = proto.Field(proto.UINT32, number=251680141, optional=True,) - per_try_timeout = proto.Field( - proto.MESSAGE, number=280041147, optional=True, message="Duration", - ) - retry_conditions = proto.RepeatedField(proto.STRING, number=28815535,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + ssl_certificate = proto.Field(proto.STRING, number=46443492,) -class RequestMirrorPolicy(proto.Message): - r"""A policy that specifies how requests intended for the route's - backends are shadowed to a separate mirrored backend service. - Loadbalancer does not wait for responses from the shadow - service. Prior to sending traffic to the shadow service, the - host / authority header is suffixed with -shadow. +class DeleteSslPolicyRequest(proto.Message): + r"""A request message for SslPolicies.Delete. See the method + description for details. Attributes: - backend_service (str): - The full or partial URL to the BackendService - resource being mirrored to. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + ssl_policy (str): + Name of the SSL policy to delete. The name + must be 1-63 characters long, and comply with + RFC1035. """ - backend_service = proto.Field(proto.STRING, number=306946058, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + ssl_policy = proto.Field(proto.STRING, number=295190213,) -class UrlRewrite(proto.Message): - r"""The spec for modifying the path before sending the request to - the matched backend service. +class DeleteSubnetworkRequest(proto.Message): + r"""A request message for Subnetworks.Delete. See the method + description for details. Attributes: - host_rewrite (str): - Prior to forwarding the request to the - selected service, the request's host header is - replaced with contents of hostRewrite. The value - must be between 1 and 255 characters. - path_prefix_rewrite (str): - Prior to forwarding the request to the - selected backend service, the matching portion - of the request's path is replaced by - pathPrefixRewrite. The value must be between 1 - and 1024 characters. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + subnetwork (str): + Name of the Subnetwork resource to delete. """ - host_rewrite = proto.Field(proto.STRING, number=159819253, optional=True,) - path_prefix_rewrite = proto.Field(proto.STRING, number=41186361, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + subnetwork = proto.Field(proto.STRING, number=307827694,) -class WeightedBackendService(proto.Message): - r"""In contrast to a single BackendService in HttpRouteAction to - which all matching traffic is directed to, - WeightedBackendService allows traffic to be split across - multiple BackendServices. The volume of traffic for each - BackendService is proportional to the weight specified in each - WeightedBackendService +class DeleteTargetGrpcProxyRequest(proto.Message): + r"""A request message for TargetGrpcProxies.Delete. See the + method description for details. Attributes: - backend_service (str): - The full or partial URL to the default - BackendService resource. Before forwarding the - request to backendService, the loadbalancer - applies any relevant headerActions specified as - part of this backendServiceWeight. - header_action (google.cloud.compute_v1.types.HttpHeaderAction): - Specifies changes to request and response - headers that need to take effect for the - selected backendService. headerAction specified - here take effect before headerAction in the - enclosing HttpRouteRule, PathMatcher and UrlMap. - Note that headerAction is not supported for - Loadbalancers that have their - loadBalancingScheme set to EXTERNAL. Not - supported when the URL map is bound to target - gRPC proxy that has validateForProxyless field - set to true. - weight (int): - Specifies the fraction of traffic sent to - backendService, computed as weight / (sum of all - weightedBackendService weights in routeAction) . - The selection of a backend service is determined - only for new traffic. Once a user's request has - been directed to a backendService, subsequent - requests will be sent to the same backendService - as determined by the BackendService's session - affinity policy. The value must be between 0 and - 1000 + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. Specify a + unique request ID so that if you must retry your request, + the server will know to ignore the request if it has already + been completed. For example, consider a situation where you + make an initial request and the request times out. If you + make the request again with the same request ID, the server + can check if original operation with the same request ID was + received, and if so, will ignore the second request. This + prevents clients from accidentally creating duplicate + commitments. The request ID must be a valid UUID with the + exception that zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). end_interface: + MixerMutationRequestBuilder + target_grpc_proxy (str): + Name of the TargetGrpcProxy resource to + delete. """ - backend_service = proto.Field(proto.STRING, number=306946058, optional=True,) - header_action = proto.Field( - proto.MESSAGE, number=328077352, optional=True, message="HttpHeaderAction", - ) - weight = proto.Field(proto.UINT32, number=282149496, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_grpc_proxy = proto.Field(proto.STRING, number=5020283,) -class HttpRouteAction(proto.Message): - r""" +class DeleteTargetHttpProxyRequest(proto.Message): + r"""A request message for TargetHttpProxies.Delete. See the + method description for details. + Attributes: - cors_policy (google.cloud.compute_v1.types.CorsPolicy): - The specification for allowing client side - cross-origin requests. Please see W3C - Recommendation for Cross Origin Resource Sharing - Not supported when the URL map is bound to - target gRPC proxy. - fault_injection_policy (google.cloud.compute_v1.types.HttpFaultInjection): - The specification for fault injection introduced into - traffic to test the resiliency of clients to backend service - failure. As part of fault injection, when clients send - requests to a backend service, delays can be introduced by - Loadbalancer on a percentage of requests before sending - those request to the backend service. Similarly requests - from clients can be aborted by the Loadbalancer for a - percentage of requests. timeout and retry_policy will be - ignored by clients that are configured with a - fault_injection_policy. Not supported when the URL map is - bound to target gRPC proxy that has validateForProxyless - field set to true. - max_stream_duration (google.cloud.compute_v1.types.Duration): - Specifies the maximum duration (timeout) for streams on the - selected route. Unlike the timeout field where the timeout - duration starts from the time the request has been fully - processed (i.e. end-of-stream), the duration in this field - is computed from the beginning of the stream until the - response has been completely processed, including all - retries. A stream that does not complete in this duration is - closed. If not specified, will use the largest - maxStreamDuration among all backend services associated with - the route. This field is only allowed if the Url map is used - with backend services with loadBalancingScheme set to - INTERNAL_SELF_MANAGED. - request_mirror_policy (google.cloud.compute_v1.types.RequestMirrorPolicy): - Specifies the policy on how requests intended - for the route's backends are shadowed to a - separate mirrored backend service. Loadbalancer - does not wait for responses from the shadow - service. Prior to sending traffic to the shadow - service, the host / authority header is suffixed - with -shadow. Not supported when the URL map is - bound to target gRPC proxy that has - validateForProxyless field set to true. - retry_policy (google.cloud.compute_v1.types.HttpRetryPolicy): - Specifies the retry policy associated with - this route. Not supported when the URL map is - bound to target gRPC proxy that has - validateForProxyless field set to true. - timeout (google.cloud.compute_v1.types.Duration): - Specifies the timeout for the selected route. - Timeout is computed from the time the request - has been fully processed (i.e. end-of-stream) up - until the response has been completely - processed. Timeout includes all retries. If not - specified, will use the largest timeout among - all backend services associated with the route. - Not supported when the URL map is bound to - target gRPC proxy that has validateForProxyless - field set to true. - url_rewrite (google.cloud.compute_v1.types.UrlRewrite): - The spec to modify the URL of the request, - prior to forwarding the request to the matched - service. urlRewrite is the only action supported - in UrlMaps for external HTTP(S) load balancers. - Not supported when the URL map is bound to - target gRPC proxy that has validateForProxyless - field set to true. - weighted_backend_services (Sequence[google.cloud.compute_v1.types.WeightedBackendService]): - A list of weighted backend services to send - traffic to when a route match occurs. The - weights determine the fraction of traffic that - flows to their corresponding backend service. If - all traffic needs to go to a single backend - service, there must be one - weightedBackendService with weight set to a non- - zero number. Once a backendService is identified - and before forwarding the request to the backend - service, advanced routing actions such as URL - rewrites and header transformations are applied - depending on additional settings specified in - this HttpRouteAction. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_http_proxy (str): + Name of the TargetHttpProxy resource to + delete. """ - cors_policy = proto.Field( - proto.MESSAGE, number=398943748, optional=True, message="CorsPolicy", - ) - fault_injection_policy = proto.Field( - proto.MESSAGE, number=412781079, optional=True, message="HttpFaultInjection", - ) - max_stream_duration = proto.Field( - proto.MESSAGE, number=61428376, optional=True, message="Duration", - ) - request_mirror_policy = proto.Field( - proto.MESSAGE, number=220196866, optional=True, message="RequestMirrorPolicy", - ) - retry_policy = proto.Field( - proto.MESSAGE, number=56799913, optional=True, message="HttpRetryPolicy", - ) - timeout = proto.Field( - proto.MESSAGE, number=296701281, optional=True, message="Duration", - ) - url_rewrite = proto.Field( - proto.MESSAGE, number=273333948, optional=True, message="UrlRewrite", - ) - weighted_backend_services = proto.RepeatedField( - proto.MESSAGE, number=337028049, message="WeightedBackendService", - ) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_http_proxy = proto.Field(proto.STRING, number=206872421,) -class HttpRouteRuleMatch(proto.Message): - r"""HttpRouteRuleMatch specifies a set of criteria for matching - requests to an HttpRouteRule. All specified criteria must be - satisfied for a match to occur. +class DeleteTargetHttpsProxyRequest(proto.Message): + r"""A request message for TargetHttpsProxies.Delete. See the + method description for details. Attributes: - full_path_match (str): - For satisfying the matchRule condition, the - path of the request must exactly match the value - specified in fullPathMatch after removing any - query parameters and anchor that may be part of - the original URL. fullPathMatch must be between - 1 and 1024 characters. Only one of prefixMatch, - fullPathMatch or regexMatch must be specified. - header_matches (Sequence[google.cloud.compute_v1.types.HttpHeaderMatch]): - Specifies a list of header match criteria, - all of which must match corresponding headers in - the request. - ignore_case (bool): - Specifies that prefixMatch and fullPathMatch - matches are case sensitive. The default value is - false. ignoreCase must not be used with - regexMatch. - Not supported when the URL map is bound to - target gRPC proxy. - metadata_filters (Sequence[google.cloud.compute_v1.types.MetadataFilter]): - Opaque filter criteria used by Loadbalancer to restrict - routing configuration to a limited set of xDS compliant - clients. In their xDS requests to Loadbalancer, xDS clients - present node metadata. When there is a match, the relevant - routing configuration is made available to those proxies. - For each metadataFilter in this list, if its - filterMatchCriteria is set to MATCH_ANY, at least one of the - filterLabels must match the corresponding label provided in - the metadata. If its filterMatchCriteria is set to - MATCH_ALL, then all of its filterLabels must match with - corresponding labels provided in the metadata. If multiple - metadataFilters are specified, all of them need to be - satisfied in order to be considered a match. metadataFilters - specified here will be applied after those specified in - ForwardingRule that refers to the UrlMap this - HttpRouteRuleMatch belongs to. metadataFilters only applies - to Loadbalancers that have their loadBalancingScheme set to - INTERNAL_SELF_MANAGED. Not supported when the URL map is - bound to target gRPC proxy that has validateForProxyless - field set to true. - prefix_match (str): - For satisfying the matchRule condition, the - request's path must begin with the specified - prefixMatch. prefixMatch must begin with a /. - The value must be between 1 and 1024 characters. - Only one of prefixMatch, fullPathMatch or - regexMatch must be specified. - query_parameter_matches (Sequence[google.cloud.compute_v1.types.HttpQueryParameterMatch]): - Specifies a list of query parameter match - criteria, all of which must match corresponding - query parameters in the request. Not supported - when the URL map is bound to target gRPC proxy. - regex_match (str): - For satisfying the matchRule condition, the path of the - request must satisfy the regular expression specified in - regexMatch after removing any query parameters and anchor - supplied with the original URL. For regular expression - grammar please see github.com/google/re2/wiki/Syntax Only - one of prefixMatch, fullPathMatch or regexMatch must be - specified. Note that regexMatch only applies to - Loadbalancers that have their loadBalancingScheme set to - INTERNAL_SELF_MANAGED. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_https_proxy (str): + Name of the TargetHttpsProxy resource to + delete. """ - full_path_match = proto.Field(proto.STRING, number=214598875, optional=True,) - header_matches = proto.RepeatedField( - proto.MESSAGE, number=361903489, message="HttpHeaderMatch", - ) - ignore_case = proto.Field(proto.BOOL, number=464324989, optional=True,) - metadata_filters = proto.RepeatedField( - proto.MESSAGE, number=464725739, message="MetadataFilter", - ) - prefix_match = proto.Field(proto.STRING, number=257898968, optional=True,) - query_parameter_matches = proto.RepeatedField( - proto.MESSAGE, number=286231270, message="HttpQueryParameterMatch", - ) - regex_match = proto.Field(proto.STRING, number=107387853, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_https_proxy = proto.Field(proto.STRING, number=52336748,) -class HttpRouteRule(proto.Message): - r"""An HttpRouteRule specifies how to match an HTTP request and - the corresponding routing action that load balancing proxies - will perform. +class DeleteTargetInstanceRequest(proto.Message): + r"""A request message for TargetInstances.Delete. See the method + description for details. Attributes: - description (str): - The short description conveying the intent of - this routeRule. The description can have a - maximum length of 1024 characters. - header_action (google.cloud.compute_v1.types.HttpHeaderAction): - Specifies changes to request and response headers that need - to take effect for the selected backendService. The - headerAction specified here are applied before the matching - pathMatchers[].headerAction and after - pathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction - Note that headerAction is not supported for Loadbalancers - that have their loadBalancingScheme set to EXTERNAL. Not - supported when the URL map is bound to target gRPC proxy - that has validateForProxyless field set to true. - match_rules (Sequence[google.cloud.compute_v1.types.HttpRouteRuleMatch]): - The list of criteria for matching attributes - of a request to this routeRule. This list has OR - semantics: the request matches this routeRule - when any of the matchRules are satisfied. - However predicates within a given matchRule have - AND semantics. All predicates within a matchRule - must match for the request to match the rule. - priority (int): - For routeRules within a given pathMatcher, - priority determines the order in which load - balancer will interpret routeRules. RouteRules - are evaluated in order of priority, from the - lowest to highest number. The priority of a rule - decreases as its number increases (1, 2, 3, - N+1). The first rule that matches the request is - applied. You cannot configure two or more - routeRules with the same priority. Priority for - each rule must be set to a number between 0 and - 2147483647 inclusive. Priority numbers can have - gaps, which enable you to add or remove rules in - the future without affecting the rest of the - rules. For example, 1, 2, 3, 4, 5, 9, 12, 16 is - a valid series of priority numbers to which you - could add rules numbered from 6 to 8, 10 to 11, - and 13 to 15 in the future without any impact on - existing rules. - route_action (google.cloud.compute_v1.types.HttpRouteAction): - In response to a matching matchRule, the load - balancer performs advanced routing actions like - URL rewrites, header transformations, etc. prior - to forwarding the request to the selected - backend. If routeAction specifies any - weightedBackendServices, service must not be - set. Conversely if service is set, routeAction - cannot contain any weightedBackendServices. - Only one of urlRedirect, service or - routeAction.weightedBackendService must be set. - UrlMaps for external HTTP(S) load balancers - support only the urlRewrite action within a - routeRule's routeAction. - service (str): - The full or partial URL of the backend - service resource to which traffic is directed if - this rule is matched. If routeAction is - additionally specified, advanced routing actions - like URL Rewrites, etc. take effect prior to - sending the request to the backend. However, if - service is specified, routeAction cannot contain - any weightedBackendService s. Conversely, if - routeAction specifies any - weightedBackendServices, service must not be - specified. Only one of urlRedirect, service or - routeAction.weightedBackendService must be set. - url_redirect (google.cloud.compute_v1.types.HttpRedirectAction): - When this rule is matched, the request is - redirected to a URL specified by urlRedirect. If - urlRedirect is specified, service or routeAction - must not be set. Not supported when the URL map - is bound to target gRPC proxy. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_instance (str): + Name of the TargetInstance resource to + delete. + zone (str): + Name of the zone scoping this request. + """ + + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_instance = proto.Field(proto.STRING, number=289769347,) + zone = proto.Field(proto.STRING, number=3744684,) + + +class DeleteTargetPoolRequest(proto.Message): + r"""A request message for TargetPools.Delete. See the method + description for details. + + Attributes: + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_pool (str): + Name of the TargetPool resource to delete. """ - description = proto.Field(proto.STRING, number=422937596, optional=True,) - header_action = proto.Field( - proto.MESSAGE, number=328077352, optional=True, message="HttpHeaderAction", - ) - match_rules = proto.RepeatedField( - proto.MESSAGE, number=376200701, message="HttpRouteRuleMatch", - ) - priority = proto.Field(proto.INT32, number=445151652, optional=True,) - route_action = proto.Field( - proto.MESSAGE, number=424563948, optional=True, message="HttpRouteAction", - ) - service = proto.Field(proto.STRING, number=373540533, optional=True,) - url_redirect = proto.Field( - proto.MESSAGE, number=405147820, optional=True, message="HttpRedirectAction", - ) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_pool = proto.Field(proto.STRING, number=62796298,) -class RawDisk(proto.Message): - r"""The parameters of the raw disk image. +class DeleteTargetSslProxyRequest(proto.Message): + r"""A request message for TargetSslProxies.Delete. See the method + description for details. + Attributes: - container_type (google.cloud.compute_v1.types.RawDisk.ContainerType): - The format used to encode and transmit the - block device, which should be TAR. This is just - a container and transmission format and not a - runtime format. Provided by the client when the - disk image is created. - sha1_checksum (str): - [Deprecated] This field is deprecated. An optional SHA1 - checksum of the disk image before unpackaging provided by - the client when the disk image is created. - source (str): - The full Google Cloud Storage URL where the - disk image is stored. You must provide either - this property or the sourceDisk property but not - both. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_ssl_proxy (str): + Name of the TargetSslProxy resource to + delete. """ - class ContainerType(proto.Enum): - r"""The format used to encode and transmit the block device, - which should be TAR. This is just a container and transmission - format and not a runtime format. Provided by the client when the - disk image is created. - """ - UNDEFINED_CONTAINER_TYPE = 0 - TAR = 82821 + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_ssl_proxy = proto.Field(proto.STRING, number=338795853,) - container_type = proto.Field( - proto.ENUM, number=318809144, optional=True, enum=ContainerType, - ) - sha1_checksum = proto.Field(proto.STRING, number=314444349, optional=True,) - source = proto.Field(proto.STRING, number=177235995, optional=True,) +class DeleteTargetTcpProxyRequest(proto.Message): + r"""A request message for TargetTcpProxies.Delete. See the method + description for details. + + Attributes: + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_tcp_proxy (str): + Name of the TargetTcpProxy resource to + delete. + """ + + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_tcp_proxy = proto.Field(proto.STRING, number=503065442,) -class Image(proto.Message): - r"""Represents an Image resource. - You can use images to create boot disks for your VM instances. For - more information, read Images. (== resource_for - {$api_version}.images ==) +class DeleteTargetVpnGatewayRequest(proto.Message): + r"""A request message for TargetVpnGateways.Delete. See the + method description for details. Attributes: - archive_size_bytes (int): - Size of the image tar.gz archive stored in - Google Cloud Storage (in bytes). - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - deprecated (google.cloud.compute_v1.types.DeprecationStatus): - The deprecation status associated with this - image. - description (str): - An optional description of this resource. - Provide this property when you create the - resource. - disk_size_gb (int): - Size of the image when restored onto a - persistent disk (in GB). - family (str): - The name of the image family to which this - image belongs. You can create disks by - specifying an image family instead of a specific - image name. The image family always returns its - latest image that is not deprecated. The name of - the image family must comply with RFC1035. - guest_os_features (Sequence[google.cloud.compute_v1.types.GuestOsFeature]): - A list of features to enable on the guest - operating system. Applicable only for bootable - images. Read Enabling guest operating system - features to see a list of available options. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - image_encryption_key (google.cloud.compute_v1.types.CustomerEncryptionKey): - Encrypts the image using a customer-supplied - encryption key. - After you encrypt an image with a customer- - supplied key, you must provide the same key if - you use the image later (e.g. to create a disk - from the image). - Customer-supplied encryption keys do not protect - access to metadata of the disk. - If you do not provide an encryption key when - creating the image, then the disk will be - encrypted using an automatically generated key - and you do not need to provide a key to use the - image later. - kind (str): - [Output Only] Type of the resource. Always compute#image for - images. - label_fingerprint (str): - A fingerprint for the labels being applied to - this image, which is essentially a hash of the - labels used for optimistic locking. The - fingerprint is initially generated by Compute - Engine and changes after every request to modify - or update labels. You must always provide an up- - to-date fingerprint hash in order to update or - change labels, otherwise the request will fail - with error 412 conditionNotMet. To see the - latest fingerprint, make a get() request to - retrieve an image. - labels (Sequence[google.cloud.compute_v1.types.Image.LabelsEntry]): - Labels to apply to this image. These can be - later modified by the setLabels method. - license_codes (Sequence[int]): - Integer license codes indicating which - licenses are attached to this image. - licenses (Sequence[str]): - Any applicable license URI. - name (str): - Name of the resource; provided by the client when the - resource is created. The name must be 1-63 characters long, - and comply with RFC1035. Specifically, the name must be 1-63 - characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. - raw_disk (google.cloud.compute_v1.types.RawDisk): - The parameters of the raw disk image. - satisfies_pzs (bool): - [Output Only] Reserved for future use. - self_link (str): - [Output Only] Server-defined URL for the resource. - shielded_instance_initial_state (google.cloud.compute_v1.types.InitialStateConfig): - Set the secure boot keys of shielded - instance. - source_disk (str): - URL of the source disk used to create this - image. This can be a full or valid partial URL. - You must provide either this property or the - rawDisk.source property but not both to create - an image. For example, the following are valid - values: - - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk - - projects/project/zones/zone/disks/disk - - zones/zone/disks/disk - source_disk_encryption_key (google.cloud.compute_v1.types.CustomerEncryptionKey): - The customer-supplied encryption key of the - source disk. Required if the source disk is - protected by a customer-supplied encryption key. - source_disk_id (str): - [Output Only] The ID value of the disk used to create this - image. This value may be used to determine whether the image - was taken from the current or a previous instance of a given - disk name. - source_image (str): - URL of the source image used to create this - image. - In order to create an image, you must provide - the full or partial URL of one of the following: - - The selfLink URL - - This property - - The rawDisk.source URL - - The sourceDisk URL - source_image_encryption_key (google.cloud.compute_v1.types.CustomerEncryptionKey): - The customer-supplied encryption key of the - source image. Required if the source image is - protected by a customer-supplied encryption key. - source_image_id (str): - [Output Only] The ID value of the image used to create this - image. This value may be used to determine whether the image - was taken from the current or a previous instance of a given - image name. - source_snapshot (str): - URL of the source snapshot used to create - this image. - In order to create an image, you must provide - the full or partial URL of one of the following: - - The selfLink URL - - This property - - The sourceImage URL - - The rawDisk.source URL - - The sourceDisk URL - source_snapshot_encryption_key (google.cloud.compute_v1.types.CustomerEncryptionKey): - The customer-supplied encryption key of the - source snapshot. Required if the source snapshot - is protected by a customer-supplied encryption - key. - source_snapshot_id (str): - [Output Only] The ID value of the snapshot used to create - this image. This value may be used to determine whether the - snapshot was taken from the current or a previous instance - of a given snapshot name. - source_type (google.cloud.compute_v1.types.Image.SourceType): - The type of the image used to create this - disk. The default and only value is RAW - status (google.cloud.compute_v1.types.Image.Status): - [Output Only] The status of the image. An image can be used - to create other resources, such as instances, only after the - image has been successfully created and the status is set to - READY. Possible values are FAILED, PENDING, or READY. - storage_locations (Sequence[str]): - Cloud Storage bucket storage location of the - image (regional or multi-regional). + project (str): + Project ID for this request. + region (str): + Name of the region for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_vpn_gateway (str): + Name of the target VPN gateway to delete. """ - class SourceType(proto.Enum): - r"""The type of the image used to create this disk. The default - and only value is RAW - """ - UNDEFINED_SOURCE_TYPE = 0 - RAW = 80904 + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_vpn_gateway = proto.Field(proto.STRING, number=532512843,) - class Status(proto.Enum): - r"""[Output Only] The status of the image. An image can be used to - create other resources, such as instances, only after the image has - been successfully created and the status is set to READY. Possible - values are FAILED, PENDING, or READY. - """ - UNDEFINED_STATUS = 0 - DELETING = 528602024 - FAILED = 455706685 - PENDING = 35394935 - READY = 77848963 - archive_size_bytes = proto.Field(proto.INT64, number=381093450, optional=True,) - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - deprecated = proto.Field( - proto.MESSAGE, number=515138995, optional=True, message="DeprecationStatus", - ) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - disk_size_gb = proto.Field(proto.INT64, number=316263735, optional=True,) - family = proto.Field(proto.STRING, number=328751972, optional=True,) - guest_os_features = proto.RepeatedField( - proto.MESSAGE, number=79294545, message="GuestOsFeature", - ) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - image_encryption_key = proto.Field( - proto.MESSAGE, number=379512583, optional=True, message="CustomerEncryptionKey", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - label_fingerprint = proto.Field(proto.STRING, number=178124825, optional=True,) - labels = proto.MapField(proto.STRING, proto.STRING, number=500195327,) - license_codes = proto.RepeatedField(proto.INT64, number=45482664,) - licenses = proto.RepeatedField(proto.STRING, number=337642578,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - raw_disk = proto.Field( - proto.MESSAGE, number=503113556, optional=True, message="RawDisk", - ) - satisfies_pzs = proto.Field(proto.BOOL, number=480964267, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - shielded_instance_initial_state = proto.Field( - proto.MESSAGE, number=192356867, optional=True, message="InitialStateConfig", - ) - source_disk = proto.Field(proto.STRING, number=451753793, optional=True,) - source_disk_encryption_key = proto.Field( - proto.MESSAGE, number=531501153, optional=True, message="CustomerEncryptionKey", - ) - source_disk_id = proto.Field(proto.STRING, number=454190809, optional=True,) - source_image = proto.Field(proto.STRING, number=50443319, optional=True,) - source_image_encryption_key = proto.Field( - proto.MESSAGE, number=381503659, optional=True, message="CustomerEncryptionKey", - ) - source_image_id = proto.Field(proto.STRING, number=55328291, optional=True,) - source_snapshot = proto.Field(proto.STRING, number=126061928, optional=True,) - source_snapshot_encryption_key = proto.Field( - proto.MESSAGE, number=303679322, optional=True, message="CustomerEncryptionKey", - ) - source_snapshot_id = proto.Field(proto.STRING, number=98962258, optional=True,) - source_type = proto.Field( - proto.ENUM, number=452245726, optional=True, enum=SourceType, - ) - status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) - storage_locations = proto.RepeatedField(proto.STRING, number=328005274,) +class DeleteUrlMapRequest(proto.Message): + r"""A request message for UrlMaps.Delete. See the method + description for details. + + Attributes: + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + url_map (str): + Name of the UrlMap resource to delete. + """ + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + url_map = proto.Field(proto.STRING, number=367020684,) + + +class DeleteVpnGatewayRequest(proto.Message): + r"""A request message for VpnGateways.Delete. See the method + description for details. -class ImageList(proto.Message): - r"""Contains a list of images. Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.Image]): - A list of Image resources. - kind (str): - Type of resource. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + project (str): + Project ID for this request. + region (str): + Name of the region for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + vpn_gateway (str): + Name of the VPN gateway to delete. """ - @property - def raw_page(self): - return self + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + vpn_gateway = proto.Field(proto.STRING, number=406684153,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Image",) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) +class DeleteVpnTunnelRequest(proto.Message): + r"""A request message for VpnTunnels.Delete. See the method + description for details. -class Metadata(proto.Message): - r"""A metadata key/value entry. Attributes: - fingerprint (str): - Specifies a fingerprint for this request, - which is essentially a hash of the metadata's - contents and used for optimistic locking. The - fingerprint is initially generated by Compute - Engine and changes after every request to modify - or update metadata. You must always provide an - up-to-date fingerprint hash in order to update - or change metadata, otherwise the request will - fail with error 412 conditionNotMet. To see the - latest fingerprint, make a get() request to - retrieve the resource. - items (Sequence[google.cloud.compute_v1.types.Items]): - Array of key/value pairs. The total size of - all keys and values must be less than 512 KB. - kind (str): - [Output Only] Type of the resource. Always compute#metadata - for metadata. + project (str): + Project ID for this request. + region (str): + Name of the region for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + vpn_tunnel (str): + Name of the VpnTunnel resource to delete. """ - fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Items",) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + vpn_tunnel = proto.Field(proto.STRING, number=143821331,) -class NetworkInterface(proto.Message): - r"""A network interface resource attached to an instance. +class DeleteZoneOperationRequest(proto.Message): + r"""A request message for ZoneOperations.Delete. See the method + description for details. + Attributes: - access_configs (Sequence[google.cloud.compute_v1.types.AccessConfig]): - An array of configurations for this interface. Currently, - only one access config, ONE_TO_ONE_NAT, is supported. If - there are no accessConfigs specified, then this instance - will have no external internet access. - alias_ip_ranges (Sequence[google.cloud.compute_v1.types.AliasIpRange]): - An array of alias IP ranges for this network - interface. You can only specify this field for - network interfaces in VPC networks. - fingerprint (str): - Fingerprint hash of contents stored in this - network interface. This field will be ignored - when inserting an Instance or adding a - NetworkInterface. An up-to-date fingerprint must - be provided in order to update the - NetworkInterface. The request will fail with - error 400 Bad Request if the fingerprint is not - provided, or 412 Precondition Failed if the - fingerprint is out of date. - ipv6_address (str): - [Output Only] An IPv6 internal network address for this - network interface. - kind (str): - [Output Only] Type of the resource. Always - compute#networkInterface for network interfaces. - name (str): - [Output Only] The name of the network interface, which is - generated by the server. For network devices, these are - eth0, eth1, etc. - network (str): - URL of the network resource for this - instance. When creating an instance, if neither - the network nor the subnetwork is specified, the - default network global/networks/default is used; - if the network is not specified but the - subnetwork is specified, the network is - inferred. If you specify this property, you can - specify the network as a full or partial URL. - For example, the following are all valid URLs: - - https://www.googleapis.com/compute/v1/projects/project/global/networks/network - - projects/project/global/networks/network - - global/networks/default - network_i_p (str): - An IPv4 internal IP address to assign to the - instance for this network interface. If not - specified by the user, an unused internal IP is - assigned by the system. - nic_type (google.cloud.compute_v1.types.NetworkInterface.NicType): - The type of vNIC to be used on this - interface. This may be gVNIC or VirtioNet. - subnetwork (str): - The URL of the Subnetwork resource for this - instance. If the network resource is in legacy - mode, do not specify this field. If the network - is in auto subnet mode, specifying the - subnetwork is optional. If the network is in - custom subnet mode, specifying the subnetwork is - required. If you specify this field, you can - specify the subnetwork as a full or partial URL. - For example, the following are all valid URLs: - - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork - - regions/region/subnetworks/subnetwork + operation (str): + Name of the Operations resource to delete. + project (str): + Project ID for this request. + zone (str): + Name of the zone for this request. """ - class NicType(proto.Enum): - r"""The type of vNIC to be used on this interface. This may be - gVNIC or VirtioNet. - """ - UNDEFINED_NIC_TYPE = 0 - GVNIC = 68209305 - UNSPECIFIED_NIC_TYPE = 67411801 - VIRTIO_NET = 452123481 + operation = proto.Field(proto.STRING, number=52090215,) + project = proto.Field(proto.STRING, number=227560217,) + zone = proto.Field(proto.STRING, number=3744684,) - access_configs = proto.RepeatedField( - proto.MESSAGE, number=111058326, message="AccessConfig", - ) - alias_ip_ranges = proto.RepeatedField( - proto.MESSAGE, number=165085631, message="AliasIpRange", - ) - fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) - ipv6_address = proto.Field(proto.STRING, number=341563804, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - network = proto.Field(proto.STRING, number=232872494, optional=True,) - network_i_p = proto.Field(proto.STRING, number=207181961, optional=True,) - nic_type = proto.Field(proto.ENUM, number=59810577, optional=True, enum=NicType,) - subnetwork = proto.Field(proto.STRING, number=307827694, optional=True,) +class DeleteZoneOperationResponse(proto.Message): + r"""A response message for ZoneOperations.Delete. See the method + description for details. + """ -class ReservationAffinity(proto.Message): - r"""Specifies the reservations that this instance can consume - from. +class Denied(proto.Message): + r""" Attributes: - consume_reservation_type (google.cloud.compute_v1.types.ReservationAffinity.ConsumeReservationType): - Specifies the type of reservation from which this instance - can consume resources: ANY_RESERVATION (default), - SPECIFIC_RESERVATION, or NO_RESERVATION. See Consuming - reserved instances for examples. - key (str): - Corresponds to the label key of a reservation resource. To - target a SPECIFIC_RESERVATION by name, specify - googleapis.com/reservation-name as the key and specify the - name of your reservation as its value. - values (Sequence[str]): - Corresponds to the label values of a - reservation resource. + I_p_protocol (str): + The IP protocol to which this rule applies. + The protocol type is required when creating a + firewall rule. This value can either be one of + the following well known protocol strings (tcp, + udp, icmp, esp, ah, ipip, sctp) or the IP + protocol number. + ports (Sequence[str]): + An optional list of ports to which this rule applies. This + field is only applicable for the UDP or TCP protocol. Each + entry must be either an integer or a range. If not + specified, this rule applies to connections through any + port. Example inputs include: ["22"], ["80","443"], and + ["12345-12349"]. """ - class ConsumeReservationType(proto.Enum): - r"""Specifies the type of reservation from which this instance can - consume resources: ANY_RESERVATION (default), SPECIFIC_RESERVATION, - or NO_RESERVATION. See Consuming reserved instances for examples. - """ - UNDEFINED_CONSUME_RESERVATION_TYPE = 0 - ANY_RESERVATION = 200008121 - NO_RESERVATION = 169322030 - SPECIFIC_RESERVATION = 229889055 - UNSPECIFIED = 526786327 + I_p_protocol = proto.Field(proto.STRING, number=488094525, optional=True,) + ports = proto.RepeatedField(proto.STRING, number=106854418,) - consume_reservation_type = proto.Field( - proto.ENUM, number=300736944, optional=True, enum=ConsumeReservationType, + +class DeprecateImageRequest(proto.Message): + r"""A request message for Images.Deprecate. See the method + description for details. + + Attributes: + deprecation_status_resource (google.cloud.compute_v1.types.DeprecationStatus): + The body resource for this request + image (str): + Image name. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + """ + + deprecation_status_resource = proto.Field( + proto.MESSAGE, number=333006064, message="DeprecationStatus", ) - key = proto.Field(proto.STRING, number=106079, optional=True,) - values = proto.RepeatedField(proto.STRING, number=249928994,) + image = proto.Field(proto.STRING, number=100313435,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class Scheduling(proto.Message): - r"""Sets the scheduling options for an Instance. NextID: 20 +class DeprecationStatus(proto.Message): + r"""Deprecation status for a public resource. Attributes: - automatic_restart (bool): - Specifies whether the instance should be - automatically restarted if it is terminated by - Compute Engine (not terminated by a user). You - can only set the automatic restart option for - standard instances. Preemptible instances cannot - be automatically restarted. By default, this is - set to true so an instance is automatically - restarted if it is terminated by Compute Engine. - location_hint (str): - An opaque location hint used to place the - instance close to other resources. This field is - for use by internal tools that use the public - API. - min_node_cpus (int): - The minimum number of virtual CPUs this - instance will consume when running on a sole- - tenant node. - node_affinities (Sequence[google.cloud.compute_v1.types.SchedulingNodeAffinity]): - A set of node affinity and anti-affinity - configurations. Refer to Configuring node - affinity for more information. Overrides - reservationAffinity. - on_host_maintenance (google.cloud.compute_v1.types.Scheduling.OnHostMaintenance): - Defines the maintenance behavior for this - instance. For standard instances, the default - behavior is MIGRATE. For preemptible instances, - the default and only possible behavior is - TERMINATE. For more information, see Setting - Instance Scheduling Options. - preemptible (bool): - Defines whether the instance is preemptible. This can only - be set during instance creation or while the instance is - stopped and therefore, in a ``TERMINATED`` state. See - Instance Life Cycle for more information on the possible - instance states. + deleted (str): + An optional RFC3339 timestamp on or after + which the state of this resource is intended to + change to DELETED. This is only informational + and the status will not change unless the client + explicitly changes it. + deprecated (str): + An optional RFC3339 timestamp on or after + which the state of this resource is intended to + change to DEPRECATED. This is only informational + and the status will not change unless the client + explicitly changes it. + obsolete (str): + An optional RFC3339 timestamp on or after + which the state of this resource is intended to + change to OBSOLETE. This is only informational + and the status will not change unless the client + explicitly changes it. + replacement (str): + The URL of the suggested replacement for a + deprecated resource. The suggested replacement + resource must be the same kind of resource as + the deprecated resource. + state (google.cloud.compute_v1.types.DeprecationStatus.State): + The deprecation state of this resource. This + can be ACTIVE, DEPRECATED, OBSOLETE, or DELETED. + Operations which communicate the end of life + date for an image, can use ACTIVE. Operations + which create a new resource using a DEPRECATED + resource will return successfully, but with a + warning indicating the deprecated resource and + recommending its replacement. Operations which + use OBSOLETE or DELETED resources will be + rejected and result in an error. """ - class OnHostMaintenance(proto.Enum): - r"""Defines the maintenance behavior for this instance. For - standard instances, the default behavior is MIGRATE. For - preemptible instances, the default and only possible behavior is - TERMINATE. For more information, see Setting Instance Scheduling - Options. + class State(proto.Enum): + r"""The deprecation state of this resource. This can be ACTIVE, + DEPRECATED, OBSOLETE, or DELETED. Operations which communicate + the end of life date for an image, can use ACTIVE. Operations + which create a new resource using a DEPRECATED resource will + return successfully, but with a warning indicating the + deprecated resource and recommending its replacement. Operations + which use OBSOLETE or DELETED resources will be rejected and + result in an error. """ - UNDEFINED_ON_HOST_MAINTENANCE = 0 - MIGRATE = 165699979 - TERMINATE = 527617601 + UNDEFINED_STATE = 0 + ACTIVE = 314733318 + DELETED = 120962041 + DEPRECATED = 463360435 + OBSOLETE = 66532761 - automatic_restart = proto.Field(proto.BOOL, number=350821371, optional=True,) - location_hint = proto.Field(proto.STRING, number=350519505, optional=True,) - min_node_cpus = proto.Field(proto.INT32, number=317231675, optional=True,) - node_affinities = proto.RepeatedField( - proto.MESSAGE, number=461799971, message="SchedulingNodeAffinity", - ) - on_host_maintenance = proto.Field( - proto.ENUM, number=64616796, optional=True, enum=OnHostMaintenance, - ) - preemptible = proto.Field(proto.BOOL, number=324203169, optional=True,) + deleted = proto.Field(proto.STRING, number=476721177, optional=True,) + deprecated = proto.Field(proto.STRING, number=515138995, optional=True,) + obsolete = proto.Field(proto.STRING, number=357647769, optional=True,) + replacement = proto.Field(proto.STRING, number=430919186, optional=True,) + state = proto.Field(proto.ENUM, number=109757585, optional=True, enum=State,) -class ServiceAccount(proto.Message): - r"""A service account. +class DetachDiskInstanceRequest(proto.Message): + r"""A request message for Instances.DetachDisk. See the method + description for details. + Attributes: - email (str): - Email address of the service account. - scopes (Sequence[str]): - The list of scopes to be made available for - this service account. + device_name (str): + The device name of the disk to detach. Make a + get() request on the instance to view currently + attached disks and device names. + instance (str): + Instance name for this request. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. """ - email = proto.Field(proto.STRING, number=96619420, optional=True,) - scopes = proto.RepeatedField(proto.STRING, number=165973151,) + device_name = proto.Field(proto.STRING, number=67541716,) + instance = proto.Field(proto.STRING, number=18257045,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class ShieldedInstanceConfig(proto.Message): - r"""A set of Shielded Instance options. +class DetachNetworkEndpointsGlobalNetworkEndpointGroupRequest(proto.Message): + r"""A request message for + GlobalNetworkEndpointGroups.DetachNetworkEndpoints. See the + method description for details. + Attributes: - enable_integrity_monitoring (bool): - Defines whether the instance has integrity - monitoring enabled. Enabled by default. - enable_secure_boot (bool): - Defines whether the instance has Secure Boot - enabled. Disabled by default. - enable_vtpm (bool): - Defines whether the instance has the vTPM - enabled. Enabled by default. + global_network_endpoint_groups_detach_endpoints_request_resource (google.cloud.compute_v1.types.GlobalNetworkEndpointGroupsDetachEndpointsRequest): + The body resource for this request + network_endpoint_group (str): + The name of the network endpoint group where + you are removing network endpoints. It should + comply with RFC1035. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - enable_integrity_monitoring = proto.Field( - proto.BOOL, number=409071030, optional=True, + global_network_endpoint_groups_detach_endpoints_request_resource = proto.Field( + proto.MESSAGE, + number=8898269, + message="GlobalNetworkEndpointGroupsDetachEndpointsRequest", ) - enable_secure_boot = proto.Field(proto.BOOL, number=123568638, optional=True,) - enable_vtpm = proto.Field(proto.BOOL, number=181858935, optional=True,) + network_endpoint_group = proto.Field(proto.STRING, number=433907078,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class ShieldedInstanceIntegrityPolicy(proto.Message): - r"""The policy describes the baseline against which Instance boot - integrity is measured. +class DetachNetworkEndpointsNetworkEndpointGroupRequest(proto.Message): + r"""A request message for + NetworkEndpointGroups.DetachNetworkEndpoints. See the method + description for details. Attributes: - update_auto_learn_policy (bool): - Updates the integrity policy baseline using - the measurements from the VM instance's most - recent boot. + network_endpoint_group (str): + The name of the network endpoint group where + you are removing network endpoints. It should + comply with RFC1035. + network_endpoint_groups_detach_endpoints_request_resource (google.cloud.compute_v1.types.NetworkEndpointGroupsDetachEndpointsRequest): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone where the network + endpoint group is located. It should comply with + RFC1035. """ - update_auto_learn_policy = proto.Field(proto.BOOL, number=245490215, optional=True,) + network_endpoint_group = proto.Field(proto.STRING, number=433907078,) + network_endpoint_groups_detach_endpoints_request_resource = proto.Field( + proto.MESSAGE, + number=515608697, + message="NetworkEndpointGroupsDetachEndpointsRequest", + ) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class Tags(proto.Message): - r"""A set of instance tags. +class DisableXpnHostProjectRequest(proto.Message): + r"""A request message for Projects.DisableXpnHost. See the method + description for details. + Attributes: - fingerprint (str): - Specifies a fingerprint for this request, - which is essentially a hash of the tags' - contents and used for optimistic locking. The - fingerprint is initially generated by Compute - Engine and changes after every request to modify - or update tags. You must always provide an up- - to-date fingerprint hash in order to update or - change tags. To see the latest fingerprint, - make get() request to the instance. - items (Sequence[str]): - An array of tags. Each tag must be 1-63 - characters long, and comply with RFC1035. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) - items = proto.RepeatedField(proto.STRING, number=100526016,) - + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class Instance(proto.Message): - r"""Represents an Instance resource. - An instance is a virtual machine that is hosted on Google Cloud - Platform. For more information, read Virtual Machine Instances. (== - resource_for {$api_version}.instances ==) +class DisableXpnResourceProjectRequest(proto.Message): + r"""A request message for Projects.DisableXpnResource. See the + method description for details. Attributes: - advanced_machine_features (google.cloud.compute_v1.types.AdvancedMachineFeatures): - Controls for advanced machine-related - behavior features. - can_ip_forward (bool): - Allows this instance to send and receive - packets with non-matching destination or source - IPs. This is required if you plan to use this - instance to forward routes. For more - information, see Enabling IP Forwarding. - confidential_instance_config (google.cloud.compute_v1.types.ConfidentialInstanceConfig): + project (str): + Project ID for this request. + projects_disable_xpn_resource_request_resource (google.cloud.compute_v1.types.ProjectsDisableXpnResourceRequest): + The body resource for this request + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + """ - cpu_platform (str): - [Output Only] The CPU platform used by this instance. + project = proto.Field(proto.STRING, number=227560217,) + projects_disable_xpn_resource_request_resource = proto.Field( + proto.MESSAGE, number=209136170, message="ProjectsDisableXpnResourceRequest", + ) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + + +class Disk(proto.Message): + r"""Represents a Persistent Disk resource. Google Compute Engine has two + Disk resources: \* `Zonal `__ + \* `Regional `__ + Persistent disks are required for running your VM instances. Create + both boot and non-boot (data) persistent disks. For more + information, read Persistent Disks. For more storage options, read + Storage options. The disks resource represents a zonal persistent + disk. For more information, read Zonal persistent disks. The + regionDisks resource represents a regional persistent disk. For more + information, read Regional resources. + + Attributes: creation_timestamp (str): [Output Only] Creation timestamp in RFC3339 text format. - deletion_protection (bool): - Whether the resource should be protected - against deletion. description (str): An optional description of this resource. Provide this property when you create the resource. - disks (Sequence[google.cloud.compute_v1.types.AttachedDisk]): - Array of disks associated with this instance. - Persistent disks must be created before you can - assign them. - display_device (google.cloud.compute_v1.types.DisplayDevice): - Enables display device for the instance. - fingerprint (str): - Specifies a fingerprint for this resource, - which is essentially a hash of the instance's - contents and used for optimistic locking. The - fingerprint is initially generated by Compute - Engine and changes after every request to modify - or update the instance. You must always provide - an up-to-date fingerprint hash in order to - update the instance. To see the latest - fingerprint, make get() request to the instance. - guest_accelerators (Sequence[google.cloud.compute_v1.types.AcceleratorConfig]): - A list of the type and count of accelerator - cards attached to the instance. - hostname (str): - Specifies the hostname of the instance. The specified - hostname must be RFC1035 compliant. If hostname is not - specified, the default hostname is - [INSTANCE_NAME].c.[PROJECT_ID].internal when using the - global DNS, and - [INSTANCE_NAME].[ZONE].c.[PROJECT_ID].internal when using - zonal DNS. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - kind (str): - [Output Only] Type of the resource. Always compute#instance - for instances. - label_fingerprint (str): - A fingerprint for this request, which is - essentially a hash of the label's contents and - used for optimistic locking. The fingerprint is - initially generated by Compute Engine and - changes after every request to modify or update - labels. You must always provide an up-to-date - fingerprint hash in order to update or change - labels. To see the latest fingerprint, make - get() request to the instance. - labels (Sequence[google.cloud.compute_v1.types.Instance.LabelsEntry]): - Labels to apply to this instance. These can - be later modified by the setLabels method. - last_start_timestamp (str): - [Output Only] Last start timestamp in RFC3339 text format. - last_stop_timestamp (str): - [Output Only] Last stop timestamp in RFC3339 text format. - last_suspended_timestamp (str): - [Output Only] Last suspended timestamp in RFC3339 text - format. - machine_type (str): - Full or partial URL of the machine type - resource to use for this instance, in the - format: zones/zone/machineTypes/machine-type. - This is provided by the client when the instance - is created. For example, the following is a - valid partial url to a predefined machine type: - zones/us-central1-f/machineTypes/n1-standard-1 - - To create a custom machine type, provide a URL - to a machine type in the following format, where - CPUS is 1 or an even number up to 32 (2, 4, 6, - ... 24, etc), and MEMORY is the total memory for - this instance. Memory must be a multiple of 256 - MB and must be supplied in MB (e.g. 5 GB of - memory is 5120 MB): - zones/zone/machineTypes/custom-CPUS-MEMORY - - For example: zones/us- - central1-f/machineTypes/custom-4-5120 - For a full list of restrictions, read the - Specifications for custom machine types. - metadata (google.cloud.compute_v1.types.Metadata): - The metadata key/value pairs assigned to this - instance. This includes custom metadata and - predefined keys. - min_cpu_platform (str): - Specifies a minimum CPU platform for the VM - instance. Applicable values are the friendly - names of CPU platforms, such as minCpuPlatform: - "Intel Haswell" or minCpuPlatform: "Intel Sandy - Bridge". + disk_encryption_key (google.cloud.compute_v1.types.CustomerEncryptionKey): + Encrypts the disk using a customer-supplied encryption key + or a customer-managed encryption key. Encryption keys do not + protect access to metadata of the disk. After you encrypt a + disk with a customer-supplied key, you must provide the same + key if you use the disk later. For example, to create a disk + snapshot, to create a disk image, to create a machine image, + or to attach the disk to a virtual machine. After you + encrypt a disk with a customer-managed key, the + diskEncryptionKey.kmsKeyName is set to a key *version* name + once the disk is created. The disk is encrypted with this + version of the key. In the response, + diskEncryptionKey.kmsKeyName appears in the following + format: "diskEncryptionKey.kmsKeyName": + "projects/kms_project_id/locations/region/keyRings/ + key_region/cryptoKeys/key /cryptoKeysVersions/version If you + do not provide an encryption key when creating the disk, + then the disk is encrypted using an automatically generated + key and you don't need to provide a key to use the disk + later. + guest_os_features (Sequence[google.cloud.compute_v1.types.GuestOsFeature]): + A list of features to enable on the guest + operating system. Applicable only for bootable + images. Read Enabling guest operating system + features to see a list of available options. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + kind (str): + [Output Only] Type of the resource. Always compute#disk for + disks. + label_fingerprint (str): + A fingerprint for the labels being applied to + this disk, which is essentially a hash of the + labels set used for optimistic locking. The + fingerprint is initially generated by Compute + Engine and changes after every request to modify + or update labels. You must always provide an up- + to-date fingerprint hash in order to update or + change labels, otherwise the request will fail + with error 412 conditionNotMet. To see the + latest fingerprint, make a get() request to + retrieve a disk. + labels (Sequence[google.cloud.compute_v1.types.Disk.LabelsEntry]): + Labels to apply to this disk. These can be + later modified by the setLabels method. + last_attach_timestamp (str): + [Output Only] Last attach timestamp in RFC3339 text format. + last_detach_timestamp (str): + [Output Only] Last detach timestamp in RFC3339 text format. + license_codes (Sequence[int]): + Integer license codes indicating which + licenses are attached to this disk. + licenses (Sequence[str]): + A list of publicly visible licenses. Reserved + for Google's use. + location_hint (str): + An opaque location hint used to place the + disk close to other resources. This field is for + use by internal tools that use the public API. name (str): - The name of the resource, provided by the client when - initially creating the resource. The resource name must be - 1-63 characters long, and comply with RFC1035. Specifically, - the name must be 1-63 characters long and match the regular - expression ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the - first character must be a lowercase letter, and all - following characters must be a dash, lowercase letter, or - digit, except the last character, which cannot be a dash. - network_interfaces (Sequence[google.cloud.compute_v1.types.NetworkInterface]): - An array of network configurations for this - instance. These specify how interfaces are - configured to interact with other network - services, such as connecting to the internet. - Multiple interfaces are supported per instance. - private_ipv6_google_access (google.cloud.compute_v1.types.Instance.PrivateIpv6GoogleAccess): - The private IPv6 google access type for the VM. If not - specified, use INHERIT_FROM_SUBNETWORK as default. - reservation_affinity (google.cloud.compute_v1.types.ReservationAffinity): - Specifies the reservations that this instance - can consume from. + Name of the resource. Provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. + options (str): + Internal use only. + physical_block_size_bytes (int): + Physical block size of the persistent disk, + in bytes. If not present in a request, a default + value is used. The currently supported size is + 4096, other sizes may be added in the future. If + an unsupported value is requested, the error + message will list the supported values for the + caller's project. + provisioned_iops (int): + Indicates how many IOPS to provision for the + disk. This sets the number of I/O operations per + second that the disk can handle. Values must be + between 10,000 and 120,000. For more details, + see the Extreme persistent disk documentation. + region (str): + [Output Only] URL of the region where the disk resides. Only + applicable for regional resources. You must specify this + field as part of the HTTP request URL. It is not settable as + a field in the request body. + replica_zones (Sequence[str]): + URLs of the zones where the disk should be + replicated to. Only applicable for regional + resources. resource_policies (Sequence[str]): - Resource policies applied to this instance. + Resource policies applied to this disk for + automatic snapshot creations. satisfies_pzs (bool): [Output Only] Reserved for future use. - scheduling (google.cloud.compute_v1.types.Scheduling): - Sets the scheduling options for this - instance. self_link (str): - [Output Only] Server-defined URL for this resource. - service_accounts (Sequence[google.cloud.compute_v1.types.ServiceAccount]): - A list of service accounts, with their - specified scopes, authorized for this instance. - Only one service account per VM instance is - supported. Service accounts generate access - tokens that can be accessed through the metadata - server and used to authenticate applications on - the instance. See Service Accounts for more - information. - shielded_instance_config (google.cloud.compute_v1.types.ShieldedInstanceConfig): - - shielded_instance_integrity_policy (google.cloud.compute_v1.types.ShieldedInstanceIntegrityPolicy): - - start_restricted (bool): - [Output Only] Whether a VM has been restricted for start - because Compute Engine has detected suspicious activity. - status (google.cloud.compute_v1.types.Instance.Status): - [Output Only] The status of the instance. One of the - following values: PROVISIONING, STAGING, RUNNING, STOPPING, - SUSPENDING, SUSPENDED, REPAIRING, and TERMINATED. For more - information about the status of the instance, see Instance - life cycle. - status_message (str): - [Output Only] An optional, human-readable explanation of the - status. - tags (google.cloud.compute_v1.types.Tags): - Tags to apply to this instance. Tags are used - to identify valid sources or targets for network - firewalls and are specified by the client during - instance creation. The tags can be later - modified by the setTags method. Each tag within - the list must comply with RFC1035. Multiple tags - can be specified via the 'tags.items' field. + [Output Only] Server-defined fully-qualified URL for this + resource. + size_gb (int): + Size, in GB, of the persistent disk. You can + specify this field when creating a persistent + disk using the sourceImage, sourceSnapshot, or + sourceDisk parameter, or specify it alone to + create an empty persistent disk. If you specify + this field along with a source, the value of + sizeGb must not be less than the size of the + source. Acceptable values are 1 to 65536, + inclusive. + source_disk (str): + The source disk used to create this disk. You + can provide this as a partial or full URL to the + resource. For example, the following are valid + values: - + https://www.googleapis.com/compute/v1/projects/project/zones/zone + /disks/disk - + https://www.googleapis.com/compute/v1/projects/project/regions/region + /disks/disk - + projects/project/zones/zone/disks/disk - + projects/project/regions/region/disks/disk - + zones/zone/disks/disk - + regions/region/disks/disk + source_disk_id (str): + [Output Only] The unique ID of the disk used to create this + disk. This value identifies the exact disk that was used to + create this persistent disk. For example, if you created the + persistent disk from a disk that was later deleted and + recreated under the same name, the source disk ID would + identify the exact version of the disk that was used. + source_image (str): + The source image used to create this disk. If + the source image is deleted, this field will not + be set. To create a disk with one of the public + operating system images, specify the image by + its family name. For example, specify + family/debian-9 to use the latest Debian 9 + image: projects/debian- + cloud/global/images/family/debian-9 + Alternatively, use a specific version of a + public operating system image: projects/debian- + cloud/global/images/debian-9-stretch-vYYYYMMDD + To create a disk with a custom image that you + created, specify the image name in the following + format: global/images/my-custom-image You can + also specify a custom image by its image family, + which returns the latest version of the image in + that family. Replace the image name with + family/family-name: global/images/family/my- + image-family + source_image_encryption_key (google.cloud.compute_v1.types.CustomerEncryptionKey): + The customer-supplied encryption key of the + source image. Required if the source image is + protected by a customer-supplied encryption key. + source_image_id (str): + [Output Only] The ID value of the image used to create this + disk. This value identifies the exact image that was used to + create this persistent disk. For example, if you created the + persistent disk from an image that was later deleted and + recreated under the same name, the source image ID would + identify the exact version of the image that was used. + source_snapshot (str): + The source snapshot used to create this disk. + You can provide this as a partial or full URL to + the resource. For example, the following are + valid values: - + https://www.googleapis.com/compute/v1/projects/project + /global/snapshots/snapshot - + projects/project/global/snapshots/snapshot - + global/snapshots/snapshot + source_snapshot_encryption_key (google.cloud.compute_v1.types.CustomerEncryptionKey): + The customer-supplied encryption key of the + source snapshot. Required if the source snapshot + is protected by a customer-supplied encryption + key. + source_snapshot_id (str): + [Output Only] The unique ID of the snapshot used to create + this disk. This value identifies the exact snapshot that was + used to create this persistent disk. For example, if you + created the persistent disk from a snapshot that was later + deleted and recreated under the same name, the source + snapshot ID would identify the exact version of the snapshot + that was used. + source_storage_object (str): + The full Google Cloud Storage URI where the + disk image is stored. This file must be a gzip- + compressed tarball whose name ends in .tar.gz or + virtual machine disk whose name ends in vmdk. + Valid URIs may start with gs:// or + https://storage.googleapis.com/. This flag is + not optimized for creating multiple disks from a + source storage object. To create many disks from + a source storage object, use gcloud compute + images import instead. + status (google.cloud.compute_v1.types.Disk.Status): + [Output Only] The status of disk creation. - CREATING: Disk + is provisioning. - RESTORING: Source data is being copied + into the disk. - FAILED: Disk creation failed. - READY: Disk + is ready for use. - DELETING: Disk is deleting. + type_ (str): + URL of the disk type resource describing + which disk type to use to create the disk. + Provide this when creating the disk. For + example: projects/project + /zones/zone/diskTypes/pd-ssd . See Persistent + disk types. + users (Sequence[str]): + [Output Only] Links to the users of the disk (attached + instances) in form: + projects/project/zones/zone/instances/instance zone (str): - [Output Only] URL of the zone where the instance resides. - You must specify this field as part of the HTTP request URL. - It is not settable as a field in the request body. + [Output Only] URL of the zone where the disk resides. You + must specify this field as part of the HTTP request URL. It + is not settable as a field in the request body. """ - class PrivateIpv6GoogleAccess(proto.Enum): - r"""The private IPv6 google access type for the VM. If not specified, - use INHERIT_FROM_SUBNETWORK as default. - """ - UNDEFINED_PRIVATE_IPV6_GOOGLE_ACCESS = 0 - ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE = 427975994 - ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE = 288210263 - INHERIT_FROM_SUBNETWORK = 530256959 - class Status(proto.Enum): - r"""[Output Only] The status of the instance. One of the following - values: PROVISIONING, STAGING, RUNNING, STOPPING, SUSPENDING, - SUSPENDED, REPAIRING, and TERMINATED. For more information about the - status of the instance, see Instance life cycle. + r"""[Output Only] The status of disk creation. - CREATING: Disk is + provisioning. - RESTORING: Source data is being copied into the + disk. - FAILED: Disk creation failed. - READY: Disk is ready for + use. - DELETING: Disk is deleting. """ UNDEFINED_STATUS = 0 - DEPROVISIONING = 428935662 - PROVISIONING = 290896621 - REPAIRING = 413483285 - RUNNING = 121282975 - STAGING = 431072283 - STOPPED = 444276141 - STOPPING = 350791796 - SUSPENDED = 51223995 - SUSPENDING = 514206246 - TERMINATED = 250018339 + CREATING = 455564985 + DELETING = 528602024 + FAILED = 455706685 + READY = 77848963 + RESTORING = 404263851 - advanced_machine_features = proto.Field( - proto.MESSAGE, - number=409646002, - optional=True, - message="AdvancedMachineFeatures", - ) - can_ip_forward = proto.Field(proto.BOOL, number=467731324, optional=True,) - confidential_instance_config = proto.Field( - proto.MESSAGE, - number=490637685, - optional=True, - message="ConfidentialInstanceConfig", - ) - cpu_platform = proto.Field(proto.STRING, number=410285354, optional=True,) creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - deletion_protection = proto.Field(proto.BOOL, number=458014698, optional=True,) description = proto.Field(proto.STRING, number=422937596, optional=True,) - disks = proto.RepeatedField(proto.MESSAGE, number=95594102, message="AttachedDisk",) - display_device = proto.Field( - proto.MESSAGE, number=258933875, optional=True, message="DisplayDevice", + disk_encryption_key = proto.Field( + proto.MESSAGE, number=271660677, optional=True, message="CustomerEncryptionKey", ) - fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) - guest_accelerators = proto.RepeatedField( - proto.MESSAGE, number=463595119, message="AcceleratorConfig", + guest_os_features = proto.RepeatedField( + proto.MESSAGE, number=79294545, message="GuestOsFeature", ) - hostname = proto.Field(proto.STRING, number=237067315, optional=True,) id = proto.Field(proto.UINT64, number=3355, optional=True,) kind = proto.Field(proto.STRING, number=3292052, optional=True,) label_fingerprint = proto.Field(proto.STRING, number=178124825, optional=True,) labels = proto.MapField(proto.STRING, proto.STRING, number=500195327,) - last_start_timestamp = proto.Field(proto.STRING, number=443830736, optional=True,) - last_stop_timestamp = proto.Field(proto.STRING, number=412823010, optional=True,) - last_suspended_timestamp = proto.Field( - proto.STRING, number=356275337, optional=True, - ) - machine_type = proto.Field(proto.STRING, number=227711026, optional=True,) - metadata = proto.Field( - proto.MESSAGE, number=86866735, optional=True, message="Metadata", - ) - min_cpu_platform = proto.Field(proto.STRING, number=242912759, optional=True,) + last_attach_timestamp = proto.Field(proto.STRING, number=42159653, optional=True,) + last_detach_timestamp = proto.Field(proto.STRING, number=56471027, optional=True,) + license_codes = proto.RepeatedField(proto.INT64, number=45482664,) + licenses = proto.RepeatedField(proto.STRING, number=337642578,) + location_hint = proto.Field(proto.STRING, number=350519505, optional=True,) name = proto.Field(proto.STRING, number=3373707, optional=True,) - network_interfaces = proto.RepeatedField( - proto.MESSAGE, number=52735243, message="NetworkInterface", - ) - private_ipv6_google_access = proto.Field( - proto.ENUM, number=48277006, optional=True, enum=PrivateIpv6GoogleAccess, - ) - reservation_affinity = proto.Field( - proto.MESSAGE, number=157850683, optional=True, message="ReservationAffinity", + options = proto.Field(proto.STRING, number=361137822, optional=True,) + physical_block_size_bytes = proto.Field( + proto.INT64, number=420007943, optional=True, ) + provisioned_iops = proto.Field(proto.INT64, number=186769108, optional=True,) + region = proto.Field(proto.STRING, number=138946292, optional=True,) + replica_zones = proto.RepeatedField(proto.STRING, number=48438272,) resource_policies = proto.RepeatedField(proto.STRING, number=22220385,) satisfies_pzs = proto.Field(proto.BOOL, number=480964267, optional=True,) - scheduling = proto.Field( - proto.MESSAGE, number=386688404, optional=True, message="Scheduling", - ) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - service_accounts = proto.RepeatedField( - proto.MESSAGE, number=277537328, message="ServiceAccount", - ) - shielded_instance_config = proto.Field( - proto.MESSAGE, number=12862901, optional=True, message="ShieldedInstanceConfig", + size_gb = proto.Field(proto.INT64, number=494929369, optional=True,) + source_disk = proto.Field(proto.STRING, number=451753793, optional=True,) + source_disk_id = proto.Field(proto.STRING, number=454190809, optional=True,) + source_image = proto.Field(proto.STRING, number=50443319, optional=True,) + source_image_encryption_key = proto.Field( + proto.MESSAGE, number=381503659, optional=True, message="CustomerEncryptionKey", ) - shielded_instance_integrity_policy = proto.Field( - proto.MESSAGE, - number=163696919, - optional=True, - message="ShieldedInstanceIntegrityPolicy", + source_image_id = proto.Field(proto.STRING, number=55328291, optional=True,) + source_snapshot = proto.Field(proto.STRING, number=126061928, optional=True,) + source_snapshot_encryption_key = proto.Field( + proto.MESSAGE, number=303679322, optional=True, message="CustomerEncryptionKey", ) - start_restricted = proto.Field(proto.BOOL, number=123693144, optional=True,) + source_snapshot_id = proto.Field(proto.STRING, number=98962258, optional=True,) + source_storage_object = proto.Field(proto.STRING, number=233052711, optional=True,) status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) - status_message = proto.Field(proto.STRING, number=297428154, optional=True,) - tags = proto.Field(proto.MESSAGE, number=3552281, optional=True, message="Tags",) + type_ = proto.Field(proto.STRING, number=3575610, optional=True,) + users = proto.RepeatedField(proto.STRING, number=111578632,) zone = proto.Field(proto.STRING, number=3744684, optional=True,) -class InstancesScopedList(proto.Message): - r""" - Attributes: - instances (Sequence[google.cloud.compute_v1.types.Instance]): - [Output Only] A list of instances contained in this scope. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning which replaces the list - of instances when the list is empty. - """ - - instances = proto.RepeatedField(proto.MESSAGE, number=29097598, message="Instance",) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) - - -class InstanceAggregatedList(proto.Message): +class DiskAggregatedList(proto.Message): r""" Attributes: id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.InstanceAggregatedList.ItemsEntry]): - An object that contains a list of instances - scoped by zone. + items (Sequence[google.cloud.compute_v1.types.DiskAggregatedList.ItemsEntry]): + A list of DisksScopedList resources. kind (str): [Output Only] Type of resource. Always - compute#instanceAggregatedList for aggregated lists of - Instance resources. + compute#diskAggregatedList for aggregated lists of + persistent disks. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -11171,7 +11908,7 @@ def raw_page(self): id = proto.Field(proto.STRING, number=3355, optional=True,) items = proto.MapField( - proto.STRING, proto.MESSAGE, number=100526016, message="InstancesScopedList", + proto.STRING, proto.MESSAGE, number=100526016, message="DisksScopedList", ) kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) @@ -11182,149 +11919,209 @@ def raw_page(self): ) -class NamedPort(proto.Message): - r"""The named port. For example: . +class DiskInstantiationConfig(proto.Message): + r"""A specification of the desired way to instantiate a disk in + the instance template when its created from a source instance. + Attributes: - name (str): - The name for this named port. The name must - be 1-63 characters long, and comply with - RFC1035. - port (int): - The port number, which can be a value between - 1 and 65535. + auto_delete (bool): + Specifies whether the disk will be auto- + eleted when the instance is deleted (but not + when the disk is detached from the instance). + custom_image (str): + The custom source image to be used to restore + this disk when instantiating this instance + template. + device_name (str): + Specifies the device name of the disk to + which the configurations apply to. + instantiate_from (google.cloud.compute_v1.types.DiskInstantiationConfig.InstantiateFrom): + Specifies whether to include the disk and + what image to use. Possible values are: - + source-image: to use the same image that was + used to create the source instance's + corresponding disk. Applicable to the boot disk + and additional read-write disks. - source-image- + family: to use the same image family that was + used to create the source instance's + corresponding disk. Applicable to the boot disk + and additional read-write disks. - custom-image: + to use a user-provided image url for disk + creation. Applicable to the boot disk and + additional read-write disks. - attach-read-only: + to attach a read-only disk. Applicable to read- + only disks. - do-not-include: to exclude a disk + from the template. Applicable to additional + read-write disks, local SSDs, and read-only + disks. """ - name = proto.Field(proto.STRING, number=3373707, optional=True,) - port = proto.Field(proto.INT32, number=3446913, optional=True,) + class InstantiateFrom(proto.Enum): + r"""Specifies whether to include the disk and what image to use. + Possible values are: - source-image: to use the same image that + was used to create the source instance's corresponding disk. + Applicable to the boot disk and additional read-write disks. - + source-image-family: to use the same image family that was used + to create the source instance's corresponding disk. Applicable + to the boot disk and additional read-write disks. - custom- + image: to use a user-provided image url for disk creation. + Applicable to the boot disk and additional read-write disks. - + attach-read-only: to attach a read-only disk. Applicable to + read-only disks. - do-not-include: to exclude a disk from the + template. Applicable to additional read-write disks, local SSDs, + and read-only disks. + """ + UNDEFINED_INSTANTIATE_FROM = 0 + ATTACH_READ_ONLY = 513775419 + BLANK = 63281460 + CUSTOM_IMAGE = 196311789 + DEFAULT = 115302945 + DO_NOT_INCLUDE = 104218952 + SOURCE_IMAGE = 62631959 + SOURCE_IMAGE_FAMILY = 76850316 + auto_delete = proto.Field(proto.BOOL, number=464761403, optional=True,) + custom_image = proto.Field(proto.STRING, number=184123149, optional=True,) + device_name = proto.Field(proto.STRING, number=67541716, optional=True,) + instantiate_from = proto.Field( + proto.ENUM, number=393383903, optional=True, enum=InstantiateFrom, + ) -class InstanceGroup(proto.Message): - r"""Represents an Instance Group resource. - Instance Groups can be used to configure a target for load - balancing. +class DiskList(proto.Message): + r"""A list of Disk resources. + Attributes: + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.Disk]): + A list of Disk resources. + kind (str): + [Output Only] Type of resource. Always compute#diskList for + lists of disks. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. + """ - Instance groups can either be managed or unmanaged. + @property + def raw_page(self): + return self - To create managed instance groups, use the instanceGroupManager or - regionInstanceGroupManager resource instead. + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Disk",) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) - Use zonal unmanaged instance groups if you need to apply load - balancing to groups of heterogeneous instances or if you need to - manage the instances yourself. You cannot create regional unmanaged - instance groups. - For more information, read Instance groups. +class DiskMoveRequest(proto.Message): + r""" + Attributes: + destination_zone (str): + The URL of the destination zone to move the + disk. This can be a full or partial URL. For + example, the following are all valid URLs to a + zone: - + https://www.googleapis.com/compute/v1/projects/project/zones/zone + - projects/project/zones/zone - zones/zone + target_disk (str): + The URL of the target disk to move. This can + be a full or partial URL. For example, the + following are all valid URLs to a disk: - + https://www.googleapis.com/compute/v1/projects/project/zones/zone + /disks/disk - + projects/project/zones/zone/disks/disk - + zones/zone/disks/disk + """ + + destination_zone = proto.Field(proto.STRING, number=131854653, optional=True,) + target_disk = proto.Field(proto.STRING, number=62433163, optional=True,) - (== resource_for {$api_version}.instanceGroups ==) (== resource_for - {$api_version}.regionInstanceGroups ==) + +class DiskType(proto.Message): + r"""Represents a Disk Type resource. Google Compute Engine has two Disk + Type resources: \* + `Regional `__ \* + `Zonal `__ You can choose + from a variety of disk types based on your needs. For more + information, read Storage options. The diskTypes resource represents + disk types for a zonal persistent disk. For more information, read + Zonal persistent disks. The regionDiskTypes resource represents disk + types for a regional persistent disk. For more information, read + Regional persistent disks. Attributes: creation_timestamp (str): - [Output Only] The creation timestamp for this instance group - in RFC3339 text format. + [Output Only] Creation timestamp in RFC3339 text format. + default_disk_size_gb (int): + [Output Only] Server-defined default disk size in GB. + deprecated (google.cloud.compute_v1.types.DeprecationStatus): + [Output Only] The deprecation status associated with this + disk type. description (str): - An optional description of this resource. - Provide this property when you create the - resource. - fingerprint (str): - [Output Only] The fingerprint of the named ports. The system - uses this fingerprint to detect conflicts when multiple - users change the named ports concurrently. + [Output Only] An optional description of this resource. id (int): - [Output Only] A unique identifier for this instance group, - generated by the server. + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. kind (str): - [Output Only] The resource type, which is always - compute#instanceGroup for instance groups. + [Output Only] Type of the resource. Always compute#diskType + for disk types. name (str): - The name of the instance group. The name must - be 1-63 characters long, and comply with - RFC1035. - named_ports (Sequence[google.cloud.compute_v1.types.NamedPort]): - Assigns a name to a port number. For example: {name: "http", - port: 80} - - This allows the system to reference ports by the assigned - name instead of a port number. Named ports can also contain - multiple ports. For example: [{name: "http", port: - 80},{name: "http", port: 8080}] - - Named ports apply to all instances in this instance group. - network (str): - [Output Only] The URL of the network to which all instances - in the instance group belong. If your instance has multiple - network interfaces, then the network and subnetwork fields - only refer to the network and subnet used by your primary - interface (nic0). + [Output Only] Name of the resource. region (str): - [Output Only] The URL of the region where the instance group - is located (for regional resources). + [Output Only] URL of the region where the disk type resides. + Only applicable for regional resources. You must specify + this field as part of the HTTP request URL. It is not + settable as a field in the request body. self_link (str): - [Output Only] The URL for this instance group. The server - generates this URL. - size (int): - [Output Only] The total number of instances in the instance - group. - subnetwork (str): - [Output Only] The URL of the subnetwork to which all - instances in the instance group belong. If your instance has - multiple network interfaces, then the network and subnetwork - fields only refer to the network and subnet used by your - primary interface (nic0). + [Output Only] Server-defined URL for the resource. + valid_disk_size (str): + [Output Only] An optional textual description of the valid + disk size, such as "10GB-10TB". zone (str): - [Output Only] The URL of the zone where the instance group - is located (for zonal resources). + [Output Only] URL of the zone where the disk type resides. + You must specify this field as part of the HTTP request URL. + It is not settable as a field in the request body. """ creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + default_disk_size_gb = proto.Field(proto.INT64, number=270619253, optional=True,) + deprecated = proto.Field( + proto.MESSAGE, number=515138995, optional=True, message="DeprecationStatus", + ) description = proto.Field(proto.STRING, number=422937596, optional=True,) - fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) id = proto.Field(proto.UINT64, number=3355, optional=True,) kind = proto.Field(proto.STRING, number=3292052, optional=True,) name = proto.Field(proto.STRING, number=3373707, optional=True,) - named_ports = proto.RepeatedField( - proto.MESSAGE, number=427598732, message="NamedPort", - ) - network = proto.Field(proto.STRING, number=232872494, optional=True,) region = proto.Field(proto.STRING, number=138946292, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - size = proto.Field(proto.INT32, number=3530753, optional=True,) - subnetwork = proto.Field(proto.STRING, number=307827694, optional=True,) + valid_disk_size = proto.Field(proto.STRING, number=493962464, optional=True,) zone = proto.Field(proto.STRING, number=3744684, optional=True,) -class InstanceGroupsScopedList(proto.Message): - r""" - Attributes: - instance_groups (Sequence[google.cloud.compute_v1.types.InstanceGroup]): - [Output Only] The list of instance groups that are contained - in this scope. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] An informational warning that replaces the - list of instance groups when the list is empty. - """ - - instance_groups = proto.RepeatedField( - proto.MESSAGE, number=366469310, message="InstanceGroup", - ) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) - - -class InstanceGroupAggregatedList(proto.Message): +class DiskTypeAggregatedList(proto.Message): r""" Attributes: id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.InstanceGroupAggregatedList.ItemsEntry]): - A list of InstanceGroupsScopedList resources. + items (Sequence[google.cloud.compute_v1.types.DiskTypeAggregatedList.ItemsEntry]): + A list of DiskTypesScopedList resources. kind (str): - [Output Only] The resource type, which is always - compute#instanceGroupAggregatedList for aggregated lists of - instance groups. + [Output Only] Type of resource. Always + compute#diskTypeAggregatedList. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -11346,10 +12143,7 @@ def raw_page(self): id = proto.Field(proto.STRING, number=3355, optional=True,) items = proto.MapField( - proto.STRING, - proto.MESSAGE, - number=100526016, - message="InstanceGroupsScopedList", + proto.STRING, proto.MESSAGE, number=100526016, message="DiskTypesScopedList", ) kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) @@ -11360,17 +12154,17 @@ def raw_page(self): ) -class InstanceGroupList(proto.Message): - r"""A list of InstanceGroup resources. +class DiskTypeList(proto.Message): + r"""Contains a list of disk types. Attributes: id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.InstanceGroup]): - A list of InstanceGroup resources. + items (Sequence[google.cloud.compute_v1.types.DiskType]): + A list of DiskType resources. kind (str): - [Output Only] The resource type, which is always - compute#instanceGroupList for instance group lists. + [Output Only] Type of resource. Always compute#diskTypeList + for disk types. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -11389,9 +12183,7 @@ def raw_page(self): return self id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="InstanceGroup", - ) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="DiskType",) kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) @@ -11400,476 +12192,535 @@ def raw_page(self): ) -class InstanceGroupManagerAutoHealingPolicy(proto.Message): +class DiskTypesScopedList(proto.Message): r""" Attributes: - health_check (str): - The URL for the health check that signals - autohealing. - initial_delay_sec (int): - The number of seconds that the managed instance group waits - before it applies autohealing policies to new instances or - recently recreated instances. This initial delay allows - instances to initialize and run their startup scripts before - the instance group determines that they are UNHEALTHY. This - prevents the managed instance group from recreating its - instances prematurely. This value must be from range [0, - 3600]. + disk_types (Sequence[google.cloud.compute_v1.types.DiskType]): + [Output Only] A list of disk types contained in this scope. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning which replaces the list + of disk types when the list is empty. """ - health_check = proto.Field(proto.STRING, number=308876645, optional=True,) - initial_delay_sec = proto.Field(proto.INT32, number=263207002, optional=True,) + disk_types = proto.RepeatedField( + proto.MESSAGE, number=198926167, message="DiskType", + ) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class InstanceGroupManagerActionsSummary(proto.Message): +class DisksAddResourcePoliciesRequest(proto.Message): r""" Attributes: - abandoning (int): - [Output Only] The total number of instances in the managed - instance group that are scheduled to be abandoned. - Abandoning an instance removes it from the managed instance - group without deleting it. - creating (int): - [Output Only] The number of instances in the managed - instance group that are scheduled to be created or are - currently being created. If the group fails to create any of - these instances, it tries again until it creates the - instance successfully. + resource_policies (Sequence[str]): + Full or relative path to the resource policy + to be added to this disk. You can only specify + one resource policy. + """ - If you have disabled creation retries, this field will not - be populated; instead, the creatingWithoutRetries field will - be populated. - creating_without_retries (int): - [Output Only] The number of instances that the managed - instance group will attempt to create. The group attempts to - create each instance only once. If the group fails to create - any of these instances, it decreases the group's targetSize - value accordingly. - deleting (int): - [Output Only] The number of instances in the managed - instance group that are scheduled to be deleted or are - currently being deleted. - none (int): - [Output Only] The number of instances in the managed - instance group that are running and have no scheduled - actions. - recreating (int): - [Output Only] The number of instances in the managed - instance group that are scheduled to be recreated or are - currently being being recreated. Recreating an instance - deletes the existing root persistent disk and creates a new - disk from the image that is defined in the instance - template. - refreshing (int): - [Output Only] The number of instances in the managed - instance group that are being reconfigured with properties - that do not require a restart or a recreate action. For - example, setting or removing target pools for the instance. - restarting (int): - [Output Only] The number of instances in the managed - instance group that are scheduled to be restarted or are - currently being restarted. - verifying (int): - [Output Only] The number of instances in the managed - instance group that are being verified. See the - managedInstances[].currentAction property in the - listManagedInstances method documentation. + resource_policies = proto.RepeatedField(proto.STRING, number=22220385,) + + +class DisksRemoveResourcePoliciesRequest(proto.Message): + r""" + Attributes: + resource_policies (Sequence[str]): + Resource policies to be removed from this + disk. """ - abandoning = proto.Field(proto.INT32, number=440023373, optional=True,) - creating = proto.Field(proto.INT32, number=209809081, optional=True,) - creating_without_retries = proto.Field( - proto.INT32, number=369916745, optional=True, - ) - deleting = proto.Field(proto.INT32, number=282846120, optional=True,) - none = proto.Field(proto.INT32, number=3387192, optional=True,) - recreating = proto.Field(proto.INT32, number=339057132, optional=True,) - refreshing = proto.Field(proto.INT32, number=215044903, optional=True,) - restarting = proto.Field(proto.INT32, number=372312947, optional=True,) - verifying = proto.Field(proto.INT32, number=451612873, optional=True,) + resource_policies = proto.RepeatedField(proto.STRING, number=22220385,) -class StatefulPolicy(proto.Message): +class DisksResizeRequest(proto.Message): r""" Attributes: - preserved_state (google.cloud.compute_v1.types.StatefulPolicyPreservedState): + size_gb (int): + The new size of the persistent disk, which is + specified in GB. + """ + + size_gb = proto.Field(proto.INT64, number=494929369, optional=True,) + +class DisksScopedList(proto.Message): + r""" + Attributes: + disks (Sequence[google.cloud.compute_v1.types.Disk]): + [Output Only] A list of disks contained in this scope. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning which replaces the list + of disks when the list is empty. """ - preserved_state = proto.Field( - proto.MESSAGE, - number=2634026, - optional=True, - message="StatefulPolicyPreservedState", + disks = proto.RepeatedField(proto.MESSAGE, number=95594102, message="Disk",) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", ) -class InstanceGroupManagerStatus(proto.Message): +class DisplayDevice(proto.Message): + r"""A set of Display Device options + Attributes: + enable_display (bool): + Defines whether the instance has Display + enabled. + """ + + enable_display = proto.Field(proto.BOOL, number=14266886, optional=True,) + + +class DistributionPolicy(proto.Message): r""" Attributes: - autoscaler (str): - [Output Only] The URL of the Autoscaler that targets this - instance group manager. - is_stable (bool): - [Output Only] A bit indicating whether the managed instance - group is in a stable state. A stable state means that: none - of the instances in the managed instance group is currently - undergoing any type of change (for example, creation, - restart, or deletion); no future changes are scheduled for - instances in the managed instance group; and the managed - instance group itself is not being modified. - stateful (google.cloud.compute_v1.types.InstanceGroupManagerStatusStateful): - [Output Only] Stateful status of the given Instance Group - Manager. - version_target (google.cloud.compute_v1.types.InstanceGroupManagerStatusVersionTarget): - [Output Only] A status of consistency of Instances' versions - with their target version specified by version field on - Instance Group Manager. + target_shape (google.cloud.compute_v1.types.DistributionPolicy.TargetShape): + The distribution shape to which the group + converges either proactively or on resize events + (depending on the value set in + updatePolicy.instanceRedistributionType). + zones (Sequence[google.cloud.compute_v1.types.DistributionPolicyZoneConfiguration]): + Zones where the regional managed instance + group will create and manage its instances. """ - autoscaler = proto.Field(proto.STRING, number=517258967, optional=True,) - is_stable = proto.Field(proto.BOOL, number=108410864, optional=True,) - stateful = proto.Field( - proto.MESSAGE, - number=244462412, - optional=True, - message="InstanceGroupManagerStatusStateful", + class TargetShape(proto.Enum): + r"""The distribution shape to which the group converges either + proactively or on resize events (depending on the value set in + updatePolicy.instanceRedistributionType). + """ + UNDEFINED_TARGET_SHAPE = 0 + ANY = 64972 + BALANCED = 468409608 + EVEN = 2140442 + + target_shape = proto.Field( + proto.ENUM, number=338621299, optional=True, enum=TargetShape, ) - version_target = proto.Field( - proto.MESSAGE, - number=289386200, - optional=True, - message="InstanceGroupManagerStatusVersionTarget", + zones = proto.RepeatedField( + proto.MESSAGE, number=116085319, message="DistributionPolicyZoneConfiguration", ) -class InstanceGroupManagerUpdatePolicy(proto.Message): +class DistributionPolicyZoneConfiguration(proto.Message): r""" Attributes: - instance_redistribution_type (str): - The instance redistribution policy for - regional managed instance groups. Valid values - are: - PROACTIVE (default): The group attempts - to maintain an even distribution of VM instances - across zones in the region. - NONE: For non- - autoscaled groups, proactive redistribution is - disabled. - max_surge (google.cloud.compute_v1.types.FixedOrPercent): - The maximum number of instances that can be - created above the specified targetSize during - the update process. This value can be either a - fixed number or, if the group has 10 or more - instances, a percentage. If you set a - percentage, the number of instances is rounded - up if necessary. The default value for maxSurge - is a fixed value equal to the number of zones in - which the managed instance group operates. At - least one of either maxSurge or maxUnavailable - must be greater than 0. Learn more about - maxSurge. - max_unavailable (google.cloud.compute_v1.types.FixedOrPercent): - The maximum number of instances that can be - unavailable during the update process. An - instance is considered available if all of the - following conditions are satisfied: - - The instance's status is RUNNING. - - If there is a health check on the instance - group, the instance's health check status must - be HEALTHY at least once. If there is no health - check on the group, then the instance only needs - to have a status of RUNNING to be considered - available. This value can be either a fixed - number or, if the group has 10 or more - instances, a percentage. If you set a - percentage, the number of instances is rounded - up if necessary. The default value for - maxUnavailable is a fixed value equal to the - number of zones in which the managed instance - group operates. - At least one of either maxSurge or - maxUnavailable must be greater than 0. Learn - more about maxUnavailable. - minimal_action (str): - Minimal action to be taken on an instance. - You can specify either RESTART to restart - existing instances or REPLACE to delete and - create new instances from the target template. - If you specify a RESTART, the Updater will - attempt to perform that action only. However, if - the Updater determines that the minimal action - you specify is not enough to perform the update, - it might perform a more disruptive action. - replacement_method (str): - What action should be used to replace instances. See - minimal_action.REPLACE - type_ (str): - The type of update process. You can specify - either PROACTIVE so that the instance group - manager proactively executes actions in order to - bring instances to their target versions or - OPPORTUNISTIC so that no action is proactively - executed but the update will be performed as - part of other actions (for example, resizes or - recreateInstances calls). + zone (str): + The URL of the zone. The zone must exist in + the region where the managed instance group is + located. + """ + + zone = proto.Field(proto.STRING, number=3744684, optional=True,) + + +class Duration(proto.Message): + r"""A Duration represents a fixed-length span of time represented + as a count of seconds and fractions of seconds at nanosecond + resolution. It is independent of any calendar and concepts like + "day" or "month". Range is approximately 10,000 years. + + Attributes: + nanos (int): + Span of time that's a fraction of a second at nanosecond + resolution. Durations less than one second are represented + with a 0 ``seconds`` field and a positive ``nanos`` field. + Must be from 0 to 999,999,999 inclusive. + seconds (int): + Span of time at a resolution of a second. Must be from 0 to + 315,576,000,000 inclusive. Note: these bounds are computed + from: 60 sec/min \* 60 min/hr \* 24 hr/day \* 365.25 + days/year \* 10000 years + """ + + nanos = proto.Field(proto.INT32, number=104586303, optional=True,) + seconds = proto.Field(proto.INT64, number=359484031, optional=True,) + + +class EnableXpnHostProjectRequest(proto.Message): + r"""A request message for Projects.EnableXpnHost. See the method + description for details. + + Attributes: + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + """ + + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + + +class EnableXpnResourceProjectRequest(proto.Message): + r"""A request message for Projects.EnableXpnResource. See the + method description for details. + + Attributes: + project (str): + Project ID for this request. + projects_enable_xpn_resource_request_resource (google.cloud.compute_v1.types.ProjectsEnableXpnResourceRequest): + The body resource for this request + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + """ + + project = proto.Field(proto.STRING, number=227560217,) + projects_enable_xpn_resource_request_resource = proto.Field( + proto.MESSAGE, number=421980207, message="ProjectsEnableXpnResourceRequest", + ) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + + +class Error(proto.Message): + r"""[Output Only] If errors are generated during processing of the + operation, this field will be populated. + + Attributes: + errors (Sequence[google.cloud.compute_v1.types.Errors]): + [Output Only] The array of errors encountered while + processing this operation. + """ + + errors = proto.RepeatedField(proto.MESSAGE, number=315977579, message="Errors",) + + +class Errors(proto.Message): + r""" + Attributes: + code (str): + [Output Only] The error type identifier for this error. + location (str): + [Output Only] Indicates the field in the request that caused + the error. This property is optional. + message (str): + [Output Only] An optional, human-readable error message. + """ + + code = proto.Field(proto.STRING, number=3059181, optional=True,) + location = proto.Field(proto.STRING, number=290430901, optional=True,) + message = proto.Field(proto.STRING, number=418054151, optional=True,) + + +class ExchangedPeeringRoute(proto.Message): + r""" + Attributes: + dest_range (str): + The destination range of the route. + imported (bool): + True if the peering route has been imported + from a peer. The actual import happens if the + field networkPeering.importCustomRoutes is true + for this network, and + networkPeering.exportCustomRoutes is true for + the peer network, and the import does not result + in a route conflict. + next_hop_region (str): + The region of peering route next hop, only + applies to dynamic routes. + priority (int): + The priority of the peering route. + type_ (google.cloud.compute_v1.types.ExchangedPeeringRoute.Type): + The type of the peering route. + """ + + class Type(proto.Enum): + r"""The type of the peering route.""" + UNDEFINED_TYPE = 0 + DYNAMIC_PEERING_ROUTE = 469794858 + STATIC_PEERING_ROUTE = 473407545 + SUBNET_PEERING_ROUTE = 465782504 + + dest_range = proto.Field(proto.STRING, number=381327712, optional=True,) + imported = proto.Field(proto.BOOL, number=114502404, optional=True,) + next_hop_region = proto.Field(proto.STRING, number=122577014, optional=True,) + priority = proto.Field(proto.UINT32, number=445151652, optional=True,) + type_ = proto.Field(proto.ENUM, number=3575610, optional=True, enum=Type,) + + +class ExchangedPeeringRoutesList(proto.Message): + r""" + Attributes: + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.ExchangedPeeringRoute]): + A list of ExchangedPeeringRoute resources. + kind (str): + [Output Only] Type of resource. Always + compute#exchangedPeeringRoutesList for exchanged peering + routes lists. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - instance_redistribution_type = proto.Field( - proto.STRING, number=292630424, optional=True, - ) - max_surge = proto.Field( - proto.MESSAGE, number=302572691, optional=True, message="FixedOrPercent", + @property + def raw_page(self): + return self + + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="ExchangedPeeringRoute", ) - max_unavailable = proto.Field( - proto.MESSAGE, number=404940277, optional=True, message="FixedOrPercent", + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", ) - minimal_action = proto.Field(proto.STRING, number=270567060, optional=True,) - replacement_method = proto.Field(proto.STRING, number=505931694, optional=True,) - type_ = proto.Field(proto.STRING, number=3575610, optional=True,) -class InstanceGroupManagerVersion(proto.Message): - r""" - Attributes: - instance_template (str): - The URL of the instance template that is specified for this - managed instance group. The group uses this template to - create new instances in the managed instance group until the - ``targetSize`` for this version is reached. The templates - for existing instances in the group do not change unless you - run recreateInstances, run applyUpdatesToInstances, or set - the group's updatePolicy.type to PROACTIVE; in those cases, - existing instances are updated until the ``targetSize`` for - this version is reached. - name (str): - Name of the version. Unique among all - versions in the scope of this managed instance - group. - target_size (google.cloud.compute_v1.types.FixedOrPercent): - Specifies the intended number of instances to be created - from the instanceTemplate. The final number of instances - created from the template will be equal to: +class ExpandIpCidrRangeSubnetworkRequest(proto.Message): + r"""A request message for Subnetworks.ExpandIpCidrRange. See the + method description for details. - - If expressed as a fixed number, the minimum of either - targetSize.fixed or instanceGroupManager.targetSize is - used. - - if expressed as a percent, the targetSize would be - (targetSize.percent/100 \* - InstanceGroupManager.targetSize) If there is a remainder, - the number is rounded up. If unset, this version will - update any remaining instances not updated by another - version. Read Starting a canary update for more - information. + Attributes: + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + subnetwork (str): + Name of the Subnetwork resource to update. + subnetworks_expand_ip_cidr_range_request_resource (google.cloud.compute_v1.types.SubnetworksExpandIpCidrRangeRequest): + The body resource for this request """ - instance_template = proto.Field(proto.STRING, number=309248228, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - target_size = proto.Field( - proto.MESSAGE, number=62880239, optional=True, message="FixedOrPercent", + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + subnetwork = proto.Field(proto.STRING, number=307827694,) + subnetworks_expand_ip_cidr_range_request_resource = proto.Field( + proto.MESSAGE, number=477014110, message="SubnetworksExpandIpCidrRangeRequest", ) -class InstanceGroupManager(proto.Message): - r"""Represents a Managed Instance Group resource. +class Expr(proto.Message): + r"""Represents a textual expression in the Common Expression Language + (CEL) syntax. CEL is a C-like expression language. The syntax and + semantics of CEL are documented at + https://github.com/google/cel-spec. Example (Comparison): title: + "Summary size limit" description: "Determines if a summary is less + than 100 chars" expression: "document.summary.size() < 100" Example + (Equality): title: "Requestor is owner" description: "Determines if + requestor is the document owner" expression: "document.owner == + request.auth.claims.email" Example (Logic): title: "Public + documents" description: "Determine whether the document should be + publicly visible" expression: "document.type != 'private' && + document.type != 'internal'" Example (Data Manipulation): title: + "Notification string" description: "Create a notification string + with a timestamp." expression: "'New message received at ' + + string(document.create_time)" The exact variables and functions that + may be referenced within an expression are determined by the service + that evaluates it. See the service documentation for additional + information. + + Attributes: + description (str): + Optional. Description of the expression. This + is a longer text which describes the expression, + e.g. when hovered over it in a UI. + expression (str): + Textual representation of an expression in + Common Expression Language syntax. + location (str): + Optional. String indicating the location of + the expression for error reporting, e.g. a file + name and a position in the file. + title (str): + Optional. Title for the expression, i.e. a + short string describing its purpose. This can be + used e.g. in UIs which allow to enter the + expression. + """ - An instance group is a collection of VM instances that you can - manage as a single entity. For more information, read Instance - groups. + description = proto.Field(proto.STRING, number=422937596, optional=True,) + expression = proto.Field(proto.STRING, number=352031384, optional=True,) + location = proto.Field(proto.STRING, number=290430901, optional=True,) + title = proto.Field(proto.STRING, number=110371416, optional=True,) - For zonal Managed Instance Group, use the instanceGroupManagers - resource. - For regional Managed Instance Group, use the - regionInstanceGroupManagers resource. (== resource_for - {$api_version}.instanceGroupManagers ==) (== resource_for - {$api_version}.regionInstanceGroupManagers ==) +class ExternalVpnGateway(proto.Message): + r"""Represents an external VPN gateway. External VPN gateway is + the on-premises VPN gateway(s) or another cloud provider's VPN + gateway that connects to your Google Cloud VPN gateway. To + create a highly available VPN from Google Cloud Platform to your + VPN gateway or another cloud provider's VPN gateway, you must + create a external VPN gateway resource with information about + the other gateway. For more information about using external VPN + gateways, see Creating an HA VPN gateway and tunnel pair to a + peer VPN. Attributes: - auto_healing_policies (Sequence[google.cloud.compute_v1.types.InstanceGroupManagerAutoHealingPolicy]): - The autohealing policy for this managed - instance group. You can specify only one value. - base_instance_name (str): - The base instance name to use for instances - in this group. The value must be 1-58 characters - long. Instances are named by appending a hyphen - and a random four-character string to the base - instance name. The base instance name must - comply with RFC1035. creation_timestamp (str): - [Output Only] The creation timestamp for this managed - instance group in RFC3339 text format. - current_actions (google.cloud.compute_v1.types.InstanceGroupManagerActionsSummary): - [Output Only] The list of instance actions and the number of - instances in this managed instance group that are scheduled - for each of those actions. + [Output Only] Creation timestamp in RFC3339 text format. description (str): An optional description of this resource. Provide this property when you create the resource. - distribution_policy (google.cloud.compute_v1.types.DistributionPolicy): - Policy specifying the intended distribution - of managed instances across zones in a regional - managed instance group. - fingerprint (str): - Fingerprint of this resource. This field may - be used in optimistic locking. It will be - ignored when inserting an InstanceGroupManager. - An up-to-date fingerprint must be provided in - order to update the InstanceGroupManager, - otherwise the request will fail with error 412 - conditionNotMet. To see the latest fingerprint, - make a get() request to retrieve an - InstanceGroupManager. id (int): - [Output Only] A unique identifier for this resource type. - The server generates this identifier. - instance_group (str): - [Output Only] The URL of the Instance Group resource. - instance_template (str): - The URL of the instance template that is - specified for this managed instance group. The - group uses this template to create all new - instances in the managed instance group. The - templates for existing instances in the group do - not change unless you run recreateInstances, run - applyUpdatesToInstances, or set the group's - updatePolicy.type to PROACTIVE. + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + interfaces (Sequence[google.cloud.compute_v1.types.ExternalVpnGatewayInterface]): + A list of interfaces for this external VPN + gateway. If your peer-side gateway is an on- + premises gateway and non-AWS cloud providers' + gateway, at most two interfaces can be provided + for an external VPN gateway. If your peer side + is an AWS virtual private gateway, four + interfaces should be provided for an external + VPN gateway. kind (str): - [Output Only] The resource type, which is always - compute#instanceGroupManager for managed instance groups. + [Output Only] Type of the resource. Always + compute#externalVpnGateway for externalVpnGateways. + label_fingerprint (str): + A fingerprint for the labels being applied to + this ExternalVpnGateway, which is essentially a + hash of the labels set used for optimistic + locking. The fingerprint is initially generated + by Compute Engine and changes after every + request to modify or update labels. You must + always provide an up-to-date fingerprint hash in + order to update or change labels, otherwise the + request will fail with error 412 + conditionNotMet. To see the latest fingerprint, + make a get() request to retrieve an + ExternalVpnGateway. + labels (Sequence[google.cloud.compute_v1.types.ExternalVpnGateway.LabelsEntry]): + Labels for this resource. These can only be + added or modified by the setLabels method. Each + label key/value pair must comply with RFC1035. + Label values may be empty. name (str): - The name of the managed instance group. The - name must be 1-63 characters long, and comply - with RFC1035. - named_ports (Sequence[google.cloud.compute_v1.types.NamedPort]): - Named ports configured for the Instance - Groups complementary to this Instance Group - Manager. - region (str): - [Output Only] The URL of the region where the managed - instance group resides (for regional resources). + Name of the resource. Provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. + redundancy_type (google.cloud.compute_v1.types.ExternalVpnGateway.RedundancyType): + Indicates the user-supplied redundancy type + of this external VPN gateway. self_link (str): - [Output Only] The URL for this managed instance group. The - server defines this URL. - stateful_policy (google.cloud.compute_v1.types.StatefulPolicy): - Stateful configuration for this Instanced - Group Manager - status (google.cloud.compute_v1.types.InstanceGroupManagerStatus): - [Output Only] The status of this managed instance group. - target_pools (Sequence[str]): - The URLs for all TargetPool resources to - which instances in the instanceGroup field are - added. The target pools automatically apply to - all of the instances in the managed instance - group. - target_size (int): - The target number of running instances for - this managed instance group. You can reduce this - number by using the instanceGroupManager - deleteInstances or abandonInstances methods. - Resizing the group also changes this number. - update_policy (google.cloud.compute_v1.types.InstanceGroupManagerUpdatePolicy): - The update policy for this managed instance - group. - versions (Sequence[google.cloud.compute_v1.types.InstanceGroupManagerVersion]): - Specifies the instance templates used by this - managed instance group to create instances. - Each version is defined by an instanceTemplate - and a name. Every version can appear at most - once per instance group. This field overrides - the top-level instanceTemplate field. Read more - about the relationships between these fields. - Exactly one version must leave the targetSize - field unset. That version will be applied to all - remaining instances. For more information, read - about canary updates. - zone (str): - [Output Only] The URL of a zone where the managed instance - group is located (for zonal resources). + [Output Only] Server-defined URL for the resource. """ - auto_healing_policies = proto.RepeatedField( - proto.MESSAGE, - number=456799109, - message="InstanceGroupManagerAutoHealingPolicy", - ) - base_instance_name = proto.Field(proto.STRING, number=389106439, optional=True,) + class RedundancyType(proto.Enum): + r"""Indicates the user-supplied redundancy type of this external + VPN gateway. + """ + UNDEFINED_REDUNDANCY_TYPE = 0 + FOUR_IPS_REDUNDANCY = 520087913 + SINGLE_IP_INTERNALLY_REDUNDANT = 133914873 + TWO_IPS_REDUNDANCY = 367049635 + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - current_actions = proto.Field( - proto.MESSAGE, - number=164045879, - optional=True, - message="InstanceGroupManagerActionsSummary", - ) description = proto.Field(proto.STRING, number=422937596, optional=True,) - distribution_policy = proto.Field( - proto.MESSAGE, number=534558541, optional=True, message="DistributionPolicy", - ) - fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) id = proto.Field(proto.UINT64, number=3355, optional=True,) - instance_group = proto.Field(proto.STRING, number=81095253, optional=True,) - instance_template = proto.Field(proto.STRING, number=309248228, optional=True,) + interfaces = proto.RepeatedField( + proto.MESSAGE, number=12073562, message="ExternalVpnGatewayInterface", + ) kind = proto.Field(proto.STRING, number=3292052, optional=True,) + label_fingerprint = proto.Field(proto.STRING, number=178124825, optional=True,) + labels = proto.MapField(proto.STRING, proto.STRING, number=500195327,) name = proto.Field(proto.STRING, number=3373707, optional=True,) - named_ports = proto.RepeatedField( - proto.MESSAGE, number=427598732, message="NamedPort", + redundancy_type = proto.Field( + proto.ENUM, number=271443740, optional=True, enum=RedundancyType, ) - region = proto.Field(proto.STRING, number=138946292, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - stateful_policy = proto.Field( - proto.MESSAGE, number=47538565, optional=True, message="StatefulPolicy", - ) - status = proto.Field( - proto.MESSAGE, - number=181260274, - optional=True, - message="InstanceGroupManagerStatus", - ) - target_pools = proto.RepeatedField(proto.STRING, number=336072617,) - target_size = proto.Field(proto.INT32, number=62880239, optional=True,) - update_policy = proto.Field( - proto.MESSAGE, - number=175809896, - optional=True, - message="InstanceGroupManagerUpdatePolicy", - ) - versions = proto.RepeatedField( - proto.MESSAGE, number=162430619, message="InstanceGroupManagerVersion", - ) - zone = proto.Field(proto.STRING, number=3744684, optional=True,) -class InstanceGroupManagersScopedList(proto.Message): - r""" +class ExternalVpnGatewayInterface(proto.Message): + r"""The interface for the external VPN gateway. Attributes: - instance_group_managers (Sequence[google.cloud.compute_v1.types.InstanceGroupManager]): - [Output Only] The list of managed instance groups that are - contained in the specified project and zone. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] The warning that replaces the list of managed - instance groups when the list is empty. + id (int): + The numeric ID of this interface. The allowed input values + for this id for different redundancy types of external VPN + gateway: - SINGLE_IP_INTERNALLY_REDUNDANT - 0 - + TWO_IPS_REDUNDANCY - 0, 1 - FOUR_IPS_REDUNDANCY - 0, 1, 2, 3 + ip_address (str): + IP address of the interface in the external + VPN gateway. Only IPv4 is supported. This IP + address can be either from your on-premise + gateway or another Cloud provider's VPN gateway, + it cannot be an IP address from Google Compute + Engine. """ - instance_group_managers = proto.RepeatedField( - proto.MESSAGE, number=214072592, message="InstanceGroupManager", - ) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) + id = proto.Field(proto.UINT32, number=3355, optional=True,) + ip_address = proto.Field(proto.STRING, number=406272220, optional=True,) -class InstanceGroupManagerAggregatedList(proto.Message): - r""" +class ExternalVpnGatewayList(proto.Message): + r"""Response to the list request, and contains a list of + externalVpnGateways. + Attributes: + etag (str): + id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.InstanceGroupManagerAggregatedList.ItemsEntry]): - A list of InstanceGroupManagersScopedList - resources. + items (Sequence[google.cloud.compute_v1.types.ExternalVpnGateway]): + A list of ExternalVpnGateway resources. kind (str): - [Output Only] The resource type, which is always - compute#instanceGroupManagerAggregatedList for an aggregated - list of managed instance groups. + [Output Only] Type of resource. Always + compute#externalVpnGatewayList for lists of + externalVpnGateways. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -11879,8 +12730,6 @@ class InstanceGroupManagerAggregatedList(proto.Message): to continue paging through the results. self_link (str): [Output Only] Server-defined URL for this resource. - unreachables (Sequence[str]): - [Output Only] Unreachable resources. warning (google.cloud.compute_v1.types.Warning): [Output Only] Informational warning message. """ @@ -11889,34 +12738,235 @@ class InstanceGroupManagerAggregatedList(proto.Message): def raw_page(self): return self - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.MapField( - proto.STRING, - proto.MESSAGE, - number=100526016, - message="InstanceGroupManagersScopedList", + etag = proto.Field(proto.STRING, number=3123477, optional=True,) + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="ExternalVpnGateway", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) + + +class FileContentBuffer(proto.Message): + r""" + Attributes: + content (str): + The raw content in the secure keys file. + file_type (google.cloud.compute_v1.types.FileContentBuffer.FileType): + The file type of source file. + """ + + class FileType(proto.Enum): + r"""The file type of source file.""" + UNDEFINED_FILE_TYPE = 0 + BIN = 65767 + UNDEFINED = 137851184 + X509 = 2674086 + + content = proto.Field(proto.STRING, number=414659705, optional=True,) + file_type = proto.Field(proto.ENUM, number=294346781, optional=True, enum=FileType,) + + +class Firewall(proto.Message): + r"""Represents a Firewall Rule resource. Firewall rules allow or + deny ingress traffic to, and egress traffic from your instances. + For more information, read Firewall rules. + + Attributes: + allowed (Sequence[google.cloud.compute_v1.types.Allowed]): + The list of ALLOW rules specified by this + firewall. Each rule specifies a protocol and + port-range tuple that describes a permitted + connection. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + denied (Sequence[google.cloud.compute_v1.types.Denied]): + The list of DENY rules specified by this + firewall. Each rule specifies a protocol and + port-range tuple that describes a denied + connection. + description (str): + An optional description of this resource. + Provide this field when you create the resource. + destination_ranges (Sequence[str]): + If destination ranges are specified, the + firewall rule applies only to traffic that has + destination IP address in these ranges. These + ranges must be expressed in CIDR format. Both + IPv4 and IPv6 are supported. + direction (google.cloud.compute_v1.types.Firewall.Direction): + Direction of traffic to which this firewall applies, either + ``INGRESS`` or ``EGRESS``. The default is ``INGRESS``. For + ``INGRESS`` traffic, you cannot specify the + destinationRanges field, and for ``EGRESS`` traffic, you + cannot specify the sourceRanges or sourceTags fields. + disabled (bool): + Denotes whether the firewall rule is + disabled. When set to true, the firewall rule is + not enforced and the network behaves as if it + did not exist. If this is unspecified, the + firewall rule will be enabled. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + kind (str): + [Output Only] Type of the resource. Always compute#firewall + for firewall rules. + log_config (google.cloud.compute_v1.types.FirewallLogConfig): + This field denotes the logging options for a + particular firewall rule. If logging is enabled, + logs will be exported to Cloud Logging. + name (str): + Name of the resource; provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + `a-z <[-a-z0-9]*[a-z0-9]>`__?. The first character must be a + lowercase letter, and all following characters (except for + the last character) must be a dash, lowercase letter, or + digit. The last character must be a lowercase letter or + digit. + network (str): + URL of the network resource for this firewall + rule. If not specified when creating a firewall + rule, the default network is used: + global/networks/default If you choose to specify + this field, you can specify the network as a + full or partial URL. For example, the following + are all valid URLs: - + https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my- + network - projects/myproject/global/networks/my- + network - global/networks/default + priority (int): + Priority for this rule. This is an integer between ``0`` and + ``65535``, both inclusive. The default value is ``1000``. + Relative priorities determine which rule takes effect if + multiple rules apply. Lower values indicate higher priority. + For example, a rule with priority ``0`` has higher + precedence than a rule with priority ``1``. DENY rules take + precedence over ALLOW rules if they have equal priority. + Note that VPC networks have implied rules with a priority of + ``65535``. To avoid conflicts with the implied rules, use a + priority number less than ``65535``. + self_link (str): + [Output Only] Server-defined URL for the resource. + source_ranges (Sequence[str]): + If source ranges are specified, the firewall + rule applies only to traffic that has a source + IP address in these ranges. These ranges must be + expressed in CIDR format. One or both of + sourceRanges and sourceTags may be set. If both + fields are set, the rule applies to traffic that + has a source IP address within sourceRanges OR a + source IP from a resource with a matching tag + listed in the sourceTags field. The connection + does not need to match both fields for the rule + to apply. Both IPv4 and IPv6 are supported. + source_service_accounts (Sequence[str]): + If source service accounts are specified, the + firewall rules apply only to traffic originating + from an instance with a service account in this + list. Source service accounts cannot be used to + control traffic to an instance's external IP + address because service accounts are associated + with an instance, not an IP address. + sourceRanges can be set at the same time as + sourceServiceAccounts. If both are set, the + firewall applies to traffic that has a source IP + address within the sourceRanges OR a source IP + that belongs to an instance with service account + listed in sourceServiceAccount. The connection + does not need to match both fields for the + firewall to apply. sourceServiceAccounts cannot + be used at the same time as sourceTags or + targetTags. + source_tags (Sequence[str]): + If source tags are specified, the firewall + rule applies only to traffic with source IPs + that match the primary network interfaces of VM + instances that have the tag and are in the same + VPC network. Source tags cannot be used to + control traffic to an instance's external IP + address, it only applies to traffic between + instances in the same virtual network. Because + tags are associated with instances, not IP + addresses. One or both of sourceRanges and + sourceTags may be set. If both fields are set, + the firewall applies to traffic that has a + source IP address within sourceRanges OR a + source IP from a resource with a matching tag + listed in the sourceTags field. The connection + does not need to match both fields for the + firewall to apply. + target_service_accounts (Sequence[str]): + A list of service accounts indicating sets of instances + located in the network that may make network connections as + specified in allowed[]. targetServiceAccounts cannot be used + at the same time as targetTags or sourceTags. If neither + targetServiceAccounts nor targetTags are specified, the + firewall rule applies to all instances on the specified + network. + target_tags (Sequence[str]): + A list of tags that controls which instances + the firewall rule applies to. If targetTags are + specified, then the firewall rule applies only + to instances in the VPC network that have one of + those tags. If no targetTags are specified, the + firewall rule applies to all instances on the + specified network. + """ + + class Direction(proto.Enum): + r"""Direction of traffic to which this firewall applies, either + ``INGRESS`` or ``EGRESS``. The default is ``INGRESS``. For + ``INGRESS`` traffic, you cannot specify the destinationRanges field, + and for ``EGRESS`` traffic, you cannot specify the sourceRanges or + sourceTags fields. + """ + UNDEFINED_DIRECTION = 0 + EGRESS = 432880501 + INGRESS = 516931221 + + allowed = proto.RepeatedField(proto.MESSAGE, number=162398632, message="Allowed",) + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + denied = proto.RepeatedField(proto.MESSAGE, number=275217307, message="Denied",) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + destination_ranges = proto.RepeatedField(proto.STRING, number=305699879,) + direction = proto.Field( + proto.ENUM, number=111150975, optional=True, enum=Direction, ) + disabled = proto.Field(proto.BOOL, number=270940796, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - unreachables = proto.RepeatedField(proto.STRING, number=243372063,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + log_config = proto.Field( + proto.MESSAGE, number=351299741, optional=True, message="FirewallLogConfig", ) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + network = proto.Field(proto.STRING, number=232872494, optional=True,) + priority = proto.Field(proto.INT32, number=445151652, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + source_ranges = proto.RepeatedField(proto.STRING, number=200097658,) + source_service_accounts = proto.RepeatedField(proto.STRING, number=105100756,) + source_tags = proto.RepeatedField(proto.STRING, number=452222397,) + target_service_accounts = proto.RepeatedField(proto.STRING, number=457639710,) + target_tags = proto.RepeatedField(proto.STRING, number=62901767,) -class InstanceGroupManagerList(proto.Message): - r"""[Output Only] A list of managed instance groups. +class FirewallList(proto.Message): + r"""Contains a list of firewalls. Attributes: id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.InstanceGroupManager]): - A list of InstanceGroupManager resources. + items (Sequence[google.cloud.compute_v1.types.Firewall]): + A list of Firewall resources. kind (str): - [Output Only] The resource type, which is always - compute#instanceGroupManagerList for a list of managed - instance groups. + [Output Only] Type of resource. Always compute#firewallList + for lists of firewalls. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -11935,9 +12985,7 @@ def raw_page(self): return self id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="InstanceGroupManager", - ) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Firewall",) kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) @@ -11946,428 +12994,181 @@ def raw_page(self): ) -class InstanceGroupManagerStatusStateful(proto.Message): - r""" - Attributes: - has_stateful_config (bool): - [Output Only] A bit indicating whether the managed instance - group has stateful configuration, that is, if you have - configured any items in a stateful policy or in per-instance - configs. The group might report that it has no stateful - config even when there is still some preserved state on a - managed instance, for example, if you have deleted all PICs - but not yet applied those deletions. - per_instance_configs (google.cloud.compute_v1.types.InstanceGroupManagerStatusStatefulPerInstanceConfigs): - [Output Only] Status of per-instance configs on the - instance. - """ - - has_stateful_config = proto.Field(proto.BOOL, number=110474224, optional=True,) - per_instance_configs = proto.Field( - proto.MESSAGE, - number=526265001, - optional=True, - message="InstanceGroupManagerStatusStatefulPerInstanceConfigs", - ) - - -class InstanceGroupManagerStatusVersionTarget(proto.Message): - r""" - Attributes: - is_reached (bool): - [Output Only] A bit indicating whether version target has - been reached in this managed instance group, i.e. all - instances are in their target version. Instances' target - version are specified by version field on Instance Group - Manager. - """ - - is_reached = proto.Field(proto.BOOL, number=433209149, optional=True,) - - -class InstanceGroupManagerStatusStatefulPerInstanceConfigs(proto.Message): - r""" - Attributes: - all_effective (bool): - A bit indicating if all of the group's per- - nstance configs (listed in the output of a - listPerInstanceConfigs API call) have status - EFFECTIVE or there are no per-instance-configs. - """ - - all_effective = proto.Field(proto.BOOL, number=516540553, optional=True,) - - -class InstanceGroupManagersAbandonInstancesRequest(proto.Message): - r""" - Attributes: - instances (Sequence[str]): - The URLs of one or more instances to abandon. This can be a - full URL or a partial URL, such as - zones/[ZONE]/instances/[INSTANCE_NAME]. - """ - - instances = proto.RepeatedField(proto.STRING, number=29097598,) - - -class InstanceGroupManagersApplyUpdatesRequest(proto.Message): - r"""InstanceGroupManagers.applyUpdatesToInstances - Attributes: - all_instances (bool): - Flag to update all instances instead of - specified list of ?instances?. If the flag is - set to true then the instances may not be - specified in the request. - instances (Sequence[str]): - The list of URLs of one or more instances for which you want - to apply updates. Each URL can be a full URL or a partial - URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. - minimal_action (str): - The minimal action that you want to perform - on each instance during the update: - REPLACE: - At minimum, delete the instance and create it - again. - RESTART: Stop the instance and start it - again. - REFRESH: Do not stop the instance. - - NONE: Do not disrupt the instance at all. By - default, the minimum action is NONE. If your - update requires a more disruptive action than - you set with this flag, the necessary action is - performed to execute the update. - most_disruptive_allowed_action (str): - The most disruptive action that you want to - perform on each instance during the update: - - REPLACE: Delete the instance and create it - again. - RESTART: Stop the instance and start it - again. - REFRESH: Do not stop the instance. - - NONE: Do not disrupt the instance at all. By - default, the most disruptive allowed action is - REPLACE. If your update requires a more - disruptive action than you set with this flag, - the update request will fail. - """ - - all_instances = proto.Field(proto.BOOL, number=403676512, optional=True,) - instances = proto.RepeatedField(proto.STRING, number=29097598,) - minimal_action = proto.Field(proto.STRING, number=270567060, optional=True,) - most_disruptive_allowed_action = proto.Field( - proto.STRING, number=66103053, optional=True, - ) - - -class PerInstanceConfig(proto.Message): - r""" +class FirewallLogConfig(proto.Message): + r"""The available logging options for a firewall rule. Attributes: - fingerprint (str): - Fingerprint of this per-instance config. This - field can be used in optimistic locking. It is - ignored when inserting a per-instance config. An - up-to-date fingerprint must be provided in order - to update an existing per-instance config or the - field needs to be unset. - name (str): - The name of a per-instance config and its - corresponding instance. Serves as a merge key - during UpdatePerInstanceConfigs operations, that - is, if a per-instance config with the same name - exists then it will be updated, otherwise a new - one will be created for the VM instance with the - same name. An attempt to create a per-instance - config for a VM instance that either doesn't - exist or is not part of the group will result in - an error. - preserved_state (google.cloud.compute_v1.types.PreservedState): - The intended preserved state for the given - instance. Does not contain preserved state - generated from a stateful policy. - status (google.cloud.compute_v1.types.PerInstanceConfig.Status): - The status of applying this per-instance - config on the corresponding managed instance. + enable (bool): + This field denotes whether to enable logging + for a particular firewall rule. + metadata (google.cloud.compute_v1.types.FirewallLogConfig.Metadata): + This field can only be specified for a + particular firewall rule if logging is enabled + for that rule. This field denotes whether to + include or exclude metadata for firewall logs. """ - class Status(proto.Enum): - r"""The status of applying this per-instance config on the - corresponding managed instance. + class Metadata(proto.Enum): + r"""This field can only be specified for a particular firewall + rule if logging is enabled for that rule. This field denotes + whether to include or exclude metadata for firewall logs. """ - UNDEFINED_STATUS = 0 - APPLYING = 352003508 - DELETING = 528602024 - EFFECTIVE = 244201863 - NONE = 2402104 - UNAPPLIED = 483935140 - UNAPPLIED_DELETION = 313956873 - - fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - preserved_state = proto.Field( - proto.MESSAGE, number=2634026, optional=True, message="PreservedState", - ) - status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) - - -class InstanceGroupManagersCreateInstancesRequest(proto.Message): - r"""InstanceGroupManagers.createInstances - Attributes: - instances (Sequence[google.cloud.compute_v1.types.PerInstanceConfig]): - [Required] List of specifications of per-instance configs. - """ - - instances = proto.RepeatedField( - proto.MESSAGE, number=29097598, message="PerInstanceConfig", - ) - - -class InstanceGroupManagersDeleteInstancesRequest(proto.Message): - r""" - Attributes: - instances (Sequence[str]): - The URLs of one or more instances to delete. This can be a - full URL or a partial URL, such as - zones/[ZONE]/instances/[INSTANCE_NAME]. - """ - - instances = proto.RepeatedField(proto.STRING, number=29097598,) - - -class InstanceGroupManagersDeletePerInstanceConfigsReq(proto.Message): - r"""InstanceGroupManagers.deletePerInstanceConfigs - Attributes: - names (Sequence[str]): - The list of instance names for which we want - to delete per-instance configs on this managed - instance group. - """ - - names = proto.RepeatedField(proto.STRING, number=104585032,) - - -class InstanceManagedByIgmError(proto.Message): - r""" - Attributes: - error (google.cloud.compute_v1.types.InstanceManagedByIgmErrorManagedInstanceError): - [Output Only] Contents of the error. - instance_action_details (google.cloud.compute_v1.types.InstanceManagedByIgmErrorInstanceActionDetails): - [Output Only] Details of the instance action that triggered - this error. May be null, if the error was not caused by an - action on an instance. This field is optional. - timestamp (str): - [Output Only] The time that this error occurred. This value - is in RFC3339 text format. - """ + UNDEFINED_METADATA = 0 + EXCLUDE_ALL_METADATA = 334519954 + INCLUDE_ALL_METADATA = 164619908 - error = proto.Field( - proto.MESSAGE, - number=96784904, - optional=True, - message="InstanceManagedByIgmErrorManagedInstanceError", - ) - instance_action_details = proto.Field( - proto.MESSAGE, - number=292224547, - optional=True, - message="InstanceManagedByIgmErrorInstanceActionDetails", - ) - timestamp = proto.Field(proto.STRING, number=55126294, optional=True,) + enable = proto.Field(proto.BOOL, number=311764355, optional=True,) + metadata = proto.Field(proto.ENUM, number=86866735, optional=True, enum=Metadata,) -class InstanceGroupManagersListErrorsResponse(proto.Message): +class FirewallPoliciesListAssociationsResponse(proto.Message): r""" Attributes: - items (Sequence[google.cloud.compute_v1.types.InstanceManagedByIgmError]): - [Output Only] The list of errors of the managed instance - group. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. + associations (Sequence[google.cloud.compute_v1.types.FirewallPolicyAssociation]): + A list of associations. + kind (str): + [Output Only] Type of firewallPolicy associations. Always + compute#FirewallPoliciesListAssociations for lists of + firewallPolicy associations. """ - @property - def raw_page(self): - return self - - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="InstanceManagedByIgmError", + associations = proto.RepeatedField( + proto.MESSAGE, number=508736530, message="FirewallPolicyAssociation", ) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) -class ManagedInstance(proto.Message): - r"""A Managed Instance resource. +class FirewallPolicy(proto.Message): + r"""Represents a Firewall Policy resource. Attributes: - current_action (google.cloud.compute_v1.types.ManagedInstance.CurrentAction): - [Output Only] The current action that the managed instance - group has scheduled for the instance. Possible values: - - - NONE The instance is running, and the managed instance - group does not have any scheduled actions for this - instance. - - CREATING The managed instance group is creating this - instance. If the group fails to create this instance, it - will try again until it is successful. - - CREATING_WITHOUT_RETRIES The managed instance group is - attempting to create this instance only once. If the - group fails to create this instance, it does not try - again and the group's targetSize value is decreased - instead. - - RECREATING The managed instance group is recreating this - instance. - - DELETING The managed instance group is permanently - deleting this instance. - - ABANDONING The managed instance group is abandoning this - instance. The instance will be removed from the instance - group and from any target pools that are associated with - this group. - - RESTARTING The managed instance group is restarting the - instance. - - REFRESHING The managed instance group is applying - configuration changes to the instance without stopping - it. For example, the group can update the target pool - list for an instance without stopping that instance. - - VERIFYING The managed instance group has created the - instance and it is in the process of being verified. + associations (Sequence[google.cloud.compute_v1.types.FirewallPolicyAssociation]): + A list of associations that belong to this + firewall policy. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + display_name (str): + Deprecated, please use short name instead. User-provided + name of the Organization firewall policy. The name should be + unique in the organization in which the firewall policy is + created. This name must be set on creation and cannot be + changed. The name must be 1-63 characters long, and comply + with RFC1035. Specifically, the name must be 1-63 characters + long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. + fingerprint (str): + Specifies a fingerprint for this resource, + which is essentially a hash of the metadata's + contents and used for optimistic locking. The + fingerprint is initially generated by Compute + Engine and changes after every request to modify + or update metadata. You must always provide an + up-to-date fingerprint hash in order to update + or change metadata, otherwise the request will + fail with error 412 conditionNotMet. To see the + latest fingerprint, make get() request to the + firewall policy. id (int): - [Output only] The unique identifier for this resource. This - field is empty when instance does not exist. - instance (str): - [Output Only] The URL of the instance. The URL can exist - even if the instance has not yet been created. - instance_health (Sequence[google.cloud.compute_v1.types.ManagedInstanceInstanceHealth]): - [Output Only] Health state of the instance per health-check. - instance_status (google.cloud.compute_v1.types.ManagedInstance.InstanceStatus): - [Output Only] The status of the instance. This field is - empty when the instance does not exist. - last_attempt (google.cloud.compute_v1.types.ManagedInstanceLastAttempt): - [Output Only] Information about the last attempt to create - or delete the instance. - preserved_state_from_config (google.cloud.compute_v1.types.PreservedState): - [Output Only] Preserved state applied from per-instance - config for this instance. - preserved_state_from_policy (google.cloud.compute_v1.types.PreservedState): - [Output Only] Preserved state generated based on stateful - policy for this instance. - version (google.cloud.compute_v1.types.ManagedInstanceVersion): - [Output Only] Intended version of this instance. + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + kind (str): + [Output only] Type of the resource. Always + compute#firewallPolicyfor firewall policies + name (str): + [Output Only] Name of the resource. It is a numeric ID + allocated by GCP which uniquely identifies the Firewall + Policy. + parent (str): + [Output Only] The parent of the firewall policy. + rule_tuple_count (int): + [Output Only] Total count of all firewall policy rule + tuples. A firewall policy can not exceed a set number of + tuples. + rules (Sequence[google.cloud.compute_v1.types.FirewallPolicyRule]): + A list of rules that belong to this policy. There must + always be a default rule (rule with priority 2147483647 and + match "*"). If no rules are provided when creating a + firewall policy, a default rule with action "allow" will be + added. + self_link (str): + [Output Only] Server-defined URL for the resource. + self_link_with_id (str): + [Output Only] Server-defined URL for this resource with the + resource id. + short_name (str): + User-provided name of the Organization firewall plicy. The + name should be unique in the organization in which the + firewall policy is created. This name must be set on + creation and cannot be changed. The name must be 1-63 + characters long, and comply with RFC1035. Specifically, the + name must be 1-63 characters long and match the regular + expression ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the + first character must be a lowercase letter, and all + following characters must be a dash, lowercase letter, or + digit, except the last character, which cannot be a dash. """ - class CurrentAction(proto.Enum): - r"""[Output Only] The current action that the managed instance group has - scheduled for the instance. Possible values: - - - NONE The instance is running, and the managed instance group does - not have any scheduled actions for this instance. - - CREATING The managed instance group is creating this instance. If - the group fails to create this instance, it will try again until - it is successful. - - CREATING_WITHOUT_RETRIES The managed instance group is attempting - to create this instance only once. If the group fails to create - this instance, it does not try again and the group's targetSize - value is decreased instead. - - RECREATING The managed instance group is recreating this - instance. - - DELETING The managed instance group is permanently deleting this - instance. - - ABANDONING The managed instance group is abandoning this - instance. The instance will be removed from the instance group - and from any target pools that are associated with this group. - - RESTARTING The managed instance group is restarting the instance. - - REFRESHING The managed instance group is applying configuration - changes to the instance without stopping it. For example, the - group can update the target pool list for an instance without - stopping that instance. - - VERIFYING The managed instance group has created the instance and - it is in the process of being verified. - """ - UNDEFINED_CURRENT_ACTION = 0 - ABANDONING = 388244813 - CREATING = 455564985 - CREATING_WITHOUT_RETRIES = 428843785 - DELETING = 528602024 - NONE = 2402104 - RECREATING = 287278572 - REFRESHING = 163266343 - RESTARTING = 320534387 - VERIFYING = 16982185 - - class InstanceStatus(proto.Enum): - r"""[Output Only] The status of the instance. This field is empty when - the instance does not exist. - """ - UNDEFINED_INSTANCE_STATUS = 0 - DEPROVISIONING = 428935662 - PROVISIONING = 290896621 - REPAIRING = 413483285 - RUNNING = 121282975 - STAGING = 431072283 - STOPPED = 444276141 - STOPPING = 350791796 - SUSPENDED = 51223995 - SUSPENDING = 514206246 - TERMINATED = 250018339 - - current_action = proto.Field( - proto.ENUM, number=178475964, optional=True, enum=CurrentAction, + associations = proto.RepeatedField( + proto.MESSAGE, number=508736530, message="FirewallPolicyAssociation", ) + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + display_name = proto.Field(proto.STRING, number=4473832, optional=True,) + fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) id = proto.Field(proto.UINT64, number=3355, optional=True,) - instance = proto.Field(proto.STRING, number=18257045, optional=True,) - instance_health = proto.RepeatedField( - proto.MESSAGE, number=382667078, message="ManagedInstanceInstanceHealth", - ) - instance_status = proto.Field( - proto.ENUM, number=174577372, optional=True, enum=InstanceStatus, - ) - last_attempt = proto.Field( - proto.MESSAGE, - number=434771492, - optional=True, - message="ManagedInstanceLastAttempt", - ) - preserved_state_from_config = proto.Field( - proto.MESSAGE, number=98661858, optional=True, message="PreservedState", - ) - preserved_state_from_policy = proto.Field( - proto.MESSAGE, number=470783954, optional=True, message="PreservedState", - ) - version = proto.Field( - proto.MESSAGE, - number=351608024, - optional=True, - message="ManagedInstanceVersion", + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + parent = proto.Field(proto.STRING, number=78317738, optional=True,) + rule_tuple_count = proto.Field(proto.INT32, number=388342037, optional=True,) + rules = proto.RepeatedField( + proto.MESSAGE, number=108873975, message="FirewallPolicyRule", ) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + self_link_with_id = proto.Field(proto.STRING, number=44520962, optional=True,) + short_name = proto.Field(proto.STRING, number=492051566, optional=True,) -class InstanceGroupManagersListManagedInstancesResponse(proto.Message): +class FirewallPolicyAssociation(proto.Message): r""" Attributes: - managed_instances (Sequence[google.cloud.compute_v1.types.ManagedInstance]): - [Output Only] The list of instances in the managed instance - group. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. + attachment_target (str): + The target that the firewall policy is + attached to. + display_name (str): + [Output Only] Deprecated, please use short name instead. The + display name of the firewall policy of the association. + firewall_policy_id (str): + [Output Only] The firewall policy ID of the association. + name (str): + The name for an association. + short_name (str): + [Output Only] The short name of the firewall policy of the + association. """ - @property - def raw_page(self): - return self - - managed_instances = proto.RepeatedField( - proto.MESSAGE, number=336219614, message="ManagedInstance", - ) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + attachment_target = proto.Field(proto.STRING, number=175773741, optional=True,) + display_name = proto.Field(proto.STRING, number=4473832, optional=True,) + firewall_policy_id = proto.Field(proto.STRING, number=357211849, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + short_name = proto.Field(proto.STRING, number=492051566, optional=True,) -class InstanceGroupManagersListPerInstanceConfigsResp(proto.Message): +class FirewallPolicyList(proto.Message): r""" - Attributes: - items (Sequence[google.cloud.compute_v1.types.PerInstanceConfig]): - [Output Only] The list of PerInstanceConfig. + Attributes: + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.FirewallPolicy]): + A list of FirewallPolicy resources. + kind (str): + [Output Only] Type of resource. Always + compute#firewallPolicyList for listsof FirewallPolicies next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -12383,269 +13184,536 @@ class InstanceGroupManagersListPerInstanceConfigsResp(proto.Message): def raw_page(self): return self + id = proto.Field(proto.STRING, number=3355, optional=True,) items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="PerInstanceConfig", + proto.MESSAGE, number=100526016, message="FirewallPolicy", ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) warning = proto.Field( proto.MESSAGE, number=50704284, optional=True, message="Warning", ) -class InstanceGroupManagersPatchPerInstanceConfigsReq(proto.Message): - r"""InstanceGroupManagers.patchPerInstanceConfigs - Attributes: - per_instance_configs (Sequence[google.cloud.compute_v1.types.PerInstanceConfig]): - The list of per-instance configs to insert or - patch on this managed instance group. - """ - - per_instance_configs = proto.RepeatedField( - proto.MESSAGE, number=526265001, message="PerInstanceConfig", - ) - - -class InstanceGroupManagersRecreateInstancesRequest(proto.Message): - r""" - Attributes: - instances (Sequence[str]): - The URLs of one or more instances to recreate. This can be a - full URL or a partial URL, such as - zones/[ZONE]/instances/[INSTANCE_NAME]. - """ - - instances = proto.RepeatedField(proto.STRING, number=29097598,) - +class FirewallPolicyRule(proto.Message): + r"""Represents a rule that describes one or more match conditions + along with the action to be taken when traffic matches this + condition (allow or deny). -class InstanceGroupManagersSetInstanceTemplateRequest(proto.Message): - r""" Attributes: - instance_template (str): - The URL of the instance template that is - specified for this managed instance group. The - group uses this template to create all new - instances in the managed instance group. The - templates for existing instances in the group do - not change unless you run recreateInstances, run - applyUpdatesToInstances, or set the group's - updatePolicy.type to PROACTIVE. + action (str): + The Action to perform when the client + connection triggers the rule. Can currently be + either "allow" or "deny()" where valid values + for status are 403, 404, and 502. + description (str): + An optional description for this resource. + direction (google.cloud.compute_v1.types.FirewallPolicyRule.Direction): + The direction in which this rule applies. + disabled (bool): + Denotes whether the firewall policy rule is + disabled. When set to true, the firewall policy + rule is not enforced and traffic behaves as if + it did not exist. If this is unspecified, the + firewall policy rule will be enabled. + enable_logging (bool): + Denotes whether to enable logging for a particular rule. If + logging is enabled, logs will be exported to the configured + export destination in Stackdriver. Logs may be exported to + BigQuery or Pub/Sub. Note: you cannot enable logging on + "goto_next" rules. + kind (str): + [Output only] Type of the resource. Always + compute#firewallPolicyRule for firewall policy rules + match (google.cloud.compute_v1.types.FirewallPolicyRuleMatcher): + A match condition that incoming traffic is + evaluated against. If it evaluates to true, the + corresponding 'action' is enforced. + priority (int): + An integer indicating the priority of a rule + in the list. The priority must be a positive + value between 0 and 2147483647. Rules are + evaluated from highest to lowest priority where + 0 is the highest priority and 2147483647 is the + lowest prority. + rule_tuple_count (int): + [Output Only] Calculation of the complexity of a single + firewall policy rule. + target_resources (Sequence[str]): + A list of network resource URLs to which this + rule applies. This field allows you to control + which network's VMs get this rule. If this field + is left blank, all VMs within the organization + will receive the rule. + target_service_accounts (Sequence[str]): + A list of service accounts indicating the + sets of instances that are applied with this + rule. """ - instance_template = proto.Field(proto.STRING, number=309248228, optional=True,) - + class Direction(proto.Enum): + r"""The direction in which this rule applies.""" + UNDEFINED_DIRECTION = 0 + EGRESS = 432880501 + INGRESS = 516931221 -class InstanceGroupManagersSetTargetPoolsRequest(proto.Message): - r""" - Attributes: - fingerprint (str): - The fingerprint of the target pools - information. Use this optional property to - prevent conflicts when multiple users change the - target pools settings concurrently. Obtain the - fingerprint with the instanceGroupManagers.get - method. Then, include the fingerprint in your - request to ensure that you do not overwrite - changes that were applied from another - concurrent request. - target_pools (Sequence[str]): - The list of target pool URLs that instances - in this managed instance group belong to. The - managed instance group applies these target - pools to all of the instances in the group. - Existing instances and new instances in the - group all receive these target pool settings. - """ + action = proto.Field(proto.STRING, number=187661878, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + direction = proto.Field( + proto.ENUM, number=111150975, optional=True, enum=Direction, + ) + disabled = proto.Field(proto.BOOL, number=270940796, optional=True,) + enable_logging = proto.Field(proto.BOOL, number=295396515, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + match = proto.Field( + proto.MESSAGE, + number=103668165, + optional=True, + message="FirewallPolicyRuleMatcher", + ) + priority = proto.Field(proto.INT32, number=445151652, optional=True,) + rule_tuple_count = proto.Field(proto.INT32, number=388342037, optional=True,) + target_resources = proto.RepeatedField(proto.STRING, number=528230647,) + target_service_accounts = proto.RepeatedField(proto.STRING, number=457639710,) - fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) - target_pools = proto.RepeatedField(proto.STRING, number=336072617,) +class FirewallPolicyRuleMatcher(proto.Message): + r"""Represents a match condition that incoming traffic is + evaluated against. Exactly one field must be specified. -class InstanceGroupManagersUpdatePerInstanceConfigsReq(proto.Message): - r"""InstanceGroupManagers.updatePerInstanceConfigs Attributes: - per_instance_configs (Sequence[google.cloud.compute_v1.types.PerInstanceConfig]): - The list of per-instance configs to insert or - patch on this managed instance group. + dest_ip_ranges (Sequence[str]): + CIDR IP address range. Maximum number of + destination CIDR IP ranges allowed is 5000. + layer4_configs (Sequence[google.cloud.compute_v1.types.FirewallPolicyRuleMatcherLayer4Config]): + Pairs of IP protocols and ports that the rule + should match. + src_ip_ranges (Sequence[str]): + CIDR IP address range. Maximum number of + source CIDR IP ranges allowed is 5000. """ - per_instance_configs = proto.RepeatedField( - proto.MESSAGE, number=526265001, message="PerInstanceConfig", + dest_ip_ranges = proto.RepeatedField(proto.STRING, number=337357713,) + layer4_configs = proto.RepeatedField( + proto.MESSAGE, + number=373534261, + message="FirewallPolicyRuleMatcherLayer4Config", ) + src_ip_ranges = proto.RepeatedField(proto.STRING, number=432128083,) -class InstanceReference(proto.Message): +class FirewallPolicyRuleMatcherLayer4Config(proto.Message): r""" Attributes: - instance (str): - The URL for a specific instance. + ip_protocol (str): + The IP protocol to which this rule applies. + The protocol type is required when creating a + firewall rule. This value can either be one of + the following well known protocol strings (tcp, + udp, icmp, esp, ah, ipip, sctp), or the IP + protocol number. + ports (Sequence[str]): + An optional list of ports to which this rule applies. This + field is only applicable for UDP or TCP protocol. Each entry + must be either an integer or a range. If not specified, this + rule applies to connections through any port. Example inputs + include: ["22"], ["80","443"], and ["12345-12349"]. """ - instance = proto.Field(proto.STRING, number=18257045, optional=True,) - - -class InstanceGroupsAddInstancesRequest(proto.Message): - r""" - Attributes: - instances (Sequence[google.cloud.compute_v1.types.InstanceReference]): - The list of instances to add to the instance - group. - """ + ip_protocol = proto.Field(proto.STRING, number=475958960, optional=True,) + ports = proto.RepeatedField(proto.STRING, number=106854418,) - instances = proto.RepeatedField( - proto.MESSAGE, number=29097598, message="InstanceReference", - ) +class FixedOrPercent(proto.Message): + r"""Encapsulates numeric value that can be either absolute or + relative. -class InstanceWithNamedPorts(proto.Message): - r""" Attributes: - instance (str): - [Output Only] The URL of the instance. - named_ports (Sequence[google.cloud.compute_v1.types.NamedPort]): - [Output Only] The named ports that belong to this instance - group. - status (google.cloud.compute_v1.types.InstanceWithNamedPorts.Status): - [Output Only] The status of the instance. + calculated (int): + [Output Only] Absolute value of VM instances calculated + based on the specific mode. - If the value is fixed, then + the calculated value is equal to the fixed value. - If the + value is a percent, then the calculated value is percent/100 + \* targetSize. For example, the calculated value of a 80% of + a managed instance group with 150 instances would be (80/100 + \* 150) = 120 VM instances. If there is a remainder, the + number is rounded. + fixed (int): + Specifies a fixed number of VM instances. + This must be a positive integer. + percent (int): + Specifies a percentage of instances between 0 + to 100%, inclusive. For example, specify 80 for + 80%. """ - class Status(proto.Enum): - r"""[Output Only] The status of the instance.""" - UNDEFINED_STATUS = 0 - DEPROVISIONING = 428935662 - PROVISIONING = 290896621 - REPAIRING = 413483285 - RUNNING = 121282975 - STAGING = 431072283 - STOPPED = 444276141 - STOPPING = 350791796 - SUSPENDED = 51223995 - SUSPENDING = 514206246 - TERMINATED = 250018339 + calculated = proto.Field(proto.INT32, number=472082878, optional=True,) + fixed = proto.Field(proto.INT32, number=97445748, optional=True,) + percent = proto.Field(proto.INT32, number=394814533, optional=True,) - instance = proto.Field(proto.STRING, number=18257045, optional=True,) - named_ports = proto.RepeatedField( - proto.MESSAGE, number=427598732, message="NamedPort", - ) - status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) +class ForwardingRule(proto.Message): + r"""Represents a Forwarding Rule resource. Forwarding rule resources in + Google Cloud can be either regional or global in scope: \* + `Global `__ + \* + `Regional `__ + A forwarding rule and its corresponding IP address represent the + frontend configuration of a Google Cloud Platform load balancer. + Forwarding rules can also reference target instances and Cloud VPN + Classic gateways (targetVpnGateway). For more information, read + Forwarding rule concepts and Using protocol forwarding. -class InstanceGroupsListInstances(proto.Message): - r""" Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.InstanceWithNamedPorts]): - A list of InstanceWithNamedPorts resources. + I_p_address (str): + IP address that this forwarding rule serves. When a client + sends traffic to this IP address, the forwarding rule + directs the traffic to the target that you specify in the + forwarding rule. If you don't specify a reserved IP address, + an ephemeral IP address is assigned. Methods for specifying + an IP address: \* IPv4 dotted decimal, as in ``100.1.2.3`` + \* Full URL, as in + https://www.googleapis.com/compute/v1/projects/project_id/regions/region + /addresses/address-name \* Partial URL or by name, as in: - + projects/project_id/regions/region/addresses/address-name - + regions/region/addresses/address-name - + global/addresses/address-name - address-name The + loadBalancingScheme and the forwarding rule's target + determine the type of IP address that you can use. For + detailed information, see `IP address + specifications `__. + Must be set to ``0.0.0.0`` when the target is + targetGrpcProxy that has validateForProxyless field set to + true. For Private Service Connect forwarding rules that + forward traffic to Google APIs, IP address must be provided. + I_p_protocol (google.cloud.compute_v1.types.ForwardingRule.IPProtocol): + The IP protocol to which this rule applies. For protocol + forwarding, valid options are TCP, UDP, ESP, AH, SCTP, ICMP + and L3_DEFAULT. The valid IP protocols are different for + different load balancing products as described in `Load + balancing + features `__. + all_ports (bool): + This field is used along with the backend_service field for + Internal TCP/UDP Load Balancing or Network Load Balancing, + or with the target field for internal and external + TargetInstance. You can only use one of ports and + port_range, or allPorts. The three are mutually exclusive. + For TCP, UDP and SCTP traffic, packets addressed to any + ports will be forwarded to the target or backendService. + allow_global_access (bool): + This field is used along with the backend_service field for + internal load balancing or with the target field for + internal TargetInstance. If the field is set to TRUE, + clients can access ILB from all regions. Otherwise only + allows access from clients in the same region as the + internal load balancer. + backend_service (str): + Identifies the backend service to which the + forwarding rule sends traffic. Required for + Internal TCP/UDP Load Balancing and Network Load + Balancing; must be omitted for all other load + balancer types. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + fingerprint (str): + Fingerprint of this resource. A hash of the + contents stored in this object. This field is + used in optimistic locking. This field will be + ignored when inserting a ForwardingRule. Include + the fingerprint in patch request to ensure that + you do not overwrite changes that were applied + from another concurrent request. To see the + latest fingerprint, make a get() request to + retrieve a ForwardingRule. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + ip_version (google.cloud.compute_v1.types.ForwardingRule.IpVersion): + The IP Version that will be used by this + forwarding rule. Valid options are IPV4 or IPV6. + This can only be specified for an external + global forwarding rule. + is_mirroring_collector (bool): + Indicates whether or not this load balancer + can be used as a collector for packet mirroring. + To prevent mirroring loops, instances behind + this load balancer will not have their traffic + mirrored even if a PacketMirroring rule applies + to them. This can only be set to true for load + balancers that have their loadBalancingScheme + set to INTERNAL. kind (str): - [Output Only] The resource type, which is always - compute#instanceGroupsListInstances for the list of - instances in the specified instance group. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. - """ - - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="InstanceWithNamedPorts", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) + [Output Only] Type of the resource. Always + compute#forwardingRule for Forwarding Rule resources. + label_fingerprint (str): + A fingerprint for the labels being applied to + this resource, which is essentially a hash of + the labels set used for optimistic locking. The + fingerprint is initially generated by Compute + Engine and changes after every request to modify + or update labels. You must always provide an up- + to-date fingerprint hash in order to update or + change labels, otherwise the request will fail + with error 412 conditionNotMet. To see the + latest fingerprint, make a get() request to + retrieve a ForwardingRule. + labels (Sequence[google.cloud.compute_v1.types.ForwardingRule.LabelsEntry]): + Labels for this resource. These can only be + added or modified by the setLabels method. Each + label key/value pair must comply with RFC1035. + Label values may be empty. + load_balancing_scheme (google.cloud.compute_v1.types.ForwardingRule.LoadBalancingScheme): + Specifies the forwarding rule type. For more + information about forwarding rules, refer to + Forwarding rule concepts. + metadata_filters (Sequence[google.cloud.compute_v1.types.MetadataFilter]): + Opaque filter criteria used by load balancer to restrict + routing configuration to a limited set of xDS compliant + clients. In their xDS requests to load balancer, xDS clients + present node metadata. When there is a match, the relevant + configuration is made available to those proxies. Otherwise, + all the resources (e.g. TargetHttpProxy, UrlMap) referenced + by the ForwardingRule are not visible to those proxies. For + each metadataFilter in this list, if its filterMatchCriteria + is set to MATCH_ANY, at least one of the filterLabels must + match the corresponding label provided in the metadata. If + its filterMatchCriteria is set to MATCH_ALL, then all of its + filterLabels must match with corresponding labels provided + in the metadata. If multiple metadataFilters are specified, + all of them need to be satisfied in order to be considered a + match. metadataFilters specified here will be applifed + before those specified in the UrlMap that this + ForwardingRule references. metadataFilters only applies to + Loadbalancers that have their loadBalancingScheme set to + INTERNAL_SELF_MANAGED. + name (str): + Name of the resource; provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. For + Private Service Connect forwarding rules that forward + traffic to Google APIs, the forwarding rule name must be a + 1-20 characters string with lowercase letters and numbers + and must start with a letter. + network (str): + This field is not used for external load + balancing. For Internal TCP/UDP Load Balancing, + this field identifies the network that the load + balanced IP should belong to for this Forwarding + Rule. If this field is not specified, the + default network will be used. For Private + Service Connect forwarding rules that forward + traffic to Google APIs, a network must be + provided. + network_tier (google.cloud.compute_v1.types.ForwardingRule.NetworkTier): + This signifies the networking tier used for + configuring this load balancer and can only take + the following values: PREMIUM, STANDARD. For + regional ForwardingRule, the valid values are + PREMIUM and STANDARD. For GlobalForwardingRule, + the valid value is PREMIUM. If this field is not + specified, it is assumed to be PREMIUM. If + IPAddress is specified, this value must be equal + to the networkTier of the Address. + port_range (str): + This field can be used only if: - Load balancing scheme is + one of EXTERNAL, INTERNAL_SELF_MANAGED or INTERNAL_MANAGED - + IPProtocol is one of TCP, UDP, or SCTP. Packets addressed to + ports in the specified range will be forwarded to target or + backend_service. You can only use one of ports, port_range, + or allPorts. The three are mutually exclusive. Forwarding + rules with the same [IPAddress, IPProtocol] pair must have + disjoint ports. Some types of forwarding target have + constraints on the acceptable ports. For more information, + see `Port + specifications `__. + @pattern: \\d+(?:-\d+)? + ports (Sequence[str]): + The ports field is only supported when the forwarding rule + references a backend_service directly. Only packets + addressed to the `specified list of + ports <(https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#port_specifications)>`__ + are forwarded to backends. You can only use one of ports and + port_range, or allPorts. The three are mutually exclusive. + You can specify a list of up to five ports, which can be + non-contiguous. Forwarding rules with the same [IPAddress, + IPProtocol] pair must have disjoint ports. @pattern: + \\d+(?:-\d+)? + psc_connection_id (int): + [Output Only] The PSC connection id of the PSC Forwarding + Rule. + psc_connection_status (google.cloud.compute_v1.types.ForwardingRule.PscConnectionStatus): + region (str): + [Output Only] URL of the region where the regional + forwarding rule resides. This field is not applicable to + global forwarding rules. You must specify this field as part + of the HTTP request URL. It is not settable as a field in + the request body. + self_link (str): + [Output Only] Server-defined URL for the resource. + service_directory_registrations (Sequence[google.cloud.compute_v1.types.ForwardingRuleServiceDirectoryRegistration]): + Service Directory resources to register this + forwarding rule with. Currently, only supports a + single Service Directory resource. It is only + supported for internal load balancing. + service_label (str): + An optional prefix to the service name for this Forwarding + Rule. If specified, the prefix is the first label of the + fully qualified service name. The label must be 1-63 + characters long, and comply with RFC1035. Specifically, the + label must be 1-63 characters long and match the regular + expression ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the + first character must be a lowercase letter, and all + following characters must be a dash, lowercase letter, or + digit, except the last character, which cannot be a dash. + This field is only used for internal load balancing. + service_name (str): + [Output Only] The internal fully qualified service name for + this Forwarding Rule. This field is only used for internal + load balancing. + subnetwork (str): + This field identifies the subnetwork that the + load balanced IP should belong to for this + Forwarding Rule, used in internal load balancing + and network load balancing with IPv6. If the + network specified is in auto subnet mode, this + field is optional. However, a subnetwork must be + specified if the network is in custom subnet + mode or when creating external forwarding rule + with IPv6. + target (str): -class InstanceGroupsListInstancesRequest(proto.Message): - r""" - Attributes: - instance_state (google.cloud.compute_v1.types.InstanceGroupsListInstancesRequest.InstanceState): - A filter for the state of the instances in - the instance group. Valid options are ALL or - RUNNING. If you do not specify this parameter - the list includes all instances regardless of - their state. """ - class InstanceState(proto.Enum): - r"""A filter for the state of the instances in the instance - group. Valid options are ALL or RUNNING. If you do not specify - this parameter the list includes all instances regardless of - their state. + class IPProtocol(proto.Enum): + r"""The IP protocol to which this rule applies. For protocol forwarding, + valid options are TCP, UDP, ESP, AH, SCTP, ICMP and L3_DEFAULT. The + valid IP protocols are different for different load balancing + products as described in `Load balancing + features `__. """ - UNDEFINED_INSTANCE_STATE = 0 - ALL = 64897 - RUNNING = 121282975 + UNDEFINED_I_P_PROTOCOL = 0 + AH = 2087 + ESP = 68962 + ICMP = 2241597 + SCTP = 2539724 + TCP = 82881 + UDP = 83873 - instance_state = proto.Field( - proto.ENUM, number=92223591, optional=True, enum=InstanceState, - ) + class IpVersion(proto.Enum): + r"""The IP Version that will be used by this forwarding rule. + Valid options are IPV4 or IPV6. This can only be specified for + an external global forwarding rule. + """ + UNDEFINED_IP_VERSION = 0 + IPV4 = 2254341 + IPV6 = 2254343 + UNSPECIFIED_VERSION = 21850000 + class LoadBalancingScheme(proto.Enum): + r"""Specifies the forwarding rule type. For more information + about forwarding rules, refer to Forwarding rule concepts. + """ + UNDEFINED_LOAD_BALANCING_SCHEME = 0 + EXTERNAL = 35607499 + INTERNAL = 279295677 + INTERNAL_MANAGED = 37350397 + INTERNAL_SELF_MANAGED = 236211150 + INVALID = 530283991 -class InstanceGroupsRemoveInstancesRequest(proto.Message): - r""" - Attributes: - instances (Sequence[google.cloud.compute_v1.types.InstanceReference]): - The list of instances to remove from the - instance group. - """ + class NetworkTier(proto.Enum): + r"""This signifies the networking tier used for configuring this + load balancer and can only take the following values: PREMIUM, + STANDARD. For regional ForwardingRule, the valid values are + PREMIUM and STANDARD. For GlobalForwardingRule, the valid value + is PREMIUM. If this field is not specified, it is assumed to be + PREMIUM. If IPAddress is specified, this value must be equal to + the networkTier of the Address. + """ + UNDEFINED_NETWORK_TIER = 0 + PREMIUM = 399530551 + STANDARD = 484642493 - instances = proto.RepeatedField( - proto.MESSAGE, number=29097598, message="InstanceReference", + class PscConnectionStatus(proto.Enum): + r"""""" + UNDEFINED_PSC_CONNECTION_STATUS = 0 + ACCEPTED = 246714279 + CLOSED = 380163436 + PENDING = 35394935 + REJECTED = 174130302 + STATUS_UNSPECIFIED = 42133066 + + I_p_address = proto.Field(proto.STRING, number=42976943, optional=True,) + I_p_protocol = proto.Field( + proto.ENUM, number=488094525, optional=True, enum=IPProtocol, + ) + all_ports = proto.Field(proto.BOOL, number=445175796, optional=True,) + allow_global_access = proto.Field(proto.BOOL, number=499409674, optional=True,) + backend_service = proto.Field(proto.STRING, number=306946058, optional=True,) + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + ip_version = proto.Field( + proto.ENUM, number=294959552, optional=True, enum=IpVersion, + ) + is_mirroring_collector = proto.Field(proto.BOOL, number=119255164, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + label_fingerprint = proto.Field(proto.STRING, number=178124825, optional=True,) + labels = proto.MapField(proto.STRING, proto.STRING, number=500195327,) + load_balancing_scheme = proto.Field( + proto.ENUM, number=363890244, optional=True, enum=LoadBalancingScheme, + ) + metadata_filters = proto.RepeatedField( + proto.MESSAGE, number=464725739, message="MetadataFilter", + ) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + network = proto.Field(proto.STRING, number=232872494, optional=True,) + network_tier = proto.Field( + proto.ENUM, number=517397843, optional=True, enum=NetworkTier, + ) + port_range = proto.Field(proto.STRING, number=217518079, optional=True,) + ports = proto.RepeatedField(proto.STRING, number=106854418,) + psc_connection_id = proto.Field(proto.UINT64, number=292082397, optional=True,) + psc_connection_status = proto.Field( + proto.ENUM, number=184149172, optional=True, enum=PscConnectionStatus, + ) + region = proto.Field(proto.STRING, number=138946292, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + service_directory_registrations = proto.RepeatedField( + proto.MESSAGE, + number=223549694, + message="ForwardingRuleServiceDirectoryRegistration", ) + service_label = proto.Field(proto.STRING, number=417008874, optional=True,) + service_name = proto.Field(proto.STRING, number=359880149, optional=True,) + subnetwork = proto.Field(proto.STRING, number=307827694, optional=True,) + target = proto.Field(proto.STRING, number=192835985, optional=True,) -class InstanceGroupsSetNamedPortsRequest(proto.Message): +class ForwardingRuleAggregatedList(proto.Message): r""" - Attributes: - fingerprint (str): - The fingerprint of the named ports - information for this instance group. Use this - optional property to prevent conflicts when - multiple users change the named ports settings - concurrently. Obtain the fingerprint with the - instanceGroups.get method. Then, include the - fingerprint in your request to ensure that you - do not overwrite changes that were applied from - another concurrent request. A request with an - incorrect fingerprint will fail with error 412 - conditionNotMet. - named_ports (Sequence[google.cloud.compute_v1.types.NamedPort]): - The list of named ports to set for this - instance group. - """ - - fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) - named_ports = proto.RepeatedField( - proto.MESSAGE, number=427598732, message="NamedPort", - ) - - -class InstanceList(proto.Message): - r"""Contains a list of instances. Attributes: id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.Instance]): - A list of Instance resources. + items (Sequence[google.cloud.compute_v1.types.ForwardingRuleAggregatedList.ItemsEntry]): + A list of ForwardingRulesScopedList + resources. kind (str): - [Output Only] Type of resource. Always compute#instanceList - for lists of Instance resources. + [Output Only] Type of resource. Always + compute#forwardingRuleAggregatedList for lists of forwarding + rules. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -12655,6 +13723,8 @@ class InstanceList(proto.Message): to continue paging through the results. self_link (str): [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. warning (google.cloud.compute_v1.types.Warning): [Output Only] Informational warning message. """ @@ -12664,52 +13734,31 @@ def raw_page(self): return self id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Instance",) + items = proto.MapField( + proto.STRING, + proto.MESSAGE, + number=100526016, + message="ForwardingRulesScopedList", + ) kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) warning = proto.Field( proto.MESSAGE, number=50704284, optional=True, message="Warning", ) -class Reference(proto.Message): - r"""Represents a reference to a resource. - Attributes: - kind (str): - [Output Only] Type of the resource. Always compute#reference - for references. - reference_type (str): - A description of the reference type with no implied - semantics. Possible values include: - - - MEMBER_OF - referrer (str): - URL of the resource which refers to the - target. - target (str): - URL of the resource to which this reference - points. - """ - - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - reference_type = proto.Field(proto.STRING, number=247521198, optional=True,) - referrer = proto.Field(proto.STRING, number=351173663, optional=True,) - target = proto.Field(proto.STRING, number=192835985, optional=True,) - - -class InstanceListReferrers(proto.Message): - r"""Contains a list of instance referrers. +class ForwardingRuleList(proto.Message): + r"""Contains a list of ForwardingRule resources. Attributes: id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.Reference]): - A list of Reference resources. + items (Sequence[google.cloud.compute_v1.types.ForwardingRule]): + A list of ForwardingRule resources. kind (str): - [Output Only] Type of resource. Always - compute#instanceListReferrers for lists of Instance - referrers. + Type of resource. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -12728,7 +13777,9 @@ def raw_page(self): return self id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Reference",) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="ForwardingRule", + ) kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) @@ -12737,4455 +13788,2818 @@ def raw_page(self): ) -class InstanceManagedByIgmErrorManagedInstanceError(proto.Message): +class ForwardingRuleReference(proto.Message): r""" Attributes: - code (str): - [Output Only] Error code. - message (str): - [Output Only] Error message. + forwarding_rule (str): + """ - code = proto.Field(proto.STRING, number=3059181, optional=True,) - message = proto.Field(proto.STRING, number=418054151, optional=True,) + forwarding_rule = proto.Field(proto.STRING, number=269964030, optional=True,) -class InstanceManagedByIgmErrorInstanceActionDetails(proto.Message): - r""" +class ForwardingRuleServiceDirectoryRegistration(proto.Message): + r"""Describes the auto-registration of the Forwarding Rule to + Service Directory. The region and project of the Service + Directory resource generated from this registration will be the + same as this Forwarding Rule. + Attributes: - action (google.cloud.compute_v1.types.InstanceManagedByIgmErrorInstanceActionDetails.Action): - [Output Only] Action that managed instance group was - executing on the instance when the error occurred. Possible - values: - instance (str): - [Output Only] The URL of the instance. The URL can be set - even if the instance has not yet been created. - version (google.cloud.compute_v1.types.ManagedInstanceVersion): - [Output Only] Version this instance was created from, or was - being created from, but the creation failed. Corresponds to - one of the versions that were set on the Instance Group - Manager resource at the time this instance was being - created. + namespace (str): + Service Directory namespace to register the + forwarding rule under. + service (str): + Service Directory service to register the + forwarding rule under. + service_directory_region (str): + [Optional] Service Directory region to register this global + forwarding rule under. Default to "us-central1". Only used + for PSC for Google APIs. All PSC for Google APIs Forwarding + Rules on the same network should use the same Service + Directory region. """ - class Action(proto.Enum): - r"""[Output Only] Action that managed instance group was executing on - the instance when the error occurred. Possible values: - """ - UNDEFINED_ACTION = 0 - ABANDONING = 388244813 - CREATING = 455564985 - CREATING_WITHOUT_RETRIES = 428843785 - DELETING = 528602024 - NONE = 2402104 - RECREATING = 287278572 - REFRESHING = 163266343 - RESTARTING = 320534387 - VERIFYING = 16982185 - - action = proto.Field(proto.ENUM, number=187661878, optional=True, enum=Action,) - instance = proto.Field(proto.STRING, number=18257045, optional=True,) - version = proto.Field( - proto.MESSAGE, - number=351608024, - optional=True, - message="ManagedInstanceVersion", + namespace = proto.Field(proto.STRING, number=178476379, optional=True,) + service = proto.Field(proto.STRING, number=373540533, optional=True,) + service_directory_region = proto.Field( + proto.STRING, number=74030416, optional=True, ) -class ManagedInstanceVersion(proto.Message): +class ForwardingRulesScopedList(proto.Message): r""" Attributes: - instance_template (str): - [Output Only] The intended template of the instance. This - field is empty when current_action is one of { DELETING, - ABANDONING }. - name (str): - [Output Only] Name of the version. + forwarding_rules (Sequence[google.cloud.compute_v1.types.ForwardingRule]): + A list of forwarding rules contained in this + scope. + warning (google.cloud.compute_v1.types.Warning): + Informational warning which replaces the list + of forwarding rules when the list is empty. """ - instance_template = proto.Field(proto.STRING, number=309248228, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) + forwarding_rules = proto.RepeatedField( + proto.MESSAGE, number=315821365, message="ForwardingRule", + ) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class InstanceMoveRequest(proto.Message): +class GRPCHealthCheck(proto.Message): r""" Attributes: - destination_zone (str): - The URL of the destination zone to move the - instance. This can be a full or partial URL. For - example, the following are all valid URLs to a - zone: - - https://www.googleapis.com/compute/v1/projects/project/zones/zone - - projects/project/zones/zone - - zones/zone - target_instance (str): - The URL of the target instance to move. This - can be a full or partial URL. For example, the - following are all valid URLs to an instance: - - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance - - projects/project/zones/zone/instances/instance - - zones/zone/instances/instance + grpc_service_name (str): + The gRPC service name for the health check. This field is + optional. The value of grpc_service_name has the following + meanings by convention: - Empty service_name means the + overall status of all services at the backend. - Non-empty + service_name means the health of that gRPC service, as + defined by the owner of the service. The grpc_service_name + can only be ASCII. + port (int): + The port number for the health check request. Must be + specified if port_name and port_specification are not set or + if port_specification is USE_FIXED_PORT. Valid values are 1 + through 65535. + port_name (str): + Port name as defined in InstanceGroup#NamedPort#name. If + both port and port_name are defined, port takes precedence. + The port_name should conform to RFC1035. + port_specification (google.cloud.compute_v1.types.GRPCHealthCheck.PortSpecification): + Specifies how port is selected for health checking, can be + one of following values: USE_FIXED_PORT: The port number in + port is used for health checking. USE_NAMED_PORT: The + portName is used for health checking. USE_SERVING_PORT: For + NetworkEndpointGroup, the port specified for each network + endpoint is used for health checking. For other backends, + the port or named port specified in the Backend Service is + used for health checking. If not specified, gRPC health + check follows behavior specified in port and portName + fields. """ - destination_zone = proto.Field(proto.STRING, number=131854653, optional=True,) - target_instance = proto.Field(proto.STRING, number=289769347, optional=True,) - - -class SourceInstanceParams(proto.Message): - r"""A specification of the parameters to use when creating the - instance template from a source instance. - - Attributes: - disk_configs (Sequence[google.cloud.compute_v1.types.DiskInstantiationConfig]): - Attached disks configuration. If not - provided, defaults are applied: For boot disk - and any other R/W disks, new custom images will - be created from each disk. For read-only disks, - they will be attached in read-only mode. Local - SSD disks will be created as blank volumes. - """ + class PortSpecification(proto.Enum): + r"""Specifies how port is selected for health checking, can be one of + following values: USE_FIXED_PORT: The port number in port is used + for health checking. USE_NAMED_PORT: The portName is used for health + checking. USE_SERVING_PORT: For NetworkEndpointGroup, the port + specified for each network endpoint is used for health checking. For + other backends, the port or named port specified in the Backend + Service is used for health checking. If not specified, gRPC health + check follows behavior specified in port and portName fields. + """ + UNDEFINED_PORT_SPECIFICATION = 0 + USE_FIXED_PORT = 190235748 + USE_NAMED_PORT = 349300671 + USE_SERVING_PORT = 362637516 - disk_configs = proto.RepeatedField( - proto.MESSAGE, number=235580623, message="DiskInstantiationConfig", + grpc_service_name = proto.Field(proto.STRING, number=136533078, optional=True,) + port = proto.Field(proto.INT32, number=3446913, optional=True,) + port_name = proto.Field(proto.STRING, number=41534345, optional=True,) + port_specification = proto.Field( + proto.ENUM, number=51590597, optional=True, enum=PortSpecification, ) -class InstanceTemplate(proto.Message): - r"""Represents an Instance Template resource. - - You can use instance templates to create VM instances and managed - instance groups. For more information, read Instance Templates. (== - resource_for {$api_version}.instanceTemplates ==) - - Attributes: - creation_timestamp (str): - [Output Only] The creation timestamp for this instance - template in RFC3339 text format. - description (str): - An optional description of this resource. - Provide this property when you create the - resource. - id (int): - [Output Only] A unique identifier for this instance - template. The server defines this identifier. - kind (str): - [Output Only] The resource type, which is always - compute#instanceTemplate for instance templates. - name (str): - Name of the resource; provided by the client when the - resource is created. The name must be 1-63 characters long, - and comply with RFC1035. Specifically, the name must be 1-63 - characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. - properties (google.cloud.compute_v1.types.InstanceProperties): - The instance properties for this instance - template. - self_link (str): - [Output Only] The URL for this instance template. The server - defines this URL. - source_instance (str): - The source instance used to create the - template. You can provide this as a partial or - full URL to the resource. For example, the - following are valid values: - - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance - - projects/project/zones/zone/instances/instance - source_instance_params (google.cloud.compute_v1.types.SourceInstanceParams): - The source instance params to use to create - this instance template. - """ - - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - properties = proto.Field( - proto.MESSAGE, number=147688755, optional=True, message="InstanceProperties", - ) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - source_instance = proto.Field(proto.STRING, number=396315705, optional=True,) - source_instance_params = proto.Field( - proto.MESSAGE, number=135342156, optional=True, message="SourceInstanceParams", - ) - +class GetAcceleratorTypeRequest(proto.Message): + r"""A request message for AcceleratorTypes.Get. See the method + description for details. -class InstanceTemplateList(proto.Message): - r"""A list of instance templates. Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.InstanceTemplate]): - A list of InstanceTemplate resources. - kind (str): - [Output Only] The resource type, which is always - compute#instanceTemplatesListResponse for instance template - lists. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + accelerator_type (str): + Name of the accelerator type to return. + project (str): + Project ID for this request. + zone (str): + The name of the zone for this request. """ - @property - def raw_page(self): - return self + accelerator_type = proto.Field(proto.STRING, number=138031246,) + project = proto.Field(proto.STRING, number=227560217,) + zone = proto.Field(proto.STRING, number=3744684,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="InstanceTemplate", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) +class GetAddressRequest(proto.Message): + r"""A request message for Addresses.Get. See the method + description for details. -class InstancesAddResourcePoliciesRequest(proto.Message): - r""" Attributes: - resource_policies (Sequence[str]): - Resource policies to be added to this - instance. + address (str): + Name of the address resource to return. + project (str): + Project ID for this request. + region (str): + Name of the region for this request. """ - resource_policies = proto.RepeatedField(proto.STRING, number=22220385,) + address = proto.Field(proto.STRING, number=462920692,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) -class InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy(proto.Message): - r""" +class GetAssociationFirewallPolicyRequest(proto.Message): + r"""A request message for FirewallPolicies.GetAssociation. See + the method description for details. + Attributes: - display_name (str): - [Output Only] Deprecated, please use short name instead. The - display name of the firewall policy. + firewall_policy (str): + Name of the firewall policy to which the + queried rule belongs. name (str): - [Output Only] The name of the firewall policy. - rules (Sequence[google.cloud.compute_v1.types.FirewallPolicyRule]): - The rules that apply to the network. - short_name (str): - [Output Only] The short name of the firewall policy. - type_ (google.cloud.compute_v1.types.InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy.Type): - [Output Only] The type of the firewall policy. + The name of the association to get from the + firewall policy. """ - class Type(proto.Enum): - r"""[Output Only] The type of the firewall policy.""" - UNDEFINED_TYPE = 0 - HIERARCHY = 69902869 - UNSPECIFIED = 526786327 - - display_name = proto.Field(proto.STRING, number=4473832, optional=True,) + firewall_policy = proto.Field(proto.STRING, number=498173265,) name = proto.Field(proto.STRING, number=3373707, optional=True,) - rules = proto.RepeatedField( - proto.MESSAGE, number=108873975, message="FirewallPolicyRule", - ) - short_name = proto.Field(proto.STRING, number=492051566, optional=True,) - type_ = proto.Field(proto.ENUM, number=3575610, optional=True, enum=Type,) -class InstancesGetEffectiveFirewallsResponse(proto.Message): - r""" +class GetAutoscalerRequest(proto.Message): + r"""A request message for Autoscalers.Get. See the method + description for details. + Attributes: - firewall_policys (Sequence[google.cloud.compute_v1.types.InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy]): - Effective firewalls from firewall policies. - firewalls (Sequence[google.cloud.compute_v1.types.Firewall]): - Effective firewalls on the instance. + autoscaler (str): + Name of the autoscaler to return. + project (str): + Project ID for this request. + zone (str): + Name of the zone for this request. """ - firewall_policys = proto.RepeatedField( - proto.MESSAGE, - number=410985794, - message="InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy", - ) - firewalls = proto.RepeatedField( - proto.MESSAGE, number=272245619, message="Firewall", - ) + autoscaler = proto.Field(proto.STRING, number=517258967,) + project = proto.Field(proto.STRING, number=227560217,) + zone = proto.Field(proto.STRING, number=3744684,) -class InstancesRemoveResourcePoliciesRequest(proto.Message): - r""" +class GetBackendBucketRequest(proto.Message): + r"""A request message for BackendBuckets.Get. See the method + description for details. + Attributes: - resource_policies (Sequence[str]): - Resource policies to be removed from this - instance. + backend_bucket (str): + Name of the BackendBucket resource to return. + project (str): + Project ID for this request. """ - resource_policies = proto.RepeatedField(proto.STRING, number=22220385,) + backend_bucket = proto.Field(proto.STRING, number=91714037,) + project = proto.Field(proto.STRING, number=227560217,) -class InstancesSetLabelsRequest(proto.Message): - r""" - Attributes: - label_fingerprint (str): - Fingerprint of the previous set of labels for - this resource, used to prevent conflicts. - Provide the latest fingerprint value when making - a request to add or change labels. - labels (Sequence[google.cloud.compute_v1.types.InstancesSetLabelsRequest.LabelsEntry]): +class GetBackendServiceRequest(proto.Message): + r"""A request message for BackendServices.Get. See the method + description for details. + Attributes: + backend_service (str): + Name of the BackendService resource to + return. + project (str): + Project ID for this request. """ - label_fingerprint = proto.Field(proto.STRING, number=178124825, optional=True,) - labels = proto.MapField(proto.STRING, proto.STRING, number=500195327,) + backend_service = proto.Field(proto.STRING, number=306946058,) + project = proto.Field(proto.STRING, number=227560217,) -class InstancesSetMachineResourcesRequest(proto.Message): - r""" +class GetDiagnosticsInterconnectRequest(proto.Message): + r"""A request message for Interconnects.GetDiagnostics. See the + method description for details. + Attributes: - guest_accelerators (Sequence[google.cloud.compute_v1.types.AcceleratorConfig]): - A list of the type and count of accelerator - cards attached to the instance. + interconnect (str): + Name of the interconnect resource to query. + project (str): + Project ID for this request. """ - guest_accelerators = proto.RepeatedField( - proto.MESSAGE, number=463595119, message="AcceleratorConfig", - ) + interconnect = proto.Field(proto.STRING, number=224601230,) + project = proto.Field(proto.STRING, number=227560217,) -class InstancesSetMachineTypeRequest(proto.Message): - r""" +class GetDiskRequest(proto.Message): + r"""A request message for Disks.Get. See the method description + for details. + Attributes: - machine_type (str): - Full or partial URL of the machine type - resource. See Machine Types for a full list of - machine types. For example: zones/us- - central1-f/machineTypes/n1-standard-1 + disk (str): + Name of the persistent disk to return. + project (str): + Project ID for this request. + zone (str): + The name of the zone for this request. """ - machine_type = proto.Field(proto.STRING, number=227711026, optional=True,) + disk = proto.Field(proto.STRING, number=3083677,) + project = proto.Field(proto.STRING, number=227560217,) + zone = proto.Field(proto.STRING, number=3744684,) -class InstancesSetMinCpuPlatformRequest(proto.Message): - r""" +class GetDiskTypeRequest(proto.Message): + r"""A request message for DiskTypes.Get. See the method + description for details. + Attributes: - min_cpu_platform (str): - Minimum cpu/platform this instance should be - started at. + disk_type (str): + Name of the disk type to return. + project (str): + Project ID for this request. + zone (str): + The name of the zone for this request. """ - min_cpu_platform = proto.Field(proto.STRING, number=242912759, optional=True,) + disk_type = proto.Field(proto.STRING, number=93009052,) + project = proto.Field(proto.STRING, number=227560217,) + zone = proto.Field(proto.STRING, number=3744684,) -class InstancesSetServiceAccountRequest(proto.Message): - r""" +class GetEffectiveFirewallsInstanceRequest(proto.Message): + r"""A request message for Instances.GetEffectiveFirewalls. See + the method description for details. + Attributes: - email (str): - Email address of the service account. - scopes (Sequence[str]): - The list of scopes to be made available for - this service account. + instance (str): + Name of the instance scoping this request. + network_interface (str): + The name of the network interface to get the + effective firewalls. + project (str): + Project ID for this request. + zone (str): + The name of the zone for this request. """ - email = proto.Field(proto.STRING, number=96619420, optional=True,) - scopes = proto.RepeatedField(proto.STRING, number=165973151,) + instance = proto.Field(proto.STRING, number=18257045,) + network_interface = proto.Field(proto.STRING, number=365387880,) + project = proto.Field(proto.STRING, number=227560217,) + zone = proto.Field(proto.STRING, number=3744684,) -class InstancesStartWithEncryptionKeyRequest(proto.Message): - r""" +class GetEffectiveFirewallsNetworkRequest(proto.Message): + r"""A request message for Networks.GetEffectiveFirewalls. See the + method description for details. + Attributes: - disks (Sequence[google.cloud.compute_v1.types.CustomerEncryptionKeyProtectedDisk]): - Array of disks associated with this instance - that are protected with a customer-supplied - encryption key. In order to start the instance, - the disk url and its corresponding key must be - provided. - If the disk is not protected with a customer- - supplied encryption key it should not be - specified. + network (str): + Name of the network for this request. + project (str): + Project ID for this request. """ - disks = proto.RepeatedField( - proto.MESSAGE, number=95594102, message="CustomerEncryptionKeyProtectedDisk", - ) + network = proto.Field(proto.STRING, number=232872494,) + project = proto.Field(proto.STRING, number=227560217,) -class InterconnectCircuitInfo(proto.Message): - r"""Describes a single physical circuit between the Customer and - Google. CircuitInfo objects are created by Google, so all fields - are output only. +class GetExternalVpnGatewayRequest(proto.Message): + r"""A request message for ExternalVpnGateways.Get. See the method + description for details. Attributes: - customer_demarc_id (str): - Customer-side demarc ID for this circuit. - google_circuit_id (str): - Google-assigned unique ID for this circuit. - Assigned at circuit turn-up. - google_demarc_id (str): - Google-side demarc ID for this circuit. - Assigned at circuit turn-up and provided by - Google to the customer in the LOA. + external_vpn_gateway (str): + Name of the externalVpnGateway to return. + project (str): + Project ID for this request. """ - customer_demarc_id = proto.Field(proto.STRING, number=28771859, optional=True,) - google_circuit_id = proto.Field(proto.STRING, number=262014711, optional=True,) - google_demarc_id = proto.Field(proto.STRING, number=448196270, optional=True,) - + external_vpn_gateway = proto.Field(proto.STRING, number=109898629,) + project = proto.Field(proto.STRING, number=227560217,) -class InterconnectOutageNotification(proto.Message): - r"""Description of a planned outage on this Interconnect. - Attributes: - affected_circuits (Sequence[str]): - If issue_type is IT_PARTIAL_OUTAGE, a list of the - Google-side circuit IDs that will be affected. - description (str): - A description about the purpose of the - outage. - end_time (int): - Scheduled end time for the outage - (milliseconds since Unix epoch). - issue_type (google.cloud.compute_v1.types.InterconnectOutageNotification.IssueType): - Form this outage is expected to take, which can take one of - the following values: - - - OUTAGE: The Interconnect may be completely out of service - for some or all of the specified window. - - PARTIAL_OUTAGE: Some circuits comprising the Interconnect - as a whole should remain up, but with reduced bandwidth. - Note that the versions of this enum prefixed with "IT_" - have been deprecated in favor of the unprefixed values. - name (str): - Unique identifier for this outage - notification. - source (google.cloud.compute_v1.types.InterconnectOutageNotification.Source): - The party that generated this notification, which can take - the following value: - - GOOGLE: this notification as generated by Google. Note - that the value of NSRC_GOOGLE has been deprecated in - favor of GOOGLE. - start_time (int): - Scheduled start time for the outage - (milliseconds since Unix epoch). - state (google.cloud.compute_v1.types.InterconnectOutageNotification.State): - State of this notification, which can take one of the - following values: +class GetFirewallPolicyRequest(proto.Message): + r"""A request message for FirewallPolicies.Get. See the method + description for details. - - ACTIVE: This outage notification is active. The event - could be in the past, present, or future. See start_time - and end_time for scheduling. - - CANCELLED: The outage associated with this notification - was cancelled before the outage was due to start. Note - that the versions of this enum prefixed with "NS_" have - been deprecated in favor of the unprefixed values. + Attributes: + firewall_policy (str): + Name of the firewall policy to get. """ - class IssueType(proto.Enum): - r"""Form this outage is expected to take, which can take one of the - following values: - - - OUTAGE: The Interconnect may be completely out of service for - some or all of the specified window. - - PARTIAL_OUTAGE: Some circuits comprising the Interconnect as a - whole should remain up, but with reduced bandwidth. Note that the - versions of this enum prefixed with "IT_" have been deprecated in - favor of the unprefixed values. - """ - UNDEFINED_ISSUE_TYPE = 0 - IT_OUTAGE = 175779973 - IT_PARTIAL_OUTAGE = 92103971 - OUTAGE = 195285745 - PARTIAL_OUTAGE = 147053455 - - class Source(proto.Enum): - r"""The party that generated this notification, which can take the - following value: + firewall_policy = proto.Field(proto.STRING, number=498173265,) - - GOOGLE: this notification as generated by Google. Note that the - value of NSRC_GOOGLE has been deprecated in favor of GOOGLE. - """ - UNDEFINED_SOURCE = 0 - GOOGLE = 497439289 - NSRC_GOOGLE = 510574562 - class State(proto.Enum): - r"""State of this notification, which can take one of the following - values: - - - ACTIVE: This outage notification is active. The event could be in - the past, present, or future. See start_time and end_time for - scheduling. - - CANCELLED: The outage associated with this notification was - cancelled before the outage was due to start. Note that the - versions of this enum prefixed with "NS_" have been deprecated in - favor of the unprefixed values. - """ - UNDEFINED_STATE = 0 - ACTIVE = 314733318 - CANCELLED = 41957681 - COMPLETED = 309921323 - NS_ACTIVE = 252563136 - NS_CANCELED = 506579411 +class GetFirewallRequest(proto.Message): + r"""A request message for Firewalls.Get. See the method + description for details. - affected_circuits = proto.RepeatedField(proto.STRING, number=177717013,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - end_time = proto.Field(proto.INT64, number=114938801, optional=True,) - issue_type = proto.Field( - proto.ENUM, number=369639136, optional=True, enum=IssueType, - ) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - source = proto.Field(proto.ENUM, number=177235995, optional=True, enum=Source,) - start_time = proto.Field(proto.INT64, number=37467274, optional=True,) - state = proto.Field(proto.ENUM, number=109757585, optional=True, enum=State,) + Attributes: + firewall (str): + Name of the firewall rule to return. + project (str): + Project ID for this request. + """ + firewall = proto.Field(proto.STRING, number=511016192,) + project = proto.Field(proto.STRING, number=227560217,) -class Interconnect(proto.Message): - r"""Represents an Interconnect resource. - An Interconnect resource is a dedicated connection between the GCP - network and your on-premises network. For more information, read the - Dedicated Interconnect Overview. (== resource_for - {$api_version}.interconnects ==) +class GetForwardingRuleRequest(proto.Message): + r"""A request message for ForwardingRules.Get. See the method + description for details. Attributes: - admin_enabled (bool): - Administrative status of the interconnect. - When this is set to true, the Interconnect is - functional and can carry traffic. When set to - false, no packets can be carried over the - interconnect and no BGP routes are exchanged - over it. By default, the status is set to true. - circuit_infos (Sequence[google.cloud.compute_v1.types.InterconnectCircuitInfo]): - [Output Only] A list of CircuitInfo objects, that describe - the individual circuits in this LAG. - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - customer_name (str): - Customer name, to put in the Letter of - Authorization as the party authorized to request - a crossconnect. - description (str): - An optional description of this resource. - Provide this property when you create the - resource. - expected_outages (Sequence[google.cloud.compute_v1.types.InterconnectOutageNotification]): - [Output Only] A list of outages expected for this - Interconnect. - google_ip_address (str): - [Output Only] IP address configured on the Google side of - the Interconnect link. This can be used only for ping tests. - google_reference_id (str): - [Output Only] Google reference ID to be used when raising - support tickets with Google or otherwise to debug backend - connectivity issues. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - interconnect_attachments (Sequence[str]): - [Output Only] A list of the URLs of all - InterconnectAttachments configured to use this Interconnect. - interconnect_type (google.cloud.compute_v1.types.Interconnect.InterconnectType): - Type of interconnect, which can take one of the following - values: - - - PARTNER: A partner-managed interconnection shared between - customers though a partner. - - DEDICATED: A dedicated physical interconnection with the - customer. Note that a value IT_PRIVATE has been - deprecated in favor of DEDICATED. - kind (str): - [Output Only] Type of the resource. Always - compute#interconnect for interconnects. - link_type (google.cloud.compute_v1.types.Interconnect.LinkType): - Type of link requested, which can take one of the following - values: - - - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics - - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR - optics. Note that this field indicates the speed of each - of the links in the bundle, not the speed of the entire - bundle. - location (str): - URL of the InterconnectLocation object that - represents where this connection is to be - provisioned. - name (str): - Name of the resource. Provided by the client when the - resource is created. The name must be 1-63 characters long, - and comply with RFC1035. Specifically, the name must be 1-63 - characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. - noc_contact_email (str): - Email address to contact the customer NOC for - operations and maintenance notifications - regarding this Interconnect. If specified, this - will be used for notifications in addition to - all other forms described, such as Stackdriver - logs alerting and Cloud Notifications. - operational_status (google.cloud.compute_v1.types.Interconnect.OperationalStatus): - [Output Only] The current status of this Interconnect's - functionality, which can take one of the following values: - - - OS_ACTIVE: A valid Interconnect, which is turned up and - is ready to use. Attachments may be provisioned on this - Interconnect. - - OS_UNPROVISIONED: An Interconnect that has not completed - turnup. No attachments may be provisioned on this - Interconnect. - - OS_UNDER_MAINTENANCE: An Interconnect that is undergoing - internal maintenance. No attachments may be provisioned - or updated on this Interconnect. - peer_ip_address (str): - [Output Only] IP address configured on the customer side of - the Interconnect link. The customer should configure this IP - address during turnup when prompted by Google NOC. This can - be used only for ping tests. - provisioned_link_count (int): - [Output Only] Number of links actually provisioned in this - interconnect. - requested_link_count (int): - Target number of physical links in the link - bundle, as requested by the customer. - self_link (str): - [Output Only] Server-defined URL for the resource. - state (google.cloud.compute_v1.types.Interconnect.State): - [Output Only] The current state of Interconnect - functionality, which can take one of the following values: - - - ACTIVE: The Interconnect is valid, turned up and ready to - use. Attachments may be provisioned on this Interconnect. - - UNPROVISIONED: The Interconnect has not completed turnup. - No attachments may be provisioned on this Interconnect. - - UNDER_MAINTENANCE: The Interconnect is undergoing - internal maintenance. No attachments may be provisioned - or updated on this Interconnect. + forwarding_rule (str): + Name of the ForwardingRule resource to + return. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. """ - class InterconnectType(proto.Enum): - r"""Type of interconnect, which can take one of the following values: - - - PARTNER: A partner-managed interconnection shared between - customers though a partner. - - DEDICATED: A dedicated physical interconnection with the - customer. Note that a value IT_PRIVATE has been deprecated in - favor of DEDICATED. - """ - UNDEFINED_INTERCONNECT_TYPE = 0 - DEDICATED = 258411983 - IT_PRIVATE = 335677007 - PARTNER = 461924520 - - class LinkType(proto.Enum): - r"""Type of link requested, which can take one of the following values: + forwarding_rule = proto.Field(proto.STRING, number=269964030,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) - - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics - - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics. Note - that this field indicates the speed of each of the links in the - bundle, not the speed of the entire bundle. - """ - UNDEFINED_LINK_TYPE = 0 - LINK_TYPE_ETHERNET_100G_LR = 337672551 - LINK_TYPE_ETHERNET_10G_LR = 236739749 - class OperationalStatus(proto.Enum): - r"""[Output Only] The current status of this Interconnect's - functionality, which can take one of the following values: - - - OS_ACTIVE: A valid Interconnect, which is turned up and is ready - to use. Attachments may be provisioned on this Interconnect. - - OS_UNPROVISIONED: An Interconnect that has not completed turnup. - No attachments may be provisioned on this Interconnect. - - OS_UNDER_MAINTENANCE: An Interconnect that is undergoing internal - maintenance. No attachments may be provisioned or updated on this - Interconnect. - """ - UNDEFINED_OPERATIONAL_STATUS = 0 - OS_ACTIVE = 55721409 - OS_UNPROVISIONED = 239771840 +class GetFromFamilyImageRequest(proto.Message): + r"""A request message for Images.GetFromFamily. See the method + description for details. - class State(proto.Enum): - r"""[Output Only] The current state of Interconnect functionality, which - can take one of the following values: - - - ACTIVE: The Interconnect is valid, turned up and ready to use. - Attachments may be provisioned on this Interconnect. - - UNPROVISIONED: The Interconnect has not completed turnup. No - attachments may be provisioned on this Interconnect. - - UNDER_MAINTENANCE: The Interconnect is undergoing internal - maintenance. No attachments may be provisioned or updated on this - Interconnect. - """ - UNDEFINED_STATE = 0 - ACTIVE = 314733318 - UNPROVISIONED = 517333979 + Attributes: + family (str): + Name of the image family to search for. + project (str): + Project ID for this request. + """ - admin_enabled = proto.Field(proto.BOOL, number=445675089, optional=True,) - circuit_infos = proto.RepeatedField( - proto.MESSAGE, number=164839855, message="InterconnectCircuitInfo", - ) - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - customer_name = proto.Field(proto.STRING, number=3665484, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - expected_outages = proto.RepeatedField( - proto.MESSAGE, number=264484123, message="InterconnectOutageNotification", - ) - google_ip_address = proto.Field(proto.STRING, number=443105954, optional=True,) - google_reference_id = proto.Field(proto.STRING, number=534944469, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - interconnect_attachments = proto.RepeatedField(proto.STRING, number=425388415,) - interconnect_type = proto.Field( - proto.ENUM, number=515165259, optional=True, enum=InterconnectType, - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - link_type = proto.Field(proto.ENUM, number=523207775, optional=True, enum=LinkType,) - location = proto.Field(proto.STRING, number=290430901, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - noc_contact_email = proto.Field(proto.STRING, number=14072832, optional=True,) - operational_status = proto.Field( - proto.ENUM, number=201070847, optional=True, enum=OperationalStatus, - ) - peer_ip_address = proto.Field(proto.STRING, number=207735769, optional=True,) - provisioned_link_count = proto.Field(proto.INT32, number=410888565, optional=True,) - requested_link_count = proto.Field(proto.INT32, number=45051387, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - state = proto.Field(proto.ENUM, number=109757585, optional=True, enum=State,) + family = proto.Field(proto.STRING, number=328751972,) + project = proto.Field(proto.STRING, number=227560217,) -class InterconnectAttachmentPartnerMetadata(proto.Message): - r"""Informational metadata about Partner attachments from Partners to - display to customers. These fields are propagated from - PARTNER_PROVIDER attachments to their corresponding PARTNER - attachments. +class GetGlobalAddressRequest(proto.Message): + r"""A request message for GlobalAddresses.Get. See the method + description for details. Attributes: - interconnect_name (str): - Plain text name of the Interconnect this - attachment is connected to, as displayed in the - Partner's portal. For instance "Chicago 1". This - value may be validated to match approved Partner - values. - partner_name (str): - Plain text name of the Partner providing this - attachment. This value may be validated to match - approved Partner values. - portal_url (str): - URL of the Partner's portal for this - Attachment. Partners may customise this to be a - deep link to the specific resource on the - Partner portal. This value may be validated to - match approved Partner values. + address (str): + Name of the address resource to return. + project (str): + Project ID for this request. """ - interconnect_name = proto.Field(proto.STRING, number=514963356, optional=True,) - partner_name = proto.Field(proto.STRING, number=161747874, optional=True,) - portal_url = proto.Field(proto.STRING, number=269182748, optional=True,) + address = proto.Field(proto.STRING, number=462920692,) + project = proto.Field(proto.STRING, number=227560217,) -class InterconnectAttachmentPrivateInfo(proto.Message): - r"""Information for an interconnect attachment when this belongs - to an interconnect of type DEDICATED. +class GetGlobalForwardingRuleRequest(proto.Message): + r"""A request message for GlobalForwardingRules.Get. See the + method description for details. Attributes: - tag8021q (int): - [Output Only] 802.1q encapsulation tag to be used for - traffic between Google and the customer, going to and from - this network and region. + forwarding_rule (str): + Name of the ForwardingRule resource to + return. + project (str): + Project ID for this request. """ - tag8021q = proto.Field(proto.UINT32, number=271820992, optional=True,) - + forwarding_rule = proto.Field(proto.STRING, number=269964030,) + project = proto.Field(proto.STRING, number=227560217,) -class InterconnectAttachment(proto.Message): - r"""Represents an Interconnect Attachment (VLAN) resource. - You can use Interconnect attachments (VLANS) to connect your Virtual - Private Cloud networks to your on-premises networks through an - Interconnect. For more information, read Creating VLAN Attachments. - (== resource_for {$api_version}.interconnectAttachments ==) +class GetGlobalNetworkEndpointGroupRequest(proto.Message): + r"""A request message for GlobalNetworkEndpointGroups.Get. See + the method description for details. Attributes: - admin_enabled (bool): - Determines whether this Attachment will carry packets. Not - present for PARTNER_PROVIDER. - bandwidth (google.cloud.compute_v1.types.InterconnectAttachment.Bandwidth): - Provisioned bandwidth capacity for the interconnect - attachment. For attachments of type DEDICATED, the user can - set the bandwidth. For attachments of type PARTNER, the - Google Partner that is operating the interconnect must set - the bandwidth. Output only for PARTNER type, mutable for - PARTNER_PROVIDER and DEDICATED, and can take one of the - following values: - - - BPS_50M: 50 Mbit/s - - BPS_100M: 100 Mbit/s - - BPS_200M: 200 Mbit/s - - BPS_300M: 300 Mbit/s - - BPS_400M: 400 Mbit/s - - BPS_500M: 500 Mbit/s - - BPS_1G: 1 Gbit/s - - BPS_2G: 2 Gbit/s - - BPS_5G: 5 Gbit/s - - BPS_10G: 10 Gbit/s - - BPS_20G: 20 Gbit/s - - BPS_50G: 50 Gbit/s - candidate_subnets (Sequence[str]): - Up to 16 candidate prefixes that can be used - to restrict the allocation of - cloudRouterIpAddress and customerRouterIpAddress - for this attachment. All prefixes must be within - link-local address space (169.254.0.0/16) and - must be /29 or shorter (/28, /27, etc). Google - will attempt to select an unused /29 from the - supplied candidate prefix(es). The request will - fail if all possible /29s are in use on Google's - edge. If not supplied, Google will randomly - select an unused /29 from all of link-local - space. - cloud_router_ip_address (str): - [Output Only] IPv4 address + prefix length to be configured - on Cloud Router Interface for this interconnect attachment. - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - customer_router_ip_address (str): - [Output Only] IPv4 address + prefix length to be configured - on the customer router subinterface for this interconnect - attachment. - dataplane_version (int): - [Output Only] Dataplane version for this - InterconnectAttachment. - description (str): - An optional description of this resource. - edge_availability_domain (google.cloud.compute_v1.types.InterconnectAttachment.EdgeAvailabilityDomain): - Desired availability domain for the attachment. Only - available for type PARTNER, at creation time, and can take - one of the following values: - - - AVAILABILITY_DOMAIN_ANY - - AVAILABILITY_DOMAIN_1 - - AVAILABILITY_DOMAIN_2 For improved reliability, customers - should configure a pair of attachments, one per - availability domain. The selected availability domain - will be provided to the Partner via the pairing key, so - that the provisioned circuit will lie in the specified - domain. If not specified, the value will default to - AVAILABILITY_DOMAIN_ANY. - encryption (google.cloud.compute_v1.types.InterconnectAttachment.Encryption): - Indicates the user-supplied encryption option - of this interconnect attachment: - NONE is the - default value, which means that the attachment - carries unencrypted traffic. VMs can send - traffic to, or receive traffic from, this type - of attachment. - IPSEC indicates that the - attachment carries only traffic encrypted by an - IPsec device such as an HA VPN gateway. VMs - cannot directly send traffic to, or receive - traffic from, such an attachment. To use IPsec- - encrypted Cloud Interconnect, create the - attachment using this option. Not currently - available in all Interconnect locations. - google_reference_id (str): - [Output Only] Google reference ID, to be used when raising - support tickets with Google or otherwise to debug backend - connectivity issues. [Deprecated] This field is not used. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - interconnect (str): - URL of the underlying Interconnect object - that this attachment's traffic will traverse - through. - ipsec_internal_addresses (Sequence[str]): - URL of addresses that have been reserved for - the interconnect attachment, Used only for - interconnect attachment that has the encryption - option as IPSEC. The addresses must be RFC 1918 - IP address ranges. When creating HA VPN gateway - over the interconnect attachment, if the - attachment is configured to use an RFC 1918 IP - address, then the VPN gateway's IP address will - be allocated from the IP address range specified - here. For example, if the HA VPN gateway's - interface 0 is paired to this interconnect - attachment, then an RFC 1918 IP address for the - VPN gateway interface 0 will be allocated from - the IP address specified for this interconnect - attachment. If this field is not specified for - interconnect attachment that has encryption - option as IPSEC, later on when creating HA VPN - gateway on this interconnect attachment, the HA - VPN gateway's IP address will be allocated from - regional external IP address pool. Not currently - available in all Interconnect locations. - kind (str): - [Output Only] Type of the resource. Always - compute#interconnectAttachment for interconnect attachments. - mtu (int): - Maximum Transmission Unit (MTU), in bytes, of - packets passing through this interconnect - attachment. Only 1440 and 1500 are allowed. If - not specified, the value will default to 1440. - name (str): - Name of the resource. Provided by the client when the - resource is created. The name must be 1-63 characters long, - and comply with RFC1035. Specifically, the name must be 1-63 - characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. - operational_status (google.cloud.compute_v1.types.InterconnectAttachment.OperationalStatus): - [Output Only] The current status of whether or not this - interconnect attachment is functional, which can take one of - the following values: - - - OS_ACTIVE: The attachment has been turned up and is ready - to use. - - OS_UNPROVISIONED: The attachment is not ready to use yet, - because turnup is not complete. - pairing_key (str): - [Output only for type PARTNER. Input only for - PARTNER_PROVIDER. Not present for DEDICATED]. The opaque - identifier of an PARTNER attachment used to initiate - provisioning with a selected partner. Of the form - "XXXXX/region/domain". - partner_asn (int): - Optional BGP ASN for the router supplied by a Layer 3 - Partner if they configured BGP on behalf of the customer. - Output only for PARTNER type, input only for - PARTNER_PROVIDER, not available for DEDICATED. - partner_metadata (google.cloud.compute_v1.types.InterconnectAttachmentPartnerMetadata): - Informational metadata about Partner attachments from - Partners to display to customers. Output only for for - PARTNER type, mutable for PARTNER_PROVIDER, not available - for DEDICATED. - private_interconnect_info (google.cloud.compute_v1.types.InterconnectAttachmentPrivateInfo): - [Output Only] Information specific to an - InterconnectAttachment. This property is populated if the - interconnect that this is attached to is of type DEDICATED. - region (str): - [Output Only] URL of the region where the regional - interconnect attachment resides. You must specify this field - as part of the HTTP request URL. It is not settable as a - field in the request body. - router (str): - URL of the Cloud Router to be used for - dynamic routing. This router must be in the same - region as this InterconnectAttachment. The - InterconnectAttachment will automatically - connect the Interconnect to the network & region - within which the Cloud Router is configured. - self_link (str): - [Output Only] Server-defined URL for the resource. - state (google.cloud.compute_v1.types.InterconnectAttachment.State): - [Output Only] The current state of this attachment's - functionality. Enum values ACTIVE and UNPROVISIONED are - shared by DEDICATED/PRIVATE, PARTNER, and PARTNER_PROVIDER - interconnect attachments, while enum values PENDING_PARTNER, - PARTNER_REQUEST_RECEIVED, and PENDING_CUSTOMER are used for - only PARTNER and PARTNER_PROVIDER interconnect attachments. - This state can take one of the following values: - - - ACTIVE: The attachment has been turned up and is ready to - use. - - UNPROVISIONED: The attachment is not ready to use yet, - because turnup is not complete. - - PENDING_PARTNER: A newly-created PARTNER attachment that - has not yet been configured on the Partner side. - - PARTNER_REQUEST_RECEIVED: A PARTNER attachment is in the - process of provisioning after a PARTNER_PROVIDER - attachment was created that references it. - - PENDING_CUSTOMER: A PARTNER or PARTNER_PROVIDER - attachment that is waiting for a customer to activate it. - - DEFUNCT: The attachment was deleted externally and is no - longer functional. This could be because the associated - Interconnect was removed, or because the other side of a - Partner attachment was deleted. - type_ (google.cloud.compute_v1.types.InterconnectAttachment.Type): - The type of interconnect attachment this is, which can take - one of the following values: + network_endpoint_group (str): + The name of the network endpoint group. It + should comply with RFC1035. + project (str): + Project ID for this request. + """ - - DEDICATED: an attachment to a Dedicated Interconnect. - - PARTNER: an attachment to a Partner Interconnect, created - by the customer. - - PARTNER_PROVIDER: an attachment to a Partner - Interconnect, created by the partner. - vlan_tag8021q (int): - The IEEE 802.1Q VLAN tag for this attachment, - in the range 2-4094. Only specified at creation - time. + network_endpoint_group = proto.Field(proto.STRING, number=433907078,) + project = proto.Field(proto.STRING, number=227560217,) + + +class GetGlobalOperationRequest(proto.Message): + r"""A request message for GlobalOperations.Get. See the method + description for details. + + Attributes: + operation (str): + Name of the Operations resource to return. + project (str): + Project ID for this request. """ - class Bandwidth(proto.Enum): - r"""Provisioned bandwidth capacity for the interconnect attachment. For - attachments of type DEDICATED, the user can set the bandwidth. For - attachments of type PARTNER, the Google Partner that is operating - the interconnect must set the bandwidth. Output only for PARTNER - type, mutable for PARTNER_PROVIDER and DEDICATED, and can take one - of the following values: - - - BPS_50M: 50 Mbit/s - - BPS_100M: 100 Mbit/s - - BPS_200M: 200 Mbit/s - - BPS_300M: 300 Mbit/s - - BPS_400M: 400 Mbit/s - - BPS_500M: 500 Mbit/s - - BPS_1G: 1 Gbit/s - - BPS_2G: 2 Gbit/s - - BPS_5G: 5 Gbit/s - - BPS_10G: 10 Gbit/s - - BPS_20G: 20 Gbit/s - - BPS_50G: 50 Gbit/s - """ - UNDEFINED_BANDWIDTH = 0 - BPS_100M = 49547958 - BPS_10G = 278693006 - BPS_1G = 355358448 - BPS_200M = 49577749 - BPS_20G = 278693967 - BPS_2G = 355358479 - BPS_300M = 49607540 - BPS_400M = 49637331 - BPS_500M = 49667122 - BPS_50G = 278696850 - BPS_50M = 278696856 - BPS_5G = 355358572 + operation = proto.Field(proto.STRING, number=52090215,) + project = proto.Field(proto.STRING, number=227560217,) - class EdgeAvailabilityDomain(proto.Enum): - r"""Desired availability domain for the attachment. Only available for - type PARTNER, at creation time, and can take one of the following - values: - - - AVAILABILITY_DOMAIN_ANY - - AVAILABILITY_DOMAIN_1 - - AVAILABILITY_DOMAIN_2 For improved reliability, customers should - configure a pair of attachments, one per availability domain. The - selected availability domain will be provided to the Partner via - the pairing key, so that the provisioned circuit will lie in the - specified domain. If not specified, the value will default to - AVAILABILITY_DOMAIN_ANY. - """ - UNDEFINED_EDGE_AVAILABILITY_DOMAIN = 0 - AVAILABILITY_DOMAIN_1 = 349552090 - AVAILABILITY_DOMAIN_2 = 349552091 - AVAILABILITY_DOMAIN_ANY = 375256373 - class Encryption(proto.Enum): - r"""Indicates the user-supplied encryption option of this - interconnect attachment: - NONE is the default value, which - means that the attachment carries unencrypted traffic. VMs can - send traffic to, or receive traffic from, this type of - attachment. - IPSEC indicates that the attachment carries only - traffic encrypted by an IPsec device such as an HA VPN gateway. - VMs cannot directly send traffic to, or receive traffic from, - such an attachment. To use IPsec-encrypted Cloud Interconnect, - create the attachment using this option. Not currently available - in all Interconnect locations. - """ - UNDEFINED_ENCRYPTION = 0 - IPSEC = 69882282 - NONE = 2402104 +class GetGlobalOrganizationOperationRequest(proto.Message): + r"""A request message for GlobalOrganizationOperations.Get. See + the method description for details. - class OperationalStatus(proto.Enum): - r"""[Output Only] The current status of whether or not this interconnect - attachment is functional, which can take one of the following - values: + Attributes: + operation (str): + Name of the Operations resource to return. + parent_id (str): + Parent ID for this request. + """ - - OS_ACTIVE: The attachment has been turned up and is ready to use. - - OS_UNPROVISIONED: The attachment is not ready to use yet, because - turnup is not complete. - """ - UNDEFINED_OPERATIONAL_STATUS = 0 - OS_ACTIVE = 55721409 - OS_UNPROVISIONED = 239771840 + operation = proto.Field(proto.STRING, number=52090215,) + parent_id = proto.Field(proto.STRING, number=459714768, optional=True,) - class State(proto.Enum): - r"""[Output Only] The current state of this attachment's functionality. - Enum values ACTIVE and UNPROVISIONED are shared by - DEDICATED/PRIVATE, PARTNER, and PARTNER_PROVIDER interconnect - attachments, while enum values PENDING_PARTNER, - PARTNER_REQUEST_RECEIVED, and PENDING_CUSTOMER are used for only - PARTNER and PARTNER_PROVIDER interconnect attachments. This state - can take one of the following values: - - - ACTIVE: The attachment has been turned up and is ready to use. - - UNPROVISIONED: The attachment is not ready to use yet, because - turnup is not complete. - - PENDING_PARTNER: A newly-created PARTNER attachment that has not - yet been configured on the Partner side. - - PARTNER_REQUEST_RECEIVED: A PARTNER attachment is in the process - of provisioning after a PARTNER_PROVIDER attachment was created - that references it. - - PENDING_CUSTOMER: A PARTNER or PARTNER_PROVIDER attachment that - is waiting for a customer to activate it. - - DEFUNCT: The attachment was deleted externally and is no longer - functional. This could be because the associated Interconnect was - removed, or because the other side of a Partner attachment was - deleted. - """ - UNDEFINED_STATE = 0 - ACTIVE = 314733318 - DEFUNCT = 115891759 - PARTNER_REQUEST_RECEIVED = 513587304 - PENDING_CUSTOMER = 167494054 - PENDING_PARTNER = 387890656 - STATE_UNSPECIFIED = 470755401 - UNPROVISIONED = 517333979 - class Type(proto.Enum): - r"""The type of interconnect attachment this is, which can take one of - the following values: +class GetGlobalPublicDelegatedPrefixeRequest(proto.Message): + r"""A request message for GlobalPublicDelegatedPrefixes.Get. See + the method description for details. - - DEDICATED: an attachment to a Dedicated Interconnect. - - PARTNER: an attachment to a Partner Interconnect, created by the - customer. - - PARTNER_PROVIDER: an attachment to a Partner Interconnect, - created by the partner. - """ - UNDEFINED_TYPE = 0 - DEDICATED = 258411983 - PARTNER = 461924520 - PARTNER_PROVIDER = 483261352 + Attributes: + project (str): + Project ID for this request. + public_delegated_prefix (str): + Name of the PublicDelegatedPrefix resource to + return. + """ - admin_enabled = proto.Field(proto.BOOL, number=445675089, optional=True,) - bandwidth = proto.Field( - proto.ENUM, number=181715121, optional=True, enum=Bandwidth, - ) - candidate_subnets = proto.RepeatedField(proto.STRING, number=237842938,) - cloud_router_ip_address = proto.Field( - proto.STRING, number=287392776, optional=True, - ) - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - customer_router_ip_address = proto.Field( - proto.STRING, number=332475761, optional=True, - ) - dataplane_version = proto.Field(proto.INT32, number=34920075, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - edge_availability_domain = proto.Field( - proto.ENUM, number=71289510, optional=True, enum=EdgeAvailabilityDomain, - ) - encryption = proto.Field( - proto.ENUM, number=97980291, optional=True, enum=Encryption, - ) - google_reference_id = proto.Field(proto.STRING, number=534944469, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - interconnect = proto.Field(proto.STRING, number=224601230, optional=True,) - ipsec_internal_addresses = proto.RepeatedField(proto.STRING, number=407648565,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - mtu = proto.Field(proto.INT32, number=108462, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - operational_status = proto.Field( - proto.ENUM, number=201070847, optional=True, enum=OperationalStatus, - ) - pairing_key = proto.Field(proto.STRING, number=439695464, optional=True,) - partner_asn = proto.Field(proto.INT64, number=438166149, optional=True,) - partner_metadata = proto.Field( - proto.MESSAGE, - number=65908934, - optional=True, - message="InterconnectAttachmentPartnerMetadata", - ) - private_interconnect_info = proto.Field( - proto.MESSAGE, - number=237270531, - optional=True, - message="InterconnectAttachmentPrivateInfo", - ) - region = proto.Field(proto.STRING, number=138946292, optional=True,) - router = proto.Field(proto.STRING, number=148608841, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - state = proto.Field(proto.ENUM, number=109757585, optional=True, enum=State,) - type_ = proto.Field(proto.ENUM, number=3575610, optional=True, enum=Type,) - vlan_tag8021q = proto.Field(proto.INT32, number=119927836, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + public_delegated_prefix = proto.Field(proto.STRING, number=204238440,) -class InterconnectAttachmentsScopedList(proto.Message): - r""" +class GetGuestAttributesInstanceRequest(proto.Message): + r"""A request message for Instances.GetGuestAttributes. See the + method description for details. + Attributes: - interconnect_attachments (Sequence[google.cloud.compute_v1.types.InterconnectAttachment]): - A list of interconnect attachments contained - in this scope. - warning (google.cloud.compute_v1.types.Warning): - Informational warning which replaces the list - of addresses when the list is empty. + instance (str): + Name of the instance scoping this request. + project (str): + Project ID for this request. + query_path (str): + Specifies the guest attributes path to be + queried. + variable_key (str): + Specifies the key for the guest attributes + entry. + zone (str): + The name of the zone for this request. """ - interconnect_attachments = proto.RepeatedField( - proto.MESSAGE, number=425388415, message="InterconnectAttachment", - ) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + instance = proto.Field(proto.STRING, number=18257045,) + project = proto.Field(proto.STRING, number=227560217,) + query_path = proto.Field(proto.STRING, number=368591164, optional=True,) + variable_key = proto.Field(proto.STRING, number=164364828, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) + + +class GetHealthBackendServiceRequest(proto.Message): + r"""A request message for BackendServices.GetHealth. See the + method description for details. + + Attributes: + backend_service (str): + Name of the BackendService resource to which + the queried instance belongs. + project (str): + + resource_group_reference_resource (google.cloud.compute_v1.types.ResourceGroupReference): + The body resource for this request + """ + + backend_service = proto.Field(proto.STRING, number=306946058,) + project = proto.Field(proto.STRING, number=227560217,) + resource_group_reference_resource = proto.Field( + proto.MESSAGE, number=112951123, message="ResourceGroupReference", ) -class InterconnectAttachmentAggregatedList(proto.Message): - r""" +class GetHealthCheckRequest(proto.Message): + r"""A request message for HealthChecks.Get. See the method + description for details. + Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.InterconnectAttachmentAggregatedList.ItemsEntry]): - A list of InterconnectAttachmentsScopedList - resources. - kind (str): - [Output Only] Type of resource. Always - compute#interconnectAttachmentAggregatedList for aggregated - lists of interconnect attachments. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - unreachables (Sequence[str]): - [Output Only] Unreachable resources. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + health_check (str): + Name of the HealthCheck resource to return. + project (str): + Project ID for this request. """ - @property - def raw_page(self): - return self + health_check = proto.Field(proto.STRING, number=308876645,) + project = proto.Field(proto.STRING, number=227560217,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.MapField( - proto.STRING, - proto.MESSAGE, - number=100526016, - message="InterconnectAttachmentsScopedList", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - unreachables = proto.RepeatedField(proto.STRING, number=243372063,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + +class GetHealthRegionBackendServiceRequest(proto.Message): + r"""A request message for RegionBackendServices.GetHealth. See + the method description for details. + + Attributes: + backend_service (str): + Name of the BackendService resource for which + to get health. + project (str): + + region (str): + Name of the region scoping this request. + resource_group_reference_resource (google.cloud.compute_v1.types.ResourceGroupReference): + The body resource for this request + """ + + backend_service = proto.Field(proto.STRING, number=306946058,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + resource_group_reference_resource = proto.Field( + proto.MESSAGE, number=112951123, message="ResourceGroupReference", ) -class InterconnectAttachmentList(proto.Message): - r"""Response to the list request, and contains a list of - interconnect attachments. +class GetHealthTargetPoolRequest(proto.Message): + r"""A request message for TargetPools.GetHealth. See the method + description for details. Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.InterconnectAttachment]): - A list of InterconnectAttachment resources. - kind (str): - [Output Only] Type of resource. Always - compute#interconnectAttachmentList for lists of interconnect - attachments. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + instance_reference_resource (google.cloud.compute_v1.types.InstanceReference): + The body resource for this request + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + target_pool (str): + Name of the TargetPool resource to which the + queried instance belongs. """ - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="InterconnectAttachment", + instance_reference_resource = proto.Field( + proto.MESSAGE, number=292926060, message="InstanceReference", ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + target_pool = proto.Field(proto.STRING, number=62796298,) + + +class GetIamPolicyDiskRequest(proto.Message): + r"""A request message for Disks.GetIamPolicy. See the method + description for details. + + Attributes: + options_requested_policy_version (int): + Requested IAM Policy version. + project (str): + Project ID for this request. + resource (str): + Name or id of the resource for this request. + zone (str): + The name of the zone for this request. + """ + + options_requested_policy_version = proto.Field( + proto.INT32, number=499220029, optional=True, ) + project = proto.Field(proto.STRING, number=227560217,) + resource = proto.Field(proto.STRING, number=195806222,) + zone = proto.Field(proto.STRING, number=3744684,) -class InterconnectDiagnosticsARPEntry(proto.Message): - r"""Describing the ARP neighbor entries seen on this link +class GetIamPolicyFirewallPolicyRequest(proto.Message): + r"""A request message for FirewallPolicies.GetIamPolicy. See the + method description for details. + Attributes: - ip_address (str): - The IP address of this ARP neighbor. - mac_address (str): - The MAC address of this ARP neighbor. + options_requested_policy_version (int): + Requested IAM Policy version. + resource (str): + Name or id of the resource for this request. """ - ip_address = proto.Field(proto.STRING, number=406272220, optional=True,) - mac_address = proto.Field(proto.STRING, number=332540164, optional=True,) + options_requested_policy_version = proto.Field( + proto.INT32, number=499220029, optional=True, + ) + resource = proto.Field(proto.STRING, number=195806222,) -class InterconnectDiagnosticsLinkStatus(proto.Message): - r""" +class GetIamPolicyImageRequest(proto.Message): + r"""A request message for Images.GetIamPolicy. See the method + description for details. + Attributes: - arp_caches (Sequence[google.cloud.compute_v1.types.InterconnectDiagnosticsARPEntry]): - A list of InterconnectDiagnostics.ARPEntry - objects, describing the ARP neighbor entries - seen on this link. This will be empty if the - link is bundled - circuit_id (str): - The unique ID for this link assigned during - turn up by Google. - google_demarc (str): - The Demarc address assigned by Google and - provided in the LoA. - lacp_status (google.cloud.compute_v1.types.InterconnectDiagnosticsLinkLACPStatus): + options_requested_policy_version (int): + Requested IAM Policy version. + project (str): + Project ID for this request. + resource (str): + Name or id of the resource for this request. + """ - receiving_optical_power (google.cloud.compute_v1.types.InterconnectDiagnosticsLinkOpticalPower): - An InterconnectDiagnostics.LinkOpticalPower - object, describing the current value and status - of the received light level. - transmitting_optical_power (google.cloud.compute_v1.types.InterconnectDiagnosticsLinkOpticalPower): - An InterconnectDiagnostics.LinkOpticalPower - object, describing the current value and status - of the transmitted light level. + options_requested_policy_version = proto.Field( + proto.INT32, number=499220029, optional=True, + ) + project = proto.Field(proto.STRING, number=227560217,) + resource = proto.Field(proto.STRING, number=195806222,) + + +class GetIamPolicyInstanceRequest(proto.Message): + r"""A request message for Instances.GetIamPolicy. See the method + description for details. + + Attributes: + options_requested_policy_version (int): + Requested IAM Policy version. + project (str): + Project ID for this request. + resource (str): + Name or id of the resource for this request. + zone (str): + The name of the zone for this request. """ - arp_caches = proto.RepeatedField( - proto.MESSAGE, number=414591761, message="InterconnectDiagnosticsARPEntry", + options_requested_policy_version = proto.Field( + proto.INT32, number=499220029, optional=True, ) - circuit_id = proto.Field(proto.STRING, number=225180977, optional=True,) - google_demarc = proto.Field(proto.STRING, number=51084, optional=True,) - lacp_status = proto.Field( - proto.MESSAGE, - number=361210415, - optional=True, - message="InterconnectDiagnosticsLinkLACPStatus", + project = proto.Field(proto.STRING, number=227560217,) + resource = proto.Field(proto.STRING, number=195806222,) + zone = proto.Field(proto.STRING, number=3744684,) + + +class GetIamPolicyInstanceTemplateRequest(proto.Message): + r"""A request message for InstanceTemplates.GetIamPolicy. See the + method description for details. + + Attributes: + options_requested_policy_version (int): + Requested IAM Policy version. + project (str): + Project ID for this request. + resource (str): + Name or id of the resource for this request. + """ + + options_requested_policy_version = proto.Field( + proto.INT32, number=499220029, optional=True, ) - receiving_optical_power = proto.Field( - proto.MESSAGE, - number=244717279, - optional=True, - message="InterconnectDiagnosticsLinkOpticalPower", + project = proto.Field(proto.STRING, number=227560217,) + resource = proto.Field(proto.STRING, number=195806222,) + + +class GetIamPolicyLicenseRequest(proto.Message): + r"""A request message for Licenses.GetIamPolicy. See the method + description for details. + + Attributes: + options_requested_policy_version (int): + Requested IAM Policy version. + project (str): + Project ID for this request. + resource (str): + Name or id of the resource for this request. + """ + + options_requested_policy_version = proto.Field( + proto.INT32, number=499220029, optional=True, ) - transmitting_optical_power = proto.Field( - proto.MESSAGE, - number=459431197, - optional=True, - message="InterconnectDiagnosticsLinkOpticalPower", + project = proto.Field(proto.STRING, number=227560217,) + resource = proto.Field(proto.STRING, number=195806222,) + + +class GetIamPolicyNodeGroupRequest(proto.Message): + r"""A request message for NodeGroups.GetIamPolicy. See the method + description for details. + + Attributes: + options_requested_policy_version (int): + Requested IAM Policy version. + project (str): + Project ID for this request. + resource (str): + Name or id of the resource for this request. + zone (str): + The name of the zone for this request. + """ + + options_requested_policy_version = proto.Field( + proto.INT32, number=499220029, optional=True, ) + project = proto.Field(proto.STRING, number=227560217,) + resource = proto.Field(proto.STRING, number=195806222,) + zone = proto.Field(proto.STRING, number=3744684,) -class InterconnectDiagnostics(proto.Message): - r"""Diagnostics information about interconnect, contains detailed - and current technical information about Google's side of the - connection. +class GetIamPolicyNodeTemplateRequest(proto.Message): + r"""A request message for NodeTemplates.GetIamPolicy. See the + method description for details. Attributes: - arp_caches (Sequence[google.cloud.compute_v1.types.InterconnectDiagnosticsARPEntry]): - A list of InterconnectDiagnostics.ARPEntry - objects, describing individual neighbors - currently seen by the Google router in the ARP - cache for the Interconnect. This will be empty - when the Interconnect is not bundled. - links (Sequence[google.cloud.compute_v1.types.InterconnectDiagnosticsLinkStatus]): - A list of InterconnectDiagnostics.LinkStatus - objects, describing the status for each link on - the Interconnect. - mac_address (str): - The MAC address of the Interconnect's bundle - interface. + options_requested_policy_version (int): + Requested IAM Policy version. + project (str): + Project ID for this request. + region (str): + The name of the region for this request. + resource (str): + Name or id of the resource for this request. """ - arp_caches = proto.RepeatedField( - proto.MESSAGE, number=414591761, message="InterconnectDiagnosticsARPEntry", - ) - links = proto.RepeatedField( - proto.MESSAGE, number=102977465, message="InterconnectDiagnosticsLinkStatus", + options_requested_policy_version = proto.Field( + proto.INT32, number=499220029, optional=True, ) - mac_address = proto.Field(proto.STRING, number=332540164, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + resource = proto.Field(proto.STRING, number=195806222,) -class InterconnectDiagnosticsLinkLACPStatus(proto.Message): - r""" +class GetIamPolicyRegionDiskRequest(proto.Message): + r"""A request message for RegionDisks.GetIamPolicy. See the + method description for details. + Attributes: - google_system_id (str): - System ID of the port on Google's side of the - LACP exchange. - neighbor_system_id (str): - System ID of the port on the neighbor's side - of the LACP exchange. - state (google.cloud.compute_v1.types.InterconnectDiagnosticsLinkLACPStatus.State): - The state of a LACP link, which can take one - of the following values: - ACTIVE: The link is - configured and active within the bundle. - - DETACHED: The link is not configured within the - bundle. This means that the rest of the object - should be empty. + options_requested_policy_version (int): + Requested IAM Policy version. + project (str): + Project ID for this request. + region (str): + The name of the region for this request. + resource (str): + Name or id of the resource for this request. """ - class State(proto.Enum): - r"""The state of a LACP link, which can take one of the following - values: - ACTIVE: The link is configured and active within the - bundle. - DETACHED: The link is not configured within the - bundle. This means that the rest of the object should be empty. - """ - UNDEFINED_STATE = 0 - ACTIVE = 314733318 - DETACHED = 216562546 + options_requested_policy_version = proto.Field( + proto.INT32, number=499220029, optional=True, + ) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + resource = proto.Field(proto.STRING, number=195806222,) - google_system_id = proto.Field(proto.STRING, number=91210405, optional=True,) - neighbor_system_id = proto.Field(proto.STRING, number=343821342, optional=True,) - state = proto.Field(proto.ENUM, number=109757585, optional=True, enum=State,) +class GetIamPolicyReservationRequest(proto.Message): + r"""A request message for Reservations.GetIamPolicy. See the + method description for details. -class InterconnectDiagnosticsLinkOpticalPower(proto.Message): - r""" Attributes: - state (google.cloud.compute_v1.types.InterconnectDiagnosticsLinkOpticalPower.State): - The status of the current value when compared to the warning - and alarm levels for the receiving or transmitting - transceiver. Possible states include: - - - OK: The value has not crossed a warning threshold. - - LOW_WARNING: The value has crossed below the low warning - threshold. - - HIGH_WARNING: The value has crossed above the high - warning threshold. - - LOW_ALARM: The value has crossed below the low alarm - threshold. - - HIGH_ALARM: The value has crossed above the high alarm - threshold. - value (float): - Value of the current receiving or - transmitting optical power, read in dBm. Take a - known good optical value, give it a 10% margin - and trigger warnings relative to that value. In - general, a -7dBm warning and a -11dBm alarm are - good optical value estimates for most links. + options_requested_policy_version (int): + Requested IAM Policy version. + project (str): + Project ID for this request. + resource (str): + Name or id of the resource for this request. + zone (str): + The name of the zone for this request. """ - class State(proto.Enum): - r"""The status of the current value when compared to the warning and - alarm levels for the receiving or transmitting transceiver. Possible - states include: - - - OK: The value has not crossed a warning threshold. - - LOW_WARNING: The value has crossed below the low warning - threshold. - - HIGH_WARNING: The value has crossed above the high warning - threshold. - - LOW_ALARM: The value has crossed below the low alarm threshold. - - HIGH_ALARM: The value has crossed above the high alarm threshold. - """ - UNDEFINED_STATE = 0 - HIGH_ALARM = 305363284 - HIGH_WARNING = 220984799 - LOW_ALARM = 316659046 - LOW_WARNING = 338793841 - OK = 2524 - - state = proto.Field(proto.ENUM, number=109757585, optional=True, enum=State,) - value = proto.Field(proto.FLOAT, number=111972721, optional=True,) + options_requested_policy_version = proto.Field( + proto.INT32, number=499220029, optional=True, + ) + project = proto.Field(proto.STRING, number=227560217,) + resource = proto.Field(proto.STRING, number=195806222,) + zone = proto.Field(proto.STRING, number=3744684,) -class InterconnectList(proto.Message): - r"""Response to the list request, and contains a list of - interconnects. +class GetIamPolicyResourcePolicyRequest(proto.Message): + r"""A request message for ResourcePolicies.GetIamPolicy. See the + method description for details. Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.Interconnect]): - A list of Interconnect resources. - kind (str): - [Output Only] Type of resource. Always - compute#interconnectList for lists of interconnects. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + options_requested_policy_version (int): + Requested IAM Policy version. + project (str): + Project ID for this request. + region (str): + The name of the region for this request. + resource (str): + Name or id of the resource for this request. """ - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="Interconnect", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + options_requested_policy_version = proto.Field( + proto.INT32, number=499220029, optional=True, ) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + resource = proto.Field(proto.STRING, number=195806222,) -class InterconnectLocationRegionInfo(proto.Message): - r"""Information about any potential InterconnectAttachments - between an Interconnect at a specific InterconnectLocation, and - a specific Cloud Region. +class GetIamPolicyServiceAttachmentRequest(proto.Message): + r"""A request message for ServiceAttachments.GetIamPolicy. See + the method description for details. Attributes: - expected_rtt_ms (int): - Expected round-trip time in milliseconds, - from this InterconnectLocation to a VM in this - region. - location_presence (google.cloud.compute_v1.types.InterconnectLocationRegionInfo.LocationPresence): - Identifies the network presence of this - location. + options_requested_policy_version (int): + Requested IAM Policy version. + project (str): + Project ID for this request. region (str): - URL for the region of this location. + The name of the region for this request. + resource (str): + Name or id of the resource for this request. """ - class LocationPresence(proto.Enum): - r"""Identifies the network presence of this location.""" - UNDEFINED_LOCATION_PRESENCE = 0 - GLOBAL = 494663587 - LOCAL_REGION = 403535464 - LP_GLOBAL = 429584062 - LP_LOCAL_REGION = 488598851 - - expected_rtt_ms = proto.Field(proto.INT64, number=422543866, optional=True,) - location_presence = proto.Field( - proto.ENUM, number=101517893, optional=True, enum=LocationPresence, + options_requested_policy_version = proto.Field( + proto.INT32, number=499220029, optional=True, ) - region = proto.Field(proto.STRING, number=138946292, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + resource = proto.Field(proto.STRING, number=195806222,) -class InterconnectLocation(proto.Message): - r"""Represents an Interconnect Attachment (VLAN) Location - resource. - You can use this resource to find location details about an - Interconnect attachment (VLAN). For more information about - interconnect attachments, read Creating VLAN Attachments. +class GetIamPolicySnapshotRequest(proto.Message): + r"""A request message for Snapshots.GetIamPolicy. See the method + description for details. Attributes: - address (str): - [Output Only] The postal address of the Point of Presence, - each line in the address is separated by a newline - character. - availability_zone (str): - [Output Only] Availability zone for this - InterconnectLocation. Within a metropolitan area (metro), - maintenance will not be simultaneously scheduled in more - than one availability zone. Example: "zone1" or "zone2". - city (str): - [Output Only] Metropolitan area designator that indicates - which city an interconnect is located. For example: - "Chicago, IL", "Amsterdam, Netherlands". - continent (google.cloud.compute_v1.types.InterconnectLocation.Continent): - [Output Only] Continent for this location, which can take - one of the following values: - - - AFRICA - - ASIA_PAC - - EUROPE - - NORTH_AMERICA - - SOUTH_AMERICA - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - description (str): - [Output Only] An optional description of the resource. - facility_provider (str): - [Output Only] The name of the provider for this facility - (e.g., EQUINIX). - facility_provider_facility_id (str): - [Output Only] A provider-assigned Identifier for this - facility (e.g., Ashburn-DC1). - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - kind (str): - [Output Only] Type of the resource. Always - compute#interconnectLocation for interconnect locations. - name (str): - [Output Only] Name of the resource. - peeringdb_facility_id (str): - [Output Only] The peeringdb identifier for this facility - (corresponding with a netfac type in peeringdb). - region_infos (Sequence[google.cloud.compute_v1.types.InterconnectLocationRegionInfo]): - [Output Only] A list of InterconnectLocation.RegionInfo - objects, that describe parameters pertaining to the relation - between this InterconnectLocation and various Google Cloud - regions. - self_link (str): - [Output Only] Server-defined URL for the resource. - status (google.cloud.compute_v1.types.InterconnectLocation.Status): - [Output Only] The status of this InterconnectLocation, which - can take one of the following values: - - - CLOSED: The InterconnectLocation is closed and is - unavailable for provisioning new Interconnects. - - AVAILABLE: The InterconnectLocation is available for - provisioning new Interconnects. + options_requested_policy_version (int): + Requested IAM Policy version. + project (str): + Project ID for this request. + resource (str): + Name or id of the resource for this request. """ - class Continent(proto.Enum): - r"""[Output Only] Continent for this location, which can take one of the - following values: + options_requested_policy_version = proto.Field( + proto.INT32, number=499220029, optional=True, + ) + project = proto.Field(proto.STRING, number=227560217,) + resource = proto.Field(proto.STRING, number=195806222,) - - AFRICA - - ASIA_PAC - - EUROPE - - NORTH_AMERICA - - SOUTH_AMERICA - """ - UNDEFINED_CONTINENT = 0 - AFRICA = 317443706 - ASIA_PAC = 119782269 - C_AFRICA = 71993846 - C_ASIA_PAC = 465668089 - C_EUROPE = 200369438 - C_NORTH_AMERICA = 275697048 - C_SOUTH_AMERICA = 397149792 - EUROPE = 445819298 - NORTH_AMERICA = 448015508 - SOUTH_AMERICA = 32597340 - class Status(proto.Enum): - r"""[Output Only] The status of this InterconnectLocation, which can - take one of the following values: +class GetIamPolicySubnetworkRequest(proto.Message): + r"""A request message for Subnetworks.GetIamPolicy. See the + method description for details. - - CLOSED: The InterconnectLocation is closed and is unavailable for - provisioning new Interconnects. - - AVAILABLE: The InterconnectLocation is available for provisioning - new Interconnects. - """ - UNDEFINED_STATUS = 0 - AVAILABLE = 442079913 - CLOSED = 380163436 + Attributes: + options_requested_policy_version (int): + Requested IAM Policy version. + project (str): + Project ID for this request. + region (str): + The name of the region for this request. + resource (str): + Name or id of the resource for this request. + """ - address = proto.Field(proto.STRING, number=462920692, optional=True,) - availability_zone = proto.Field(proto.STRING, number=158459920, optional=True,) - city = proto.Field(proto.STRING, number=3053931, optional=True,) - continent = proto.Field( - proto.ENUM, number=133442996, optional=True, enum=Continent, - ) - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - facility_provider = proto.Field(proto.STRING, number=533303309, optional=True,) - facility_provider_facility_id = proto.Field( - proto.STRING, number=87269125, optional=True, - ) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - peeringdb_facility_id = proto.Field(proto.STRING, number=536567094, optional=True,) - region_infos = proto.RepeatedField( - proto.MESSAGE, number=312194170, message="InterconnectLocationRegionInfo", + options_requested_policy_version = proto.Field( + proto.INT32, number=499220029, optional=True, ) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + resource = proto.Field(proto.STRING, number=195806222,) -class InterconnectLocationList(proto.Message): - r"""Response to the list request, and contains a list of - interconnect locations. +class GetImageFamilyViewRequest(proto.Message): + r"""A request message for ImageFamilyViews.Get. See the method + description for details. Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.InterconnectLocation]): - A list of InterconnectLocation resources. - kind (str): - [Output Only] Type of resource. Always - compute#interconnectLocationList for lists of interconnect - locations. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + family (str): + Name of the image family to search for. + project (str): + Project ID for this request. + zone (str): + The name of the zone for this request. """ - @property - def raw_page(self): - return self + family = proto.Field(proto.STRING, number=328751972,) + project = proto.Field(proto.STRING, number=227560217,) + zone = proto.Field(proto.STRING, number=3744684,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="InterconnectLocation", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) +class GetImageRequest(proto.Message): + r"""A request message for Images.Get. See the method description + for details. -class InterconnectsGetDiagnosticsResponse(proto.Message): - r"""Response for the InterconnectsGetDiagnosticsRequest. Attributes: - result (google.cloud.compute_v1.types.InterconnectDiagnostics): + image (str): + Name of the image resource to return. + project (str): + Project ID for this request. + """ + image = proto.Field(proto.STRING, number=100313435,) + project = proto.Field(proto.STRING, number=227560217,) + + +class GetInstanceGroupManagerRequest(proto.Message): + r"""A request message for InstanceGroupManagers.Get. See the + method description for details. + + Attributes: + instance_group_manager (str): + The name of the managed instance group. + project (str): + Project ID for this request. + zone (str): + The name of the zone where the managed + instance group is located. """ - result = proto.Field( - proto.MESSAGE, - number=139315229, - optional=True, - message="InterconnectDiagnostics", - ) + instance_group_manager = proto.Field(proto.STRING, number=249363395,) + project = proto.Field(proto.STRING, number=227560217,) + zone = proto.Field(proto.STRING, number=3744684,) -class LicenseResourceRequirements(proto.Message): - r""" +class GetInstanceGroupRequest(proto.Message): + r"""A request message for InstanceGroups.Get. See the method + description for details. + Attributes: - min_guest_cpu_count (int): - Minimum number of guest cpus required to use - the Instance. Enforced at Instance creation and - Instance start. - min_memory_mb (int): - Minimum memory required to use the Instance. - Enforced at Instance creation and Instance - start. + instance_group (str): + The name of the instance group. + project (str): + Project ID for this request. + zone (str): + The name of the zone where the instance group + is located. """ - min_guest_cpu_count = proto.Field(proto.INT32, number=477964836, optional=True,) - min_memory_mb = proto.Field(proto.INT32, number=504785894, optional=True,) + instance_group = proto.Field(proto.STRING, number=81095253,) + project = proto.Field(proto.STRING, number=227560217,) + zone = proto.Field(proto.STRING, number=3744684,) -class License(proto.Message): - r"""Represents a License resource. +class GetInstanceRequest(proto.Message): + r"""A request message for Instances.Get. See the method + description for details. + + Attributes: + instance (str): + Name of the instance resource to return. + project (str): + Project ID for this request. + zone (str): + The name of the zone for this request. + """ - A License represents billing and aggregate usage data for public and - marketplace images. Caution This resource is intended for use only - by third-party partners who are creating Cloud Marketplace images. - (== resource_for {$api_version}.licenses ==) + instance = proto.Field(proto.STRING, number=18257045,) + project = proto.Field(proto.STRING, number=227560217,) + zone = proto.Field(proto.STRING, number=3744684,) + + +class GetInstanceTemplateRequest(proto.Message): + r"""A request message for InstanceTemplates.Get. See the method + description for details. Attributes: - charges_use_fee (bool): - [Output Only] Deprecated. This field no longer reflects - whether a license charges a usage fee. - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - description (str): - An optional textual description of the - resource; provided by the client when the - resource is created. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - kind (str): - [Output Only] Type of resource. Always compute#license for - licenses. - license_code (int): - [Output Only] The unique code used to attach this license to - images, snapshots, and disks. - name (str): - Name of the resource. The name must be 1-63 - characters long and comply with RFC1035. - resource_requirements (google.cloud.compute_v1.types.LicenseResourceRequirements): + instance_template (str): + The name of the instance template. + project (str): + Project ID for this request. + """ - self_link (str): - [Output Only] Server-defined URL for the resource. - transferable (bool): - If false, licenses will not be copied from - the source resource when creating an image from - a disk, disk from snapshot, or snapshot from - disk. + instance_template = proto.Field(proto.STRING, number=309248228,) + project = proto.Field(proto.STRING, number=227560217,) + + +class GetInterconnectAttachmentRequest(proto.Message): + r"""A request message for InterconnectAttachments.Get. See the + method description for details. + + Attributes: + interconnect_attachment (str): + Name of the interconnect attachment to + return. + project (str): + Project ID for this request. + region (str): + Name of the region for this request. """ - charges_use_fee = proto.Field(proto.BOOL, number=372412622, optional=True,) - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - license_code = proto.Field(proto.UINT64, number=1467179, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - resource_requirements = proto.Field( - proto.MESSAGE, - number=214292769, - optional=True, - message="LicenseResourceRequirements", - ) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - transferable = proto.Field(proto.BOOL, number=4349893, optional=True,) + interconnect_attachment = proto.Field(proto.STRING, number=308135284,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) -class LicenseCodeLicenseAlias(proto.Message): - r""" +class GetInterconnectLocationRequest(proto.Message): + r"""A request message for InterconnectLocations.Get. See the + method description for details. + Attributes: - description (str): - [Output Only] Description of this License Code. - self_link (str): - [Output Only] URL of license corresponding to this License - Code. + interconnect_location (str): + Name of the interconnect location to return. + project (str): + Project ID for this request. """ - description = proto.Field(proto.STRING, number=422937596, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - + interconnect_location = proto.Field(proto.STRING, number=492235846,) + project = proto.Field(proto.STRING, number=227560217,) -class LicenseCode(proto.Message): - r"""Represents a License Code resource. - A License Code is a unique identifier used to represent a license - resource. Caution This resource is intended for use only by - third-party partners who are creating Cloud Marketplace images. (== - resource_for {$api_version}.licenseCodes ==) +class GetInterconnectRequest(proto.Message): + r"""A request message for Interconnects.Get. See the method + description for details. Attributes: - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - description (str): - [Output Only] Description of this License Code. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - kind (str): - [Output Only] Type of resource. Always compute#licenseCode - for licenses. - license_alias (Sequence[google.cloud.compute_v1.types.LicenseCodeLicenseAlias]): - [Output Only] URL and description aliases of Licenses with - the same License Code. - name (str): - [Output Only] Name of the resource. The name is 1-20 - characters long and must be a valid 64 bit integer. - self_link (str): - [Output Only] Server-defined URL for the resource. - state (google.cloud.compute_v1.types.LicenseCode.State): - [Output Only] Current state of this License Code. - transferable (bool): - [Output Only] If true, the license will remain attached when - creating images or snapshots from disks. Otherwise, the - license is not transferred. + interconnect (str): + Name of the interconnect to return. + project (str): + Project ID for this request. """ - class State(proto.Enum): - r"""[Output Only] Current state of this License Code.""" - UNDEFINED_STATE = 0 - DISABLED = 516696700 - ENABLED = 182130465 - RESTRICTED = 261551195 - STATE_UNSPECIFIED = 470755401 - TERMINATED = 250018339 + interconnect = proto.Field(proto.STRING, number=224601230,) + project = proto.Field(proto.STRING, number=227560217,) - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - license_alias = proto.RepeatedField( - proto.MESSAGE, number=43550930, message="LicenseCodeLicenseAlias", - ) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - state = proto.Field(proto.ENUM, number=109757585, optional=True, enum=State,) - transferable = proto.Field(proto.BOOL, number=4349893, optional=True,) +class GetLicenseCodeRequest(proto.Message): + r"""A request message for LicenseCodes.Get. See the method + description for details. -class LicensesListResponse(proto.Message): - r""" Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.License]): - A list of License resources. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + license_code (str): + Number corresponding to the License code + resource to return. + project (str): + Project ID for this request. """ - @property - def raw_page(self): - return self + license_code = proto.Field(proto.STRING, number=1467179,) + project = proto.Field(proto.STRING, number=227560217,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="License",) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) +class GetLicenseRequest(proto.Message): + r"""A request message for Licenses.Get. See the method + description for details. -class LocalDisk(proto.Message): - r""" Attributes: - disk_count (int): - Specifies the number of such disks. - disk_size_gb (int): - Specifies the size of the disk in base-2 GB. - disk_type (str): - Specifies the desired disk type on the node. - This disk type must be a local storage type - (e.g.: local-ssd). Note that for nodeTemplates, - this should be the name of the disk type and not - its URL. + license_ (str): + Name of the License resource to return. + project (str): + Project ID for this request. """ - disk_count = proto.Field(proto.INT32, number=182933485, optional=True,) - disk_size_gb = proto.Field(proto.INT32, number=316263735, optional=True,) - disk_type = proto.Field(proto.STRING, number=93009052, optional=True,) + license_ = proto.Field(proto.STRING, number=166757441,) + project = proto.Field(proto.STRING, number=227560217,) -class LocationPolicyLocation(proto.Message): - r""" +class GetMachineTypeRequest(proto.Message): + r"""A request message for MachineTypes.Get. See the method + description for details. + Attributes: - preference (google.cloud.compute_v1.types.LocationPolicyLocation.Preference): - Preference for a given locaction: ALLOW or - DENY. + machine_type (str): + Name of the machine type to return. + project (str): + Project ID for this request. + zone (str): + The name of the zone for this request. """ - class Preference(proto.Enum): - r"""Preference for a given locaction: ALLOW or DENY.""" - UNDEFINED_PREFERENCE = 0 - ALLOW = 62368553 - DENY = 2094604 - PREFERENCE_UNSPECIFIED = 496219571 + machine_type = proto.Field(proto.STRING, number=227711026,) + project = proto.Field(proto.STRING, number=227560217,) + zone = proto.Field(proto.STRING, number=3744684,) - preference = proto.Field( - proto.ENUM, number=150781147, optional=True, enum=Preference, - ) +class GetNatMappingInfoRoutersRequest(proto.Message): + r"""A request message for Routers.GetNatMappingInfo. See the + method description for details. -class LogConfigCloudAuditOptions(proto.Message): - r"""Write a Cloud Audit log Attributes: - authorization_logging_options (google.cloud.compute_v1.types.AuthorizationLoggingOptions): - Information used by the Cloud Audit Logging - pipeline. - log_name (google.cloud.compute_v1.types.LogConfigCloudAuditOptions.LogName): - The log_name to populate in the Cloud Audit Record. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + region (str): + Name of the region for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. + router (str): + Name of the Router resource to query for Nat + Mapping information of VM endpoints. """ - class LogName(proto.Enum): - r"""The log_name to populate in the Cloud Audit Record.""" - UNDEFINED_LOG_NAME = 0 - ADMIN_ACTIVITY = 427503135 - DATA_ACCESS = 238070681 - UNSPECIFIED_LOG_NAME = 410515182 - - authorization_logging_options = proto.Field( - proto.MESSAGE, - number=217861624, - optional=True, - message="AuthorizationLoggingOptions", - ) - log_name = proto.Field(proto.ENUM, number=402913958, optional=True, enum=LogName,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + router = proto.Field(proto.STRING, number=148608841,) -class LogConfigCounterOptions(proto.Message): - r"""Increment a streamz counter with the specified metric and field - names. +class GetNetworkEndpointGroupRequest(proto.Message): + r"""A request message for NetworkEndpointGroups.Get. See the + method description for details. - Metric names should start with a '/', generally be lowercase-only, - and end in "_count". Field names should not contain an initial - slash. The actual exported metric names will have "/iam/policy" - prepended. + Attributes: + network_endpoint_group (str): + The name of the network endpoint group. It + should comply with RFC1035. + project (str): + Project ID for this request. + zone (str): + The name of the zone where the network + endpoint group is located. It should comply with + RFC1035. + """ - Field names correspond to IAM request parameters and field values - are their respective values. + network_endpoint_group = proto.Field(proto.STRING, number=433907078,) + project = proto.Field(proto.STRING, number=227560217,) + zone = proto.Field(proto.STRING, number=3744684,) - Supported field names: - "authority", which is "[token]" if - IAMContext.token is present, otherwise the value of - IAMContext.authority_selector if present, and otherwise a - representation of IAMContext.principal; or - "iam_principal", a - representation of IAMContext.principal even if a token or authority - selector is present; or - "" (empty string), resulting in a counter - with no fields. - Examples: counter { metric: "/debug_access_count" field: - "iam_principal" } ==> increment counter - /iam/policy/debug_access_count {iam_principal=[value of - IAMContext.principal]} +class GetNetworkRequest(proto.Message): + r"""A request message for Networks.Get. See the method + description for details. Attributes: - custom_fields (Sequence[google.cloud.compute_v1.types.LogConfigCounterOptionsCustomField]): - Custom fields. - field (str): - The field value to attribute. - metric (str): - The metric to update. + network (str): + Name of the network to return. + project (str): + Project ID for this request. """ - custom_fields = proto.RepeatedField( - proto.MESSAGE, number=249651015, message="LogConfigCounterOptionsCustomField", - ) - field = proto.Field(proto.STRING, number=97427706, optional=True,) - metric = proto.Field(proto.STRING, number=533067184, optional=True,) + network = proto.Field(proto.STRING, number=232872494,) + project = proto.Field(proto.STRING, number=227560217,) -class LogConfigDataAccessOptions(proto.Message): - r"""Write a Data Access (Gin) log - Attributes: - log_mode (google.cloud.compute_v1.types.LogConfigDataAccessOptions.LogMode): +class GetNodeGroupRequest(proto.Message): + r"""A request message for NodeGroups.Get. See the method + description for details. + Attributes: + node_group (str): + Name of the node group to return. + project (str): + Project ID for this request. + zone (str): + The name of the zone for this request. """ - class LogMode(proto.Enum): - r"""""" - UNDEFINED_LOG_MODE = 0 - LOG_FAIL_CLOSED = 360469778 - LOG_MODE_UNSPECIFIED = 88160822 + node_group = proto.Field(proto.STRING, number=469958146,) + project = proto.Field(proto.STRING, number=227560217,) + zone = proto.Field(proto.STRING, number=3744684,) - log_mode = proto.Field(proto.ENUM, number=402897342, optional=True, enum=LogMode,) +class GetNodeTemplateRequest(proto.Message): + r"""A request message for NodeTemplates.Get. See the method + description for details. -class LogConfig(proto.Message): - r"""Specifies what kind of log the caller must write Attributes: - cloud_audit (google.cloud.compute_v1.types.LogConfigCloudAuditOptions): - Cloud audit options. - counter (google.cloud.compute_v1.types.LogConfigCounterOptions): - Counter options. - data_access (google.cloud.compute_v1.types.LogConfigDataAccessOptions): - Data access options. + node_template (str): + Name of the node template to return. + project (str): + Project ID for this request. + region (str): + The name of the region for this request. """ - cloud_audit = proto.Field( - proto.MESSAGE, - number=412852561, - optional=True, - message="LogConfigCloudAuditOptions", - ) - counter = proto.Field( - proto.MESSAGE, - number=420959740, - optional=True, - message="LogConfigCounterOptions", - ) - data_access = proto.Field( - proto.MESSAGE, - number=286633881, - optional=True, - message="LogConfigDataAccessOptions", - ) + node_template = proto.Field(proto.STRING, number=323154455,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) -class LogConfigCounterOptionsCustomField(proto.Message): - r"""Custom fields. These can be used to create a counter with - arbitrary field/value pairs. See: go/rpcsp-custom-fields. +class GetNodeTypeRequest(proto.Message): + r"""A request message for NodeTypes.Get. See the method + description for details. Attributes: - name (str): - Name is the field name. - value (str): - Value is the field value. It is important - that in contrast to the CounterOptions.field, - the value here is a constant that is not derived - from the IAMContext. + node_type (str): + Name of the node type to return. + project (str): + Project ID for this request. + zone (str): + The name of the zone for this request. """ - name = proto.Field(proto.STRING, number=3373707, optional=True,) - value = proto.Field(proto.STRING, number=111972721, optional=True,) + node_type = proto.Field(proto.STRING, number=465832791,) + project = proto.Field(proto.STRING, number=227560217,) + zone = proto.Field(proto.STRING, number=3744684,) -class Accelerators(proto.Message): - r""" +class GetPacketMirroringRequest(proto.Message): + r"""A request message for PacketMirrorings.Get. See the method + description for details. + Attributes: - guest_accelerator_count (int): - Number of accelerator cards exposed to the - guest. - guest_accelerator_type (str): - The accelerator type resource name, not a - full URL, e.g. 'nvidia-tesla-k80'. + packet_mirroring (str): + Name of the PacketMirroring resource to + return. + project (str): + Project ID for this request. + region (str): + Name of the region for this request. """ - guest_accelerator_count = proto.Field(proto.INT32, number=479079316, optional=True,) - guest_accelerator_type = proto.Field(proto.STRING, number=293064725, optional=True,) + packet_mirroring = proto.Field(proto.STRING, number=22305996,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) -class ScratchDisks(proto.Message): - r""" +class GetProjectRequest(proto.Message): + r"""A request message for Projects.Get. See the method + description for details. + Attributes: - disk_gb (int): - Size of the scratch disk, defined in GB. + project (str): + Project ID for this request. """ - disk_gb = proto.Field(proto.INT32, number=60990141, optional=True,) - + project = proto.Field(proto.STRING, number=227560217,) -class MachineType(proto.Message): - r"""Represents a Machine Type resource. - You can use specific machine types for your VM instances based on - performance and pricing requirements. For more information, read - Machine Types. (== resource_for {$api_version}.machineTypes ==) +class GetPublicAdvertisedPrefixeRequest(proto.Message): + r"""A request message for PublicAdvertisedPrefixes.Get. See the + method description for details. Attributes: - accelerators (Sequence[google.cloud.compute_v1.types.Accelerators]): - [Output Only] A list of accelerator configurations assigned - to this machine type. - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - deprecated (google.cloud.compute_v1.types.DeprecationStatus): - [Output Only] The deprecation status associated with this - machine type. Only applicable if the machine type is - unavailable. - description (str): - [Output Only] An optional textual description of the - resource. - guest_cpus (int): - [Output Only] The number of virtual CPUs that are available - to the instance. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - image_space_gb (int): - [Deprecated] This property is deprecated and will never be - populated with any relevant values. - is_shared_cpu (bool): - [Output Only] Whether this machine type has a shared CPU. - See Shared-core machine types for more information. - kind (str): - [Output Only] The type of the resource. Always - compute#machineType for machine types. - maximum_persistent_disks (int): - [Output Only] Maximum persistent disks allowed. - maximum_persistent_disks_size_gb (int): - [Output Only] Maximum total persistent disks size (GB) - allowed. - memory_mb (int): - [Output Only] The amount of physical memory available to the - instance, defined in MB. - name (str): - [Output Only] Name of the resource. - scratch_disks (Sequence[google.cloud.compute_v1.types.ScratchDisks]): - [Output Only] A list of extended scratch disks assigned to - the instance. - self_link (str): - [Output Only] Server-defined URL for the resource. - zone (str): - [Output Only] The name of the zone where the machine type - resides, such as us-central1-a. + project (str): + Project ID for this request. + public_advertised_prefix (str): + Name of the PublicAdvertisedPrefix resource + to return. """ - accelerators = proto.RepeatedField( - proto.MESSAGE, number=269577064, message="Accelerators", - ) - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - deprecated = proto.Field( - proto.MESSAGE, number=515138995, optional=True, message="DeprecationStatus", - ) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - guest_cpus = proto.Field(proto.INT32, number=393356754, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - image_space_gb = proto.Field(proto.INT32, number=75331864, optional=True,) - is_shared_cpu = proto.Field(proto.BOOL, number=521399555, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - maximum_persistent_disks = proto.Field( - proto.INT32, number=496220941, optional=True, - ) - maximum_persistent_disks_size_gb = proto.Field( - proto.INT64, number=154274471, optional=True, - ) - memory_mb = proto.Field(proto.INT32, number=116001171, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - scratch_disks = proto.RepeatedField( - proto.MESSAGE, number=480778481, message="ScratchDisks", - ) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - zone = proto.Field(proto.STRING, number=3744684, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + public_advertised_prefix = proto.Field(proto.STRING, number=101874590,) -class MachineTypesScopedList(proto.Message): - r""" +class GetPublicDelegatedPrefixeRequest(proto.Message): + r"""A request message for PublicDelegatedPrefixes.Get. See the + method description for details. + Attributes: - machine_types (Sequence[google.cloud.compute_v1.types.MachineType]): - [Output Only] A list of machine types contained in this - scope. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] An informational warning that appears when the - machine types list is empty. + project (str): + Project ID for this request. + public_delegated_prefix (str): + Name of the PublicDelegatedPrefix resource to + return. + region (str): + Name of the region of this request. """ - machine_types = proto.RepeatedField( - proto.MESSAGE, number=79720065, message="MachineType", - ) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) + project = proto.Field(proto.STRING, number=227560217,) + public_delegated_prefix = proto.Field(proto.STRING, number=204238440,) + region = proto.Field(proto.STRING, number=138946292,) + +class GetRegionAutoscalerRequest(proto.Message): + r"""A request message for RegionAutoscalers.Get. See the method + description for details. -class MachineTypeAggregatedList(proto.Message): - r""" Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.MachineTypeAggregatedList.ItemsEntry]): - A list of MachineTypesScopedList resources. - kind (str): - [Output Only] Type of resource. Always - compute#machineTypeAggregatedList for aggregated lists of - machine types. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - unreachables (Sequence[str]): - [Output Only] Unreachable resources. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + autoscaler (str): + Name of the autoscaler to return. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. """ - @property - def raw_page(self): - return self + autoscaler = proto.Field(proto.STRING, number=517258967,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.MapField( - proto.STRING, proto.MESSAGE, number=100526016, message="MachineTypesScopedList", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - unreachables = proto.RepeatedField(proto.STRING, number=243372063,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) +class GetRegionBackendServiceRequest(proto.Message): + r"""A request message for RegionBackendServices.Get. See the + method description for details. -class MachineTypeList(proto.Message): - r"""Contains a list of machine types. Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.MachineType]): - A list of MachineType resources. - kind (str): - [Output Only] Type of resource. Always - compute#machineTypeList for lists of machine types. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + backend_service (str): + Name of the BackendService resource to + return. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. """ - @property - def raw_page(self): - return self + backend_service = proto.Field(proto.STRING, number=306946058,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="MachineType",) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) +class GetRegionCommitmentRequest(proto.Message): + r"""A request message for RegionCommitments.Get. See the method + description for details. -class ManagedInstanceInstanceHealth(proto.Message): - r""" Attributes: - detailed_health_state (google.cloud.compute_v1.types.ManagedInstanceInstanceHealth.DetailedHealthState): - [Output Only] The current detailed instance health state. - health_check (str): - [Output Only] The URL for the health check that verifies - whether the instance is healthy. + commitment (str): + Name of the commitment to return. + project (str): + Project ID for this request. + region (str): + Name of the region for this request. """ - class DetailedHealthState(proto.Enum): - r"""[Output Only] The current detailed instance health state.""" - UNDEFINED_DETAILED_HEALTH_STATE = 0 - DRAINING = 480455402 - HEALTHY = 439801213 - TIMEOUT = 477813057 - UNHEALTHY = 462118084 - UNKNOWN = 433141802 + commitment = proto.Field(proto.STRING, number=482134805,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) - detailed_health_state = proto.Field( - proto.ENUM, number=510470173, optional=True, enum=DetailedHealthState, - ) - health_check = proto.Field(proto.STRING, number=308876645, optional=True,) +class GetRegionDiskRequest(proto.Message): + r"""A request message for RegionDisks.Get. See the method + description for details. -class ManagedInstanceLastAttempt(proto.Message): - r""" Attributes: - errors (google.cloud.compute_v1.types.Errors): - [Output Only] Encountered errors during the last attempt to - create or delete the instance. + disk (str): + Name of the regional persistent disk to + return. + project (str): + Project ID for this request. + region (str): + Name of the region for this request. """ - errors = proto.Field( - proto.MESSAGE, number=315977579, optional=True, message="Errors", - ) + disk = proto.Field(proto.STRING, number=3083677,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) -class PreservedState(proto.Message): - r"""Preserved state for a given instance. +class GetRegionDiskTypeRequest(proto.Message): + r"""A request message for RegionDiskTypes.Get. See the method + description for details. + Attributes: - disks (Sequence[google.cloud.compute_v1.types.PreservedState.DisksEntry]): - Preserved disks defined for this instance. - This map is keyed with the device names of the - disks. - metadata (Sequence[google.cloud.compute_v1.types.PreservedState.MetadataEntry]): - Preserved metadata defined for this instance. + disk_type (str): + Name of the disk type to return. + project (str): + Project ID for this request. + region (str): + The name of the region for this request. """ - disks = proto.MapField( - proto.STRING, - proto.MESSAGE, - number=95594102, - message="PreservedStatePreservedDisk", - ) - metadata = proto.MapField(proto.STRING, proto.STRING, number=86866735,) + disk_type = proto.Field(proto.STRING, number=93009052,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) -class Errors(proto.Message): - r""" +class GetRegionHealthCheckRequest(proto.Message): + r"""A request message for RegionHealthChecks.Get. See the method + description for details. + Attributes: - code (str): - [Output Only] The error type identifier for this error. - location (str): - [Output Only] Indicates the field in the request that caused - the error. This property is optional. - message (str): - [Output Only] An optional, human-readable error message. + health_check (str): + Name of the HealthCheck resource to return. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. """ - code = proto.Field(proto.STRING, number=3059181, optional=True,) - location = proto.Field(proto.STRING, number=290430901, optional=True,) - message = proto.Field(proto.STRING, number=418054151, optional=True,) + health_check = proto.Field(proto.STRING, number=308876645,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) -class Items(proto.Message): - r""" +class GetRegionHealthCheckServiceRequest(proto.Message): + r"""A request message for RegionHealthCheckServices.Get. See the + method description for details. + Attributes: - key (str): - Key for the metadata entry. Keys must conform to the - following regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes - in length. This is reflected as part of a URL in the - metadata server. Additionally, to avoid ambiguity, keys must - not conflict with any other metadata keys for the project. - value (str): - Value for the metadata entry. These are free- - orm strings, and only have meaning as - interpreted by the image running in the - instance. The only restriction placed on values - is that their size must be less than or equal to - 262144 bytes (256 KiB). + health_check_service (str): + Name of the HealthCheckService to update. The + name must be 1-63 characters long, and comply + with RFC1035. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. """ - key = proto.Field(proto.STRING, number=106079, optional=True,) - value = proto.Field(proto.STRING, number=111972721, optional=True,) + health_check_service = proto.Field(proto.STRING, number=408374747,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) -class MetadataFilterLabelMatch(proto.Message): - r"""MetadataFilter label name value pairs that are expected to - match corresponding labels presented as metadata to the - loadbalancer. +class GetRegionInstanceGroupManagerRequest(proto.Message): + r"""A request message for RegionInstanceGroupManagers.Get. See + the method description for details. Attributes: - name (str): - Name of metadata label. - The name can have a maximum length of 1024 - characters and must be at least 1 character - long. - value (str): - The value of the label must match the - specified value. value can have a maximum length - of 1024 characters. + instance_group_manager (str): + Name of the managed instance group to return. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. """ - name = proto.Field(proto.STRING, number=3373707, optional=True,) - value = proto.Field(proto.STRING, number=111972721, optional=True,) + instance_group_manager = proto.Field(proto.STRING, number=249363395,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) -class NetworkPeering(proto.Message): - r"""A network peering attached to a network resource. The message - includes the peering name, peer network, peering state, and a - flag indicating whether Google Compute Engine should - automatically create routes for the peering. +class GetRegionInstanceGroupRequest(proto.Message): + r"""A request message for RegionInstanceGroups.Get. See the + method description for details. Attributes: - auto_create_routes (bool): - This field will be deprecated soon. Use the - exchange_subnet_routes field instead. Indicates whether full - mesh connectivity is created and managed automatically - between peered networks. Currently this field should always - be true since Google Compute Engine will automatically - create and manage subnetwork routes between two networks - when peering state is ACTIVE. - exchange_subnet_routes (bool): - Indicates whether full mesh connectivity is - created and managed automatically between peered - networks. Currently this field should always be - true since Google Compute Engine will - automatically create and manage subnetwork - routes between two networks when peering state - is ACTIVE. - export_custom_routes (bool): - Whether to export the custom routes to peer - network. - export_subnet_routes_with_public_ip (bool): - Whether subnet routes with public IP range are exported. The - default value is true, all subnet routes are exported. The - IPv4 special-use ranges - (https://en.wikipedia.org/wiki/IPv4#Special_addresses) are - always exported to peers and are not controlled by this - field. - import_custom_routes (bool): - Whether to import the custom routes from peer - network. - import_subnet_routes_with_public_ip (bool): - Whether subnet routes with public IP range are imported. The - default value is false. The IPv4 special-use ranges - (https://en.wikipedia.org/wiki/IPv4#Special_addresses) are - always imported from peers and are not controlled by this - field. - name (str): - Name of this peering. Provided by the client when the - peering is created. The name must comply with RFC1035. - Specifically, the name must be 1-63 characters long and - match regular expression ``[a-z]([-a-z0-9]*[a-z0-9])?``. The - first character must be a lowercase letter, and all the - following characters must be a dash, lowercase letter, or - digit, except the last character, which cannot be a dash. - network (str): - The URL of the peer network. It can be either - full URL or partial URL. The peer network may - belong to a different project. If the partial - URL does not contain project, it is assumed that - the peer network is in the same project as the - current network. - peer_mtu (int): - Maximum Transmission Unit in bytes. - state (google.cloud.compute_v1.types.NetworkPeering.State): - [Output Only] State for the peering, either ``ACTIVE`` or - ``INACTIVE``. The peering is ``ACTIVE`` when there's a - matching configuration in the peer network. - state_details (str): - [Output Only] Details about the current state of the - peering. + instance_group (str): + Name of the instance group resource to + return. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. """ - class State(proto.Enum): - r"""[Output Only] State for the peering, either ``ACTIVE`` or - ``INACTIVE``. The peering is ``ACTIVE`` when there's a matching - configuration in the peer network. - """ - UNDEFINED_STATE = 0 - ACTIVE = 314733318 - INACTIVE = 270421099 - - auto_create_routes = proto.Field(proto.BOOL, number=57454941, optional=True,) - exchange_subnet_routes = proto.Field(proto.BOOL, number=26322256, optional=True,) - export_custom_routes = proto.Field(proto.BOOL, number=60281485, optional=True,) - export_subnet_routes_with_public_ip = proto.Field( - proto.BOOL, number=97940834, optional=True, - ) - import_custom_routes = proto.Field(proto.BOOL, number=197982398, optional=True,) - import_subnet_routes_with_public_ip = proto.Field( - proto.BOOL, number=14419729, optional=True, - ) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - network = proto.Field(proto.STRING, number=232872494, optional=True,) - peer_mtu = proto.Field(proto.INT32, number=69584721, optional=True,) - state = proto.Field(proto.ENUM, number=109757585, optional=True, enum=State,) - state_details = proto.Field(proto.STRING, number=95566996, optional=True,) + instance_group = proto.Field(proto.STRING, number=81095253,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) -class NetworkRoutingConfig(proto.Message): - r"""A routing configuration attached to a network resource. The - message includes the list of routers associated with the - network, and a flag indicating the type of routing behavior to - enforce network-wide. +class GetRegionNetworkEndpointGroupRequest(proto.Message): + r"""A request message for RegionNetworkEndpointGroups.Get. See + the method description for details. Attributes: - routing_mode (google.cloud.compute_v1.types.NetworkRoutingConfig.RoutingMode): - The network-wide routing mode to use. If set - to REGIONAL, this network's Cloud Routers will - only advertise routes with subnets of this - network in the same region as the router. If set - to GLOBAL, this network's Cloud Routers will - advertise routes with all subnets of this - network, across regions. + network_endpoint_group (str): + The name of the network endpoint group. It + should comply with RFC1035. + project (str): + Project ID for this request. + region (str): + The name of the region where the network + endpoint group is located. It should comply with + RFC1035. """ - class RoutingMode(proto.Enum): - r"""The network-wide routing mode to use. If set to REGIONAL, - this network's Cloud Routers will only advertise routes with - subnets of this network in the same region as the router. If set - to GLOBAL, this network's Cloud Routers will advertise routes - with all subnets of this network, across regions. - """ - UNDEFINED_ROUTING_MODE = 0 - GLOBAL = 494663587 - REGIONAL = 92288543 + network_endpoint_group = proto.Field(proto.STRING, number=433907078,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) - routing_mode = proto.Field( - proto.ENUM, number=475143548, optional=True, enum=RoutingMode, - ) +class GetRegionNotificationEndpointRequest(proto.Message): + r"""A request message for RegionNotificationEndpoints.Get. See + the method description for details. + + Attributes: + notification_endpoint (str): + Name of the NotificationEndpoint resource to + return. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + """ + + notification_endpoint = proto.Field(proto.STRING, number=376807017,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) -class Network(proto.Message): - r"""Represents a VPC Network resource. - Networks connect resources to each other and to the internet. For - more information, read Virtual Private Cloud (VPC) Network. (== - resource_for {$api_version}.networks ==) +class GetRegionOperationRequest(proto.Message): + r"""A request message for RegionOperations.Get. See the method + description for details. Attributes: - I_pv4_range (str): - Deprecated in favor of subnet mode networks. - The range of internal addresses that are legal - on this network. This range is a CIDR - specification, for example: 192.168.0.0/16. - Provided by the client when the network is - created. - auto_create_subnetworks (bool): - Must be set to create a VPC network. If not - set, a legacy network is created. - When set to true, the VPC network is created in - auto mode. When set to false, the VPC network is - created in custom mode. - An auto mode VPC network starts with one subnet - per region. Each subnet has a predetermined - range as described in Auto mode VPC network IP - ranges. - For custom mode VPC networks, you can add - subnets using the subnetworks insert method. - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - description (str): - An optional description of this resource. - Provide this field when you create the resource. - gateway_i_pv4 (str): - [Output Only] The gateway address for default routing out of - the network, selected by GCP. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - kind (str): - [Output Only] Type of the resource. Always compute#network - for networks. - mtu (int): - Maximum Transmission Unit in bytes. The - minimum value for this field is 1460 and the - maximum value is 1500 bytes. - name (str): - Name of the resource. Provided by the client when the - resource is created. The name must be 1-63 characters long, - and comply with RFC1035. Specifically, the name must be 1-63 - characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?``. The first character must be - a lowercase letter, and all following characters (except for - the last character) must be a dash, lowercase letter, or - digit. The last character must be a lowercase letter or - digit. - peerings (Sequence[google.cloud.compute_v1.types.NetworkPeering]): - [Output Only] A list of network peerings for the resource. - routing_config (google.cloud.compute_v1.types.NetworkRoutingConfig): - The network-level routing configuration for - this network. Used by Cloud Router to determine - what type of network-wide routing behavior to - enforce. - self_link (str): - [Output Only] Server-defined URL for the resource. - subnetworks (Sequence[str]): - [Output Only] Server-defined fully-qualified URLs for all - subnetworks in this VPC network. + operation (str): + Name of the Operations resource to return. + project (str): + Project ID for this request. + region (str): + Name of the region for this request. """ - I_pv4_range = proto.Field(proto.STRING, number=59234358, optional=True,) - auto_create_subnetworks = proto.Field(proto.BOOL, number=256156690, optional=True,) - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - gateway_i_pv4 = proto.Field(proto.STRING, number=178678877, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - mtu = proto.Field(proto.INT32, number=108462, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - peerings = proto.RepeatedField( - proto.MESSAGE, number=69883187, message="NetworkPeering", - ) - routing_config = proto.Field( - proto.MESSAGE, number=523556059, optional=True, message="NetworkRoutingConfig", - ) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - subnetworks = proto.RepeatedField(proto.STRING, number=415853125,) + operation = proto.Field(proto.STRING, number=52090215,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) -class NetworkEndpointGroupAppEngine(proto.Message): - r"""Configuration for an App Engine network endpoint group (NEG). - The service is optional, may be provided explicitly or in the - URL mask. The version is optional and can only be provided - explicitly or in the URL mask when service is present. Note: - App Engine service must be in the same project and located in - the same region as the Serverless NEG. +class GetRegionRequest(proto.Message): + r"""A request message for Regions.Get. See the method description + for details. Attributes: - service (str): - Optional serving service. - The service name is case-sensitive and must be - 1-63 characters long. - Example value: "default", "my-service". - url_mask (str): - A template to parse service and version - fields from a request URL. URL mask allows for - routing to multiple App Engine services without - having to create multiple Network Endpoint - Groups and backend services. For example, the - request URLs "foo1-dot-appname.appspot.com/v1" - and "foo1-dot-appname.appspot.com/v2" can be - backed by the same Serverless NEG with URL mask - "-dot-appname.appspot.com/". The URL mask will - parse them to { service = "foo1", version = "v1" - } and { service = "foo1", version = "v2" } - respectively. - version (str): - Optional serving version. - The version name is case-sensitive and must be - 1-100 characters long. - Example value: "v1", "v2". + project (str): + Project ID for this request. + region (str): + Name of the region resource to return. """ - service = proto.Field(proto.STRING, number=373540533, optional=True,) - url_mask = proto.Field(proto.STRING, number=103352252, optional=True,) - version = proto.Field(proto.STRING, number=351608024, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) -class NetworkEndpointGroupCloudFunction(proto.Message): - r"""Configuration for a Cloud Function network endpoint group - (NEG). The function must be provided explicitly or in the URL - mask. Note: Cloud Function must be in the same project and - located in the same region as the Serverless NEG. +class GetRegionSslCertificateRequest(proto.Message): + r"""A request message for RegionSslCertificates.Get. See the + method description for details. Attributes: - function (str): - A user-defined name of the Cloud Function. - The function name is case-sensitive and must be - 1-63 characters long. - Example value: "func1". - url_mask (str): - A template to parse function field from a - request URL. URL mask allows for routing to - multiple Cloud Functions without having to - create multiple Network Endpoint Groups and - backend services. For example, request URLs - "mydomain.com/function1" and - "mydomain.com/function2" can be backed by the - same Serverless NEG with URL mask "/". The URL - mask will parse them to { function = "function1" - } and { function = "function2" } respectively. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + ssl_certificate (str): + Name of the SslCertificate resource to + return. """ - function = proto.Field(proto.STRING, number=307196888, optional=True,) - url_mask = proto.Field(proto.STRING, number=103352252, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + ssl_certificate = proto.Field(proto.STRING, number=46443492,) -class NetworkEndpointGroupCloudRun(proto.Message): - r"""Configuration for a Cloud Run network endpoint group (NEG). - The service must be provided explicitly or in the URL mask. The - tag is optional, may be provided explicitly or in the URL mask. - Note: Cloud Run service must be in the same project and located - in the same region as the Serverless NEG. +class GetRegionTargetHttpProxyRequest(proto.Message): + r"""A request message for RegionTargetHttpProxies.Get. See the + method description for details. Attributes: - service (str): - Cloud Run service is the main resource of - Cloud Run. - The service must be 1-63 characters long, and - comply with RFC1035. - Example value: "run-service". - tag (str): - Optional Cloud Run tag represents the "named- - evision" to provide additional fine-grained - traffic routing information. The tag must be - 1-63 characters long, and comply with RFC1035. - Example value: "revision-0010". - url_mask (str): - A template to parse service and tag fields - from a request URL. URL mask allows for routing - to multiple Run services without having to - create multiple network endpoint groups and - backend services. For example, request URLs - "foo1.domain.com/bar1" and - "foo1.domain.com/bar2" can be backed by the same - Serverless Network Endpoint Group (NEG) with URL - mask ".domain.com/". The URL mask will parse - them to { service="bar1", tag="foo1" } and { - service="bar2", tag="foo2" } respectively. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + target_http_proxy (str): + Name of the TargetHttpProxy resource to + return. """ - service = proto.Field(proto.STRING, number=373540533, optional=True,) - tag = proto.Field(proto.STRING, number=114586, optional=True,) - url_mask = proto.Field(proto.STRING, number=103352252, optional=True,) - + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + target_http_proxy = proto.Field(proto.STRING, number=206872421,) -class NetworkEndpointGroup(proto.Message): - r"""Represents a collection of network endpoints. - A network endpoint group (NEG) defines how a set of endpoints should - be reached, whether they are reachable, and where they are located. - For more information about using NEGs, see Setting up external - HTTP(S) Load Balancing with internet NEGs, Setting up zonal NEGs, or - Setting up external HTTP(S) Load Balancing with serverless NEGs. (== - resource_for {$api_version}.networkEndpointGroups ==) (== - resource_for {$api_version}.globalNetworkEndpointGroups ==) (== - resource_for {$api_version}.regionNetworkEndpointGroups ==) +class GetRegionTargetHttpsProxyRequest(proto.Message): + r"""A request message for RegionTargetHttpsProxies.Get. See the + method description for details. Attributes: - annotations (Sequence[google.cloud.compute_v1.types.NetworkEndpointGroup.AnnotationsEntry]): - Metadata defined as annotations on the - network endpoint group. - app_engine (google.cloud.compute_v1.types.NetworkEndpointGroupAppEngine): - Only valid when networkEndpointType is - "SERVERLESS". Only one of cloudRun, appEngine or - cloudFunction may be set. - cloud_function (google.cloud.compute_v1.types.NetworkEndpointGroupCloudFunction): - Only valid when networkEndpointType is - "SERVERLESS". Only one of cloudRun, appEngine or - cloudFunction may be set. - cloud_run (google.cloud.compute_v1.types.NetworkEndpointGroupCloudRun): - Only valid when networkEndpointType is - "SERVERLESS". Only one of cloudRun, appEngine or - cloudFunction may be set. - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - default_port (int): - The default port used if the port number is - not specified in the network endpoint. - description (str): - An optional description of this resource. - Provide this property when you create the - resource. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - kind (str): - [Output Only] Type of the resource. Always - compute#networkEndpointGroup for network endpoint group. - name (str): - Name of the resource; provided by the client when the - resource is created. The name must be 1-63 characters long, - and comply with RFC1035. Specifically, the name must be 1-63 - characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. - network (str): - The URL of the network to which all network - endpoints in the NEG belong. Uses "default" - project network if unspecified. - network_endpoint_type (google.cloud.compute_v1.types.NetworkEndpointGroup.NetworkEndpointType): - Type of network endpoints in this network endpoint group. - Can be one of GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, - INTERNET_FQDN_PORT, INTERNET_IP_PORT, or SERVERLESS. + project (str): + Project ID for this request. region (str): - [Output Only] The URL of the region where the network - endpoint group is located. - self_link (str): - [Output Only] Server-defined URL for the resource. - size (int): - [Output only] Number of network endpoints in the network - endpoint group. - subnetwork (str): - Optional URL of the subnetwork to which all - network endpoints in the NEG belong. - zone (str): - [Output Only] The URL of the zone where the network endpoint - group is located. + Name of the region scoping this request. + target_https_proxy (str): + Name of the TargetHttpsProxy resource to + return. """ - class NetworkEndpointType(proto.Enum): - r"""Type of network endpoints in this network endpoint group. Can be one - of GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, - INTERNET_IP_PORT, or SERVERLESS. - """ - UNDEFINED_NETWORK_ENDPOINT_TYPE = 0 - GCE_VM_IP = 401880793 - GCE_VM_IP_PORT = 501838375 - INTERNET_FQDN_PORT = 404154477 - INTERNET_IP_PORT = 477719963 - NON_GCP_PRIVATE_IP_PORT = 336447968 - SERVERLESS = 270492508 + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + target_https_proxy = proto.Field(proto.STRING, number=52336748,) - annotations = proto.MapField(proto.STRING, proto.STRING, number=112032548,) - app_engine = proto.Field( - proto.MESSAGE, - number=340788768, - optional=True, - message="NetworkEndpointGroupAppEngine", - ) - cloud_function = proto.Field( - proto.MESSAGE, - number=519893666, - optional=True, - message="NetworkEndpointGroupCloudFunction", - ) - cloud_run = proto.Field( - proto.MESSAGE, - number=111060353, - optional=True, - message="NetworkEndpointGroupCloudRun", - ) - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - default_port = proto.Field(proto.INT32, number=423377855, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - network = proto.Field(proto.STRING, number=232872494, optional=True,) - network_endpoint_type = proto.Field( - proto.ENUM, number=118301523, optional=True, enum=NetworkEndpointType, - ) - region = proto.Field(proto.STRING, number=138946292, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - size = proto.Field(proto.INT32, number=3530753, optional=True,) - subnetwork = proto.Field(proto.STRING, number=307827694, optional=True,) - zone = proto.Field(proto.STRING, number=3744684, optional=True,) +class GetRegionUrlMapRequest(proto.Message): + r"""A request message for RegionUrlMaps.Get. See the method + description for details. -class NetworkEndpointGroupsScopedList(proto.Message): - r""" Attributes: - network_endpoint_groups (Sequence[google.cloud.compute_v1.types.NetworkEndpointGroup]): - [Output Only] The list of network endpoint groups that are - contained in this scope. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] An informational warning that replaces the - list of network endpoint groups when the list is empty. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + url_map (str): + Name of the UrlMap resource to return. """ - network_endpoint_groups = proto.RepeatedField( - proto.MESSAGE, number=29346733, message="NetworkEndpointGroup", - ) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + url_map = proto.Field(proto.STRING, number=367020684,) -class NetworkEndpointGroupAggregatedList(proto.Message): - r""" +class GetReservationRequest(proto.Message): + r"""A request message for Reservations.Get. See the method + description for details. + Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.NetworkEndpointGroupAggregatedList.ItemsEntry]): - A list of NetworkEndpointGroupsScopedList - resources. - kind (str): - [Output Only] The resource type, which is always - compute#networkEndpointGroupAggregatedList for aggregated - lists of network endpoint groups. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - unreachables (Sequence[str]): - [Output Only] Unreachable resources. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + project (str): + Project ID for this request. + reservation (str): + Name of the reservation to retrieve. + zone (str): + Name of the zone for this request. """ - @property - def raw_page(self): - return self + project = proto.Field(proto.STRING, number=227560217,) + reservation = proto.Field(proto.STRING, number=47530956,) + zone = proto.Field(proto.STRING, number=3744684,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.MapField( - proto.STRING, - proto.MESSAGE, - number=100526016, - message="NetworkEndpointGroupsScopedList", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - unreachables = proto.RepeatedField(proto.STRING, number=243372063,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) +class GetResourcePolicyRequest(proto.Message): + r"""A request message for ResourcePolicies.Get. See the method + description for details. -class NetworkEndpointGroupList(proto.Message): - r""" Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.NetworkEndpointGroup]): - A list of NetworkEndpointGroup resources. - kind (str): - [Output Only] The resource type, which is always - compute#networkEndpointGroupList for network endpoint group - lists. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + project (str): + Project ID for this request. + region (str): + Name of the region for this request. + resource_policy (str): + Name of the resource policy to retrieve. """ - @property - def raw_page(self): - return self + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + resource_policy = proto.Field(proto.STRING, number=159240835,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="NetworkEndpointGroup", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) +class GetRouteRequest(proto.Message): + r"""A request message for Routes.Get. See the method description + for details. -class NetworkEndpointGroupsAttachEndpointsRequest(proto.Message): - r""" Attributes: - network_endpoints (Sequence[google.cloud.compute_v1.types.NetworkEndpoint]): - The list of network endpoints to be attached. + project (str): + Project ID for this request. + route (str): + Name of the Route resource to return. """ - network_endpoints = proto.RepeatedField( - proto.MESSAGE, number=149850285, message="NetworkEndpoint", - ) + project = proto.Field(proto.STRING, number=227560217,) + route = proto.Field(proto.STRING, number=108704329,) -class NetworkEndpointGroupsDetachEndpointsRequest(proto.Message): - r""" +class GetRouterRequest(proto.Message): + r"""A request message for Routers.Get. See the method description + for details. + Attributes: - network_endpoints (Sequence[google.cloud.compute_v1.types.NetworkEndpoint]): - The list of network endpoints to be detached. + project (str): + Project ID for this request. + region (str): + Name of the region for this request. + router (str): + Name of the Router resource to return. """ - network_endpoints = proto.RepeatedField( - proto.MESSAGE, number=149850285, message="NetworkEndpoint", - ) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + router = proto.Field(proto.STRING, number=148608841,) -class NetworkEndpointGroupsListEndpointsRequest(proto.Message): - r""" +class GetRouterStatusRouterRequest(proto.Message): + r"""A request message for Routers.GetRouterStatus. See the method + description for details. + Attributes: - health_status (google.cloud.compute_v1.types.NetworkEndpointGroupsListEndpointsRequest.HealthStatus): - Optional query parameter for showing the - health status of each network endpoint. Valid - options are SKIP or SHOW. If you don't specify - this parameter, the health status of network - endpoints will not be provided. + project (str): + Project ID for this request. + region (str): + Name of the region for this request. + router (str): + Name of the Router resource to query. """ - class HealthStatus(proto.Enum): - r"""Optional query parameter for showing the health status of - each network endpoint. Valid options are SKIP or SHOW. If you - don't specify this parameter, the health status of network - endpoints will not be provided. - """ - UNDEFINED_HEALTH_STATUS = 0 - SHOW = 2544381 - SKIP = 2547071 + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + router = proto.Field(proto.STRING, number=148608841,) - health_status = proto.Field( - proto.ENUM, number=380545845, optional=True, enum=HealthStatus, - ) +class GetRuleFirewallPolicyRequest(proto.Message): + r"""A request message for FirewallPolicies.GetRule. See the + method description for details. -class NetworkEndpointWithHealthStatus(proto.Message): - r""" Attributes: - healths (Sequence[google.cloud.compute_v1.types.HealthStatusForNetworkEndpoint]): - [Output only] The health status of network endpoint; - network_endpoint (google.cloud.compute_v1.types.NetworkEndpoint): - [Output only] The network endpoint; + firewall_policy (str): + Name of the firewall policy to which the + queried rule belongs. + priority (int): + The priority of the rule to get from the + firewall policy. """ - healths = proto.RepeatedField( - proto.MESSAGE, number=258689431, message="HealthStatusForNetworkEndpoint", - ) - network_endpoint = proto.Field( - proto.MESSAGE, number=56789126, optional=True, message="NetworkEndpoint", - ) + firewall_policy = proto.Field(proto.STRING, number=498173265,) + priority = proto.Field(proto.INT32, number=445151652, optional=True,) -class NetworkEndpointGroupsListNetworkEndpoints(proto.Message): - r""" +class GetRuleSecurityPolicyRequest(proto.Message): + r"""A request message for SecurityPolicies.GetRule. See the + method description for details. + Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.NetworkEndpointWithHealthStatus]): - A list of NetworkEndpointWithHealthStatus - resources. - kind (str): - [Output Only] The resource type, which is always - compute#networkEndpointGroupsListNetworkEndpoints for the - list of network endpoints in the specified network endpoint - group. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + priority (int): + The priority of the rule to get from the + security policy. + project (str): + Project ID for this request. + security_policy (str): + Name of the security policy to which the + queried rule belongs. """ - @property - def raw_page(self): - return self + priority = proto.Field(proto.INT32, number=445151652, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + security_policy = proto.Field(proto.STRING, number=171082513,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="NetworkEndpointWithHealthStatus", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) +class GetScreenshotInstanceRequest(proto.Message): + r"""A request message for Instances.GetScreenshot. See the method + description for details. -class NetworkList(proto.Message): - r"""Contains a list of networks. Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.Network]): - A list of Network resources. - kind (str): - [Output Only] Type of resource. Always compute#networkList - for lists of networks. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + instance (str): + Name of the instance scoping this request. + project (str): + Project ID for this request. + zone (str): + The name of the zone for this request. """ - @property - def raw_page(self): - return self + instance = proto.Field(proto.STRING, number=18257045,) + project = proto.Field(proto.STRING, number=227560217,) + zone = proto.Field(proto.STRING, number=3744684,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Network",) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) + +class GetSecurityPolicyRequest(proto.Message): + r"""A request message for SecurityPolicies.Get. See the method + description for details. + + Attributes: + project (str): + Project ID for this request. + security_policy (str): + Name of the security policy to get. + """ + + project = proto.Field(proto.STRING, number=227560217,) + security_policy = proto.Field(proto.STRING, number=171082513,) -class NetworksAddPeeringRequest(proto.Message): - r""" +class GetSerialPortOutputInstanceRequest(proto.Message): + r"""A request message for Instances.GetSerialPortOutput. See the + method description for details. + Attributes: - auto_create_routes (bool): - This field will be deprecated soon. Use - exchange_subnet_routes in network_peering instead. Indicates - whether full mesh connectivity is created and managed - automatically between peered networks. Currently this field - should always be true since Google Compute Engine will - automatically create and manage subnetwork routes between - two networks when peering state is ACTIVE. - name (str): - Name of the peering, which should conform to - RFC1035. - network_peering (google.cloud.compute_v1.types.NetworkPeering): - Network peering parameters. In order to specify route - policies for peering using import and export custom routes, - you must specify all peering related parameters (name, peer - network, exchange_subnet_routes) in the network_peering - field. The corresponding fields in NetworksAddPeeringRequest - will be deprecated soon. - peer_network (str): - URL of the peer network. It can be either - full URL or partial URL. The peer network may - belong to a different project. If the partial - URL does not contain project, it is assumed that - the peer network is in the same project as the - current network. + instance (str): + Name of the instance for this request. + port (int): + Specifies which COM or serial port to + retrieve data from. + project (str): + Project ID for this request. + start (int): + Specifies the starting byte position of the output to + return. To start with the first byte of output to the + specified port, omit this field or set it to ``0``. If the + output for that byte position is available, this field + matches the ``start`` parameter sent with the request. If + the amount of serial console output exceeds the size of the + buffer (1 MB), the oldest output is discarded and is no + longer available. If the requested start position refers to + discarded output, the start position is adjusted to the + oldest output still available, and the adjusted start + position is returned as the ``start`` property value. You + can also provide a negative start position, which translates + to the most recent number of bytes written to the serial + port. For example, -3 is interpreted as the most recent 3 + bytes written to the serial console. + zone (str): + The name of the zone for this request. """ - auto_create_routes = proto.Field(proto.BOOL, number=57454941, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - network_peering = proto.Field( - proto.MESSAGE, number=328926767, optional=True, message="NetworkPeering", - ) - peer_network = proto.Field(proto.STRING, number=500625489, optional=True,) + instance = proto.Field(proto.STRING, number=18257045,) + port = proto.Field(proto.INT32, number=3446913, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + start = proto.Field(proto.INT64, number=109757538, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy(proto.Message): - r""" +class GetServiceAttachmentRequest(proto.Message): + r"""A request message for ServiceAttachments.Get. See the method + description for details. + Attributes: - display_name (str): - [Output Only] Deprecated, please use short name instead. The - display name of the firewall policy. - name (str): - [Output Only] The name of the firewall policy. - rules (Sequence[google.cloud.compute_v1.types.FirewallPolicyRule]): - The rules that apply to the network. - short_name (str): - [Output Only] The short name of the firewall policy. - type_ (google.cloud.compute_v1.types.NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy.Type): - [Output Only] The type of the firewall policy. + project (str): + Project ID for this request. + region (str): + Name of the region of this request. + service_attachment (str): + Name of the ServiceAttachment resource to + return. """ - class Type(proto.Enum): - r"""[Output Only] The type of the firewall policy.""" - UNDEFINED_TYPE = 0 - HIERARCHY = 69902869 - NETWORK = 413984270 - UNSPECIFIED = 526786327 + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + service_attachment = proto.Field(proto.STRING, number=338957549,) - display_name = proto.Field(proto.STRING, number=4473832, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - rules = proto.RepeatedField( - proto.MESSAGE, number=108873975, message="FirewallPolicyRule", - ) - short_name = proto.Field(proto.STRING, number=492051566, optional=True,) - type_ = proto.Field(proto.ENUM, number=3575610, optional=True, enum=Type,) +class GetShieldedInstanceIdentityInstanceRequest(proto.Message): + r"""A request message for Instances.GetShieldedInstanceIdentity. + See the method description for details. -class NetworksGetEffectiveFirewallsResponse(proto.Message): - r""" Attributes: - firewall_policys (Sequence[google.cloud.compute_v1.types.NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy]): - Effective firewalls from firewall policy. - firewalls (Sequence[google.cloud.compute_v1.types.Firewall]): - Effective firewalls on the network. + instance (str): + Name or id of the instance scoping this + request. + project (str): + Project ID for this request. + zone (str): + The name of the zone for this request. """ - firewall_policys = proto.RepeatedField( - proto.MESSAGE, - number=410985794, - message="NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy", - ) - firewalls = proto.RepeatedField( - proto.MESSAGE, number=272245619, message="Firewall", - ) + instance = proto.Field(proto.STRING, number=18257045,) + project = proto.Field(proto.STRING, number=227560217,) + zone = proto.Field(proto.STRING, number=3744684,) -class NetworksRemovePeeringRequest(proto.Message): - r""" +class GetSnapshotRequest(proto.Message): + r"""A request message for Snapshots.Get. See the method + description for details. + Attributes: - name (str): - Name of the peering, which should conform to - RFC1035. + project (str): + Project ID for this request. + snapshot (str): + Name of the Snapshot resource to return. """ - name = proto.Field(proto.STRING, number=3373707, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + snapshot = proto.Field(proto.STRING, number=284874180,) -class NetworksUpdatePeeringRequest(proto.Message): - r""" - Attributes: - network_peering (google.cloud.compute_v1.types.NetworkPeering): +class GetSslCertificateRequest(proto.Message): + r"""A request message for SslCertificates.Get. See the method + description for details. + Attributes: + project (str): + Project ID for this request. + ssl_certificate (str): + Name of the SslCertificate resource to + return. """ - network_peering = proto.Field( - proto.MESSAGE, number=328926767, optional=True, message="NetworkPeering", - ) + project = proto.Field(proto.STRING, number=227560217,) + ssl_certificate = proto.Field(proto.STRING, number=46443492,) -class NodeGroupAutoscalingPolicy(proto.Message): - r""" +class GetSslPolicyRequest(proto.Message): + r"""A request message for SslPolicies.Get. See the method + description for details. + Attributes: - max_nodes (int): - The maximum number of nodes that the group - should have. Must be set if autoscaling is - enabled. Maximum value allowed is 100. - min_nodes (int): - The minimum number of nodes that the group - should have. - mode (google.cloud.compute_v1.types.NodeGroupAutoscalingPolicy.Mode): - The autoscaling mode. Set to one of: ON, OFF, or - ONLY_SCALE_OUT. For more information, see Autoscaler modes. + project (str): + Project ID for this request. + ssl_policy (str): + Name of the SSL policy to update. The name + must be 1-63 characters long, and comply with + RFC1035. """ - class Mode(proto.Enum): - r"""The autoscaling mode. Set to one of: ON, OFF, or ONLY_SCALE_OUT. For - more information, see Autoscaler modes. - """ - UNDEFINED_MODE = 0 - MODE_UNSPECIFIED = 371348091 - OFF = 78159 - ON = 2527 - ONLY_SCALE_OUT = 152713670 - - max_nodes = proto.Field(proto.INT32, number=297762838, optional=True,) - min_nodes = proto.Field(proto.INT32, number=533370500, optional=True,) - mode = proto.Field(proto.ENUM, number=3357091, optional=True, enum=Mode,) + project = proto.Field(proto.STRING, number=227560217,) + ssl_policy = proto.Field(proto.STRING, number=295190213,) -class NodeGroupMaintenanceWindow(proto.Message): - r"""Time window specified for daily maintenance operations. GCE's - internal maintenance will be performed within this window. +class GetStatusVpnGatewayRequest(proto.Message): + r"""A request message for VpnGateways.GetStatus. See the method + description for details. Attributes: - maintenance_duration (google.cloud.compute_v1.types.Duration): - [Output only] A predetermined duration for the window, - automatically chosen to be the smallest possible in the - given scenario. - start_time (str): - Start time of the window. This must be in UTC - format that resolves to one of 00:00, 04:00, - 08:00, 12:00, 16:00, or 20:00. For example, both - 13:00-5 and 08:00 are valid. + project (str): + Project ID for this request. + region (str): + Name of the region for this request. + vpn_gateway (str): + Name of the VPN gateway to return. """ - maintenance_duration = proto.Field( - proto.MESSAGE, number=525291840, optional=True, message="Duration", - ) - start_time = proto.Field(proto.STRING, number=37467274, optional=True,) - + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + vpn_gateway = proto.Field(proto.STRING, number=406684153,) -class NodeGroup(proto.Message): - r"""Represent a sole-tenant Node Group resource. - A sole-tenant node is a physical server that is dedicated to hosting - VM instances only for your specific project. Use sole-tenant nodes - to keep your instances physically separated from instances in other - projects, or to group your instances together on the same host - hardware. For more information, read Sole-tenant nodes. (== - resource_for {$api_version}.nodeGroups ==) +class GetSubnetworkRequest(proto.Message): + r"""A request message for Subnetworks.Get. See the method + description for details. Attributes: - autoscaling_policy (google.cloud.compute_v1.types.NodeGroupAutoscalingPolicy): - Specifies how autoscaling should behave. - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - description (str): - An optional description of this resource. - Provide this property when you create the - resource. - fingerprint (str): + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + subnetwork (str): + Name of the Subnetwork resource to return. + """ - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - kind (str): - [Output Only] The type of the resource. Always - compute#nodeGroup for node group. - location_hint (str): - An opaque location hint used to place the Node close to - other resources. This field is for use by internal tools - that use the public API. The location hint here on the - NodeGroup overrides any location_hint present in the - NodeTemplate. - maintenance_policy (google.cloud.compute_v1.types.NodeGroup.MaintenancePolicy): - Specifies how to handle instances when a node in the group - undergoes maintenance. Set to one of: DEFAULT, - RESTART_IN_PLACE, or MIGRATE_WITHIN_NODE_GROUP. The default - value is DEFAULT. For more information, see Maintenance - policies. - maintenance_window (google.cloud.compute_v1.types.NodeGroupMaintenanceWindow): + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + subnetwork = proto.Field(proto.STRING, number=307827694,) - name (str): - The name of the resource, provided by the client when - initially creating the resource. The resource name must be - 1-63 characters long, and comply with RFC1035. Specifically, - the name must be 1-63 characters long and match the regular - expression ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the - first character must be a lowercase letter, and all - following characters must be a dash, lowercase letter, or - digit, except the last character, which cannot be a dash. - node_template (str): - URL of the node template to create the node - group from. - self_link (str): - [Output Only] Server-defined URL for the resource. - size (int): - [Output Only] The total number of nodes in the node group. - status (google.cloud.compute_v1.types.NodeGroup.Status): - zone (str): - [Output Only] The name of the zone where the node group - resides, such as us-central1-a. - """ +class GetTargetGrpcProxyRequest(proto.Message): + r"""A request message for TargetGrpcProxies.Get. See the method + description for details. - class MaintenancePolicy(proto.Enum): - r"""Specifies how to handle instances when a node in the group undergoes - maintenance. Set to one of: DEFAULT, RESTART_IN_PLACE, or - MIGRATE_WITHIN_NODE_GROUP. The default value is DEFAULT. For more - information, see Maintenance policies. - """ - UNDEFINED_MAINTENANCE_POLICY = 0 - DEFAULT = 115302945 - MAINTENANCE_POLICY_UNSPECIFIED = 72964182 - MIGRATE_WITHIN_NODE_GROUP = 153483394 - RESTART_IN_PLACE = 228647325 + Attributes: + project (str): + Project ID for this request. + target_grpc_proxy (str): + Name of the TargetGrpcProxy resource to + return. + """ - class Status(proto.Enum): - r"""""" - UNDEFINED_STATUS = 0 - CREATING = 455564985 - DELETING = 528602024 - INVALID = 530283991 - READY = 77848963 + project = proto.Field(proto.STRING, number=227560217,) + target_grpc_proxy = proto.Field(proto.STRING, number=5020283,) - autoscaling_policy = proto.Field( - proto.MESSAGE, - number=221950041, - optional=True, - message="NodeGroupAutoscalingPolicy", - ) - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - location_hint = proto.Field(proto.STRING, number=350519505, optional=True,) - maintenance_policy = proto.Field( - proto.ENUM, number=528327646, optional=True, enum=MaintenancePolicy, - ) - maintenance_window = proto.Field( - proto.MESSAGE, - number=186374812, - optional=True, - message="NodeGroupMaintenanceWindow", - ) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - node_template = proto.Field(proto.STRING, number=323154455, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - size = proto.Field(proto.INT32, number=3530753, optional=True,) - status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) - zone = proto.Field(proto.STRING, number=3744684, optional=True,) +class GetTargetHttpProxyRequest(proto.Message): + r"""A request message for TargetHttpProxies.Get. See the method + description for details. -class NodeGroupsScopedList(proto.Message): - r""" Attributes: - node_groups (Sequence[google.cloud.compute_v1.types.NodeGroup]): - [Output Only] A list of node groups contained in this scope. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] An informational warning that appears when the - nodeGroup list is empty. + project (str): + Project ID for this request. + target_http_proxy (str): + Name of the TargetHttpProxy resource to + return. """ - node_groups = proto.RepeatedField( - proto.MESSAGE, number=73188017, message="NodeGroup", - ) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) + project = proto.Field(proto.STRING, number=227560217,) + target_http_proxy = proto.Field(proto.STRING, number=206872421,) -class NodeGroupAggregatedList(proto.Message): - r""" +class GetTargetHttpsProxyRequest(proto.Message): + r"""A request message for TargetHttpsProxies.Get. See the method + description for details. + Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.NodeGroupAggregatedList.ItemsEntry]): - A list of NodeGroupsScopedList resources. - kind (str): - [Output Only] Type of resource.Always - compute#nodeGroupAggregatedList for aggregated lists of node - groups. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - unreachables (Sequence[str]): - [Output Only] Unreachable resources. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + project (str): + Project ID for this request. + target_https_proxy (str): + Name of the TargetHttpsProxy resource to + return. """ - @property - def raw_page(self): - return self + project = proto.Field(proto.STRING, number=227560217,) + target_https_proxy = proto.Field(proto.STRING, number=52336748,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.MapField( - proto.STRING, proto.MESSAGE, number=100526016, message="NodeGroupsScopedList", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - unreachables = proto.RepeatedField(proto.STRING, number=243372063,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) +class GetTargetInstanceRequest(proto.Message): + r"""A request message for TargetInstances.Get. See the method + description for details. -class NodeGroupList(proto.Message): - r"""Contains a list of nodeGroups. Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.NodeGroup]): - A list of NodeGroup resources. - kind (str): - [Output Only] Type of resource.Always compute#nodeGroupList - for lists of node groups. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + project (str): + Project ID for this request. + target_instance (str): + Name of the TargetInstance resource to + return. + zone (str): + Name of the zone scoping this request. """ - @property - def raw_page(self): - return self + project = proto.Field(proto.STRING, number=227560217,) + target_instance = proto.Field(proto.STRING, number=289769347,) + zone = proto.Field(proto.STRING, number=3744684,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="NodeGroup",) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) +class GetTargetPoolRequest(proto.Message): + r"""A request message for TargetPools.Get. See the method + description for details. -class ServerBinding(proto.Message): - r""" Attributes: - type_ (google.cloud.compute_v1.types.ServerBinding.Type): - + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + target_pool (str): + Name of the TargetPool resource to return. """ - class Type(proto.Enum): - r"""""" - UNDEFINED_TYPE = 0 - RESTART_NODE_ON_ANY_SERVER = 502950985 - RESTART_NODE_ON_MINIMAL_SERVERS = 204166495 - SERVER_BINDING_TYPE_UNSPECIFIED = 180825512 + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + target_pool = proto.Field(proto.STRING, number=62796298,) - type_ = proto.Field(proto.ENUM, number=3575610, optional=True, enum=Type,) +class GetTargetSslProxyRequest(proto.Message): + r"""A request message for TargetSslProxies.Get. See the method + description for details. -class NodeGroupNode(proto.Message): - r""" Attributes: - accelerators (Sequence[google.cloud.compute_v1.types.AcceleratorConfig]): - Accelerators for this node. - cpu_overcommit_type (google.cloud.compute_v1.types.NodeGroupNode.CpuOvercommitType): - CPU overcommit. - disks (Sequence[google.cloud.compute_v1.types.LocalDisk]): - Local disk configurations. - instances (Sequence[str]): - Instances scheduled on this node. - name (str): - The name of the node. - node_type (str): - The type of this node. - satisfies_pzs (bool): - [Output Only] Reserved for future use. - server_binding (google.cloud.compute_v1.types.ServerBinding): - Binding properties for the physical server. - server_id (str): - Server ID associated with this node. - status (google.cloud.compute_v1.types.NodeGroupNode.Status): - + project (str): + Project ID for this request. + target_ssl_proxy (str): + Name of the TargetSslProxy resource to + return. """ - class CpuOvercommitType(proto.Enum): - r"""CPU overcommit.""" - UNDEFINED_CPU_OVERCOMMIT_TYPE = 0 - CPU_OVERCOMMIT_TYPE_UNSPECIFIED = 520665615 - ENABLED = 182130465 - NONE = 2402104 - - class Status(proto.Enum): - r"""""" - UNDEFINED_STATUS = 0 - CREATING = 455564985 - DELETING = 528602024 - INVALID = 530283991 - READY = 77848963 - REPAIRING = 413483285 + project = proto.Field(proto.STRING, number=227560217,) + target_ssl_proxy = proto.Field(proto.STRING, number=338795853,) - accelerators = proto.RepeatedField( - proto.MESSAGE, number=269577064, message="AcceleratorConfig", - ) - cpu_overcommit_type = proto.Field( - proto.ENUM, number=247727959, optional=True, enum=CpuOvercommitType, - ) - disks = proto.RepeatedField(proto.MESSAGE, number=95594102, message="LocalDisk",) - instances = proto.RepeatedField(proto.STRING, number=29097598,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - node_type = proto.Field(proto.STRING, number=465832791, optional=True,) - satisfies_pzs = proto.Field(proto.BOOL, number=480964267, optional=True,) - server_binding = proto.Field( - proto.MESSAGE, number=208179593, optional=True, message="ServerBinding", - ) - server_id = proto.Field(proto.STRING, number=339433367, optional=True,) - status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) +class GetTargetTcpProxyRequest(proto.Message): + r"""A request message for TargetTcpProxies.Get. See the method + description for details. -class NodeGroupsAddNodesRequest(proto.Message): - r""" Attributes: - additional_node_count (int): - Count of additional nodes to be added to the - node group. + project (str): + Project ID for this request. + target_tcp_proxy (str): + Name of the TargetTcpProxy resource to + return. """ - additional_node_count = proto.Field(proto.INT32, number=134997930, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + target_tcp_proxy = proto.Field(proto.STRING, number=503065442,) -class NodeGroupsDeleteNodesRequest(proto.Message): - r""" +class GetTargetVpnGatewayRequest(proto.Message): + r"""A request message for TargetVpnGateways.Get. See the method + description for details. + Attributes: - nodes (Sequence[str]): - Names of the nodes to delete. + project (str): + Project ID for this request. + region (str): + Name of the region for this request. + target_vpn_gateway (str): + Name of the target VPN gateway to return. """ - nodes = proto.RepeatedField(proto.STRING, number=104993457,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + target_vpn_gateway = proto.Field(proto.STRING, number=532512843,) -class NodeGroupsListNodes(proto.Message): - r""" +class GetUrlMapRequest(proto.Message): + r"""A request message for UrlMaps.Get. See the method description + for details. + Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.NodeGroupNode]): - A list of Node resources. - kind (str): - [Output Only] The resource type, which is always - compute.nodeGroupsListNodes for the list of nodes in the - specified node group. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + project (str): + Project ID for this request. + url_map (str): + Name of the UrlMap resource to return. """ - @property - def raw_page(self): - return self + project = proto.Field(proto.STRING, number=227560217,) + url_map = proto.Field(proto.STRING, number=367020684,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="NodeGroupNode", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) +class GetVpnGatewayRequest(proto.Message): + r"""A request message for VpnGateways.Get. See the method + description for details. -class NodeGroupsSetNodeTemplateRequest(proto.Message): - r""" Attributes: - node_template (str): - Full or partial URL of the node template - resource to be updated for this node group. + project (str): + Project ID for this request. + region (str): + Name of the region for this request. + vpn_gateway (str): + Name of the VPN gateway to return. """ - node_template = proto.Field(proto.STRING, number=323154455, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + vpn_gateway = proto.Field(proto.STRING, number=406684153,) -class NodeTemplateNodeTypeFlexibility(proto.Message): - r""" +class GetVpnTunnelRequest(proto.Message): + r"""A request message for VpnTunnels.Get. See the method + description for details. + Attributes: - cpus (str): + project (str): + Project ID for this request. + region (str): + Name of the region for this request. + vpn_tunnel (str): + Name of the VpnTunnel resource to return. + """ - local_ssd (str): + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + vpn_tunnel = proto.Field(proto.STRING, number=143821331,) - memory (str): - """ +class GetXpnHostProjectRequest(proto.Message): + r"""A request message for Projects.GetXpnHost. See the method + description for details. - cpus = proto.Field(proto.STRING, number=3060683, optional=True,) - local_ssd = proto.Field(proto.STRING, number=405741360, optional=True,) - memory = proto.Field(proto.STRING, number=532856065, optional=True,) + Attributes: + project (str): + Project ID for this request. + """ + project = proto.Field(proto.STRING, number=227560217,) -class NodeTemplate(proto.Message): - r"""Represent a sole-tenant Node Template resource. - You can use a template to define properties for nodes in a node - group. For more information, read Creating node groups and - instances. (== resource_for {$api_version}.nodeTemplates ==) +class GetXpnResourcesProjectsRequest(proto.Message): + r"""A request message for Projects.GetXpnResources. See the + method description for details. Attributes: - accelerators (Sequence[google.cloud.compute_v1.types.AcceleratorConfig]): - - cpu_overcommit_type (google.cloud.compute_v1.types.NodeTemplate.CpuOvercommitType): - CPU overcommit. - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - description (str): - An optional description of this resource. - Provide this property when you create the - resource. - disks (Sequence[google.cloud.compute_v1.types.LocalDisk]): + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. + """ - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - kind (str): - [Output Only] The type of the resource. Always - compute#nodeTemplate for node templates. - name (str): - The name of the resource, provided by the client when - initially creating the resource. The resource name must be - 1-63 characters long, and comply with RFC1035. Specifically, - the name must be 1-63 characters long and match the regular - expression ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the - first character must be a lowercase letter, and all - following characters must be a dash, lowercase letter, or - digit, except the last character, which cannot be a dash. - node_affinity_labels (Sequence[google.cloud.compute_v1.types.NodeTemplate.NodeAffinityLabelsEntry]): - Labels to use for node affinity, which will - be used in instance scheduling. - node_type (str): - The node type to use for nodes group that are - created from this template. - node_type_flexibility (google.cloud.compute_v1.types.NodeTemplateNodeTypeFlexibility): - The flexible properties of the desired node type. Node - groups that use this node template will create nodes of a - type that matches these properties. + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - This field is mutually exclusive with the node_type - property; you can only define one or the other, but not - both. - region (str): - [Output Only] The name of the region where the node template - resides, such as us-central1. - self_link (str): - [Output Only] Server-defined URL for the resource. - server_binding (google.cloud.compute_v1.types.ServerBinding): - Sets the binding properties for the physical server. Valid - values include: - - [Default] RESTART_NODE_ON_ANY_SERVER: Restarts VMs on any - available physical server - - RESTART_NODE_ON_MINIMAL_SERVER: Restarts VMs on the same - physical server whenever possible +class GetZoneOperationRequest(proto.Message): + r"""A request message for ZoneOperations.Get. See the method + description for details. - See Sole-tenant node options for more information. - status (google.cloud.compute_v1.types.NodeTemplate.Status): - [Output Only] The status of the node template. One of the - following values: CREATING, READY, and DELETING. - status_message (str): - [Output Only] An optional, human-readable explanation of the - status. + Attributes: + operation (str): + Name of the Operations resource to return. + project (str): + Project ID for this request. + zone (str): + Name of the zone for this request. """ - class CpuOvercommitType(proto.Enum): - r"""CPU overcommit.""" - UNDEFINED_CPU_OVERCOMMIT_TYPE = 0 - CPU_OVERCOMMIT_TYPE_UNSPECIFIED = 520665615 - ENABLED = 182130465 - NONE = 2402104 - - class Status(proto.Enum): - r"""[Output Only] The status of the node template. One of the following - values: CREATING, READY, and DELETING. - """ - UNDEFINED_STATUS = 0 - CREATING = 455564985 - DELETING = 528602024 - INVALID = 530283991 - READY = 77848963 + operation = proto.Field(proto.STRING, number=52090215,) + project = proto.Field(proto.STRING, number=227560217,) + zone = proto.Field(proto.STRING, number=3744684,) - accelerators = proto.RepeatedField( - proto.MESSAGE, number=269577064, message="AcceleratorConfig", - ) - cpu_overcommit_type = proto.Field( - proto.ENUM, number=247727959, optional=True, enum=CpuOvercommitType, - ) - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - disks = proto.RepeatedField(proto.MESSAGE, number=95594102, message="LocalDisk",) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - node_affinity_labels = proto.MapField(proto.STRING, proto.STRING, number=339007161,) - node_type = proto.Field(proto.STRING, number=465832791, optional=True,) - node_type_flexibility = proto.Field( - proto.MESSAGE, - number=315257905, - optional=True, - message="NodeTemplateNodeTypeFlexibility", - ) - region = proto.Field(proto.STRING, number=138946292, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - server_binding = proto.Field( - proto.MESSAGE, number=208179593, optional=True, message="ServerBinding", - ) - status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) - status_message = proto.Field(proto.STRING, number=297428154, optional=True,) +class GetZoneRequest(proto.Message): + r"""A request message for Zones.Get. See the method description + for details. -class NodeTemplatesScopedList(proto.Message): - r""" Attributes: - node_templates (Sequence[google.cloud.compute_v1.types.NodeTemplate]): - [Output Only] A list of node templates contained in this - scope. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] An informational warning that appears when the - node templates list is empty. + project (str): + Project ID for this request. + zone (str): + Name of the zone resource to return. """ - node_templates = proto.RepeatedField( - proto.MESSAGE, number=354111804, message="NodeTemplate", - ) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) + project = proto.Field(proto.STRING, number=227560217,) + zone = proto.Field(proto.STRING, number=3744684,) -class NodeTemplateAggregatedList(proto.Message): +class GlobalNetworkEndpointGroupsAttachEndpointsRequest(proto.Message): r""" Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.NodeTemplateAggregatedList.ItemsEntry]): - A list of NodeTemplatesScopedList resources. - kind (str): - [Output Only] Type of resource.Always - compute#nodeTemplateAggregatedList for aggregated lists of - node templates. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - unreachables (Sequence[str]): - [Output Only] Unreachable resources. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + network_endpoints (Sequence[google.cloud.compute_v1.types.NetworkEndpoint]): + The list of network endpoints to be attached. """ - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.MapField( - proto.STRING, - proto.MESSAGE, - number=100526016, - message="NodeTemplatesScopedList", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - unreachables = proto.RepeatedField(proto.STRING, number=243372063,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + network_endpoints = proto.RepeatedField( + proto.MESSAGE, number=149850285, message="NetworkEndpoint", ) -class NodeTemplateList(proto.Message): - r"""Contains a list of node templates. +class GlobalNetworkEndpointGroupsDetachEndpointsRequest(proto.Message): + r""" Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.NodeTemplate]): - A list of NodeTemplate resources. - kind (str): - [Output Only] Type of resource.Always - compute#nodeTemplateList for lists of node templates. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + network_endpoints (Sequence[google.cloud.compute_v1.types.NetworkEndpoint]): + The list of network endpoints to be detached. """ - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="NodeTemplate", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + network_endpoints = proto.RepeatedField( + proto.MESSAGE, number=149850285, message="NetworkEndpoint", ) -class NodeType(proto.Message): - r"""Represent a sole-tenant Node Type resource. - - Each node within a node group must have a node type. A node type - specifies the total amount of cores and memory for that node. - Currently, the only available node type is n1-node-96-624 node type - that has 96 vCPUs and 624 GB of memory, available in multiple zones. - For more information read Node types. (== resource_for - {$api_version}.nodeTypes ==) - +class GlobalOrganizationSetPolicyRequest(proto.Message): + r""" Attributes: - cpu_platform (str): - [Output Only] The CPU platform used by this node type. - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - deprecated (google.cloud.compute_v1.types.DeprecationStatus): - [Output Only] The deprecation status associated with this - node type. - description (str): - [Output Only] An optional textual description of the - resource. - guest_cpus (int): - [Output Only] The number of virtual CPUs that are available - to the node type. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - kind (str): - [Output Only] The type of the resource. Always - compute#nodeType for node types. - local_ssd_gb (int): - [Output Only] Local SSD available to the node type, defined - in GB. - memory_mb (int): - [Output Only] The amount of physical memory available to the - node type, defined in MB. - name (str): - [Output Only] Name of the resource. - self_link (str): - [Output Only] Server-defined URL for the resource. - zone (str): - [Output Only] The name of the zone where the node type - resides, such as us-central1-a. + bindings (Sequence[google.cloud.compute_v1.types.Binding]): + Flatten Policy to create a backward + compatible wire-format. Deprecated. Use 'policy' + to specify bindings. + etag (str): + Flatten Policy to create a backward + compatible wire-format. Deprecated. Use 'policy' + to specify the etag. + policy (google.cloud.compute_v1.types.Policy): + REQUIRED: The complete policy to be applied + to the 'resource'. The size of the policy is + limited to a few 10s of KB. An empty policy is + in general a valid policy but certain services + (like Projects) might reject them. """ - cpu_platform = proto.Field(proto.STRING, number=410285354, optional=True,) - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - deprecated = proto.Field( - proto.MESSAGE, number=515138995, optional=True, message="DeprecationStatus", + bindings = proto.RepeatedField(proto.MESSAGE, number=403251854, message="Binding",) + etag = proto.Field(proto.STRING, number=3123477, optional=True,) + policy = proto.Field( + proto.MESSAGE, number=91071794, optional=True, message="Policy", ) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - guest_cpus = proto.Field(proto.INT32, number=393356754, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - local_ssd_gb = proto.Field(proto.INT32, number=329237578, optional=True,) - memory_mb = proto.Field(proto.INT32, number=116001171, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - zone = proto.Field(proto.STRING, number=3744684, optional=True,) -class NodeTypesScopedList(proto.Message): +class GlobalSetLabelsRequest(proto.Message): + r""" + Attributes: + label_fingerprint (str): + The fingerprint of the previous set of labels + for this resource, used to detect conflicts. The + fingerprint is initially generated by Compute + Engine and changes after every request to modify + or update labels. You must always provide an up- + to-date fingerprint hash when updating or + changing labels, otherwise the request will fail + with error 412 conditionNotMet. Make a get() + request to the resource to get the latest + fingerprint. + labels (Sequence[google.cloud.compute_v1.types.GlobalSetLabelsRequest.LabelsEntry]): + A list of labels to apply for this resource. Each label key + & value must comply with RFC1035. Specifically, the name + must be 1-63 characters long and match the regular + expression ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the + first character must be a lowercase letter, and all + following characters must be a dash, lowercase letter, or + digit, except the last character, which cannot be a dash. + For example, "webserver-frontend": "images". A label value + can also be empty (e.g. "my-label": ""). + """ + + label_fingerprint = proto.Field(proto.STRING, number=178124825, optional=True,) + labels = proto.MapField(proto.STRING, proto.STRING, number=500195327,) + + +class GlobalSetPolicyRequest(proto.Message): r""" Attributes: - node_types (Sequence[google.cloud.compute_v1.types.NodeType]): - [Output Only] A list of node types contained in this scope. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] An informational warning that appears when the - node types list is empty. + bindings (Sequence[google.cloud.compute_v1.types.Binding]): + Flatten Policy to create a backward + compatible wire-format. Deprecated. Use 'policy' + to specify bindings. + etag (str): + Flatten Policy to create a backward + compatible wire-format. Deprecated. Use 'policy' + to specify the etag. + policy (google.cloud.compute_v1.types.Policy): + REQUIRED: The complete policy to be applied + to the 'resource'. The size of the policy is + limited to a few 10s of KB. An empty policy is + in general a valid policy but certain services + (like Projects) might reject them. """ - node_types = proto.RepeatedField( - proto.MESSAGE, number=482172924, message="NodeType", - ) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + bindings = proto.RepeatedField(proto.MESSAGE, number=403251854, message="Binding",) + etag = proto.Field(proto.STRING, number=3123477, optional=True,) + policy = proto.Field( + proto.MESSAGE, number=91071794, optional=True, message="Policy", ) -class NodeTypeAggregatedList(proto.Message): - r""" +class GuestAttributes(proto.Message): + r"""A guest attributes entry. Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.NodeTypeAggregatedList.ItemsEntry]): - A list of NodeTypesScopedList resources. kind (str): - [Output Only] Type of resource.Always - compute#nodeTypeAggregatedList for aggregated lists of node - types. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. + [Output Only] Type of the resource. Always + compute#guestAttributes for guest attributes entry. + query_path (str): + The path to be queried. This can be the + default namespace ('') or a nested namespace + ('\/') or a specified key ('\/\'). + query_value (google.cloud.compute_v1.types.GuestAttributesValue): + [Output Only] The value of the requested queried path. self_link (str): [Output Only] Server-defined URL for this resource. - unreachables (Sequence[str]): - [Output Only] Unreachable resources. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + variable_key (str): + The key to search for. + variable_value (str): + [Output Only] The value found for the requested key. """ - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.MapField( - proto.STRING, proto.MESSAGE, number=100526016, message="NodeTypesScopedList", - ) kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - unreachables = proto.RepeatedField(proto.STRING, number=243372063,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + query_path = proto.Field(proto.STRING, number=368591164, optional=True,) + query_value = proto.Field( + proto.MESSAGE, number=157570874, optional=True, message="GuestAttributesValue", ) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + variable_key = proto.Field(proto.STRING, number=164364828, optional=True,) + variable_value = proto.Field(proto.STRING, number=124582382, optional=True,) -class NodeTypeList(proto.Message): - r"""Contains a list of node types. +class GuestAttributesEntry(proto.Message): + r"""A guest attributes namespace/key/value entry. Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.NodeType]): - A list of NodeType resources. - kind (str): - [Output Only] Type of resource.Always compute#nodeTypeList - for lists of node types. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + key (str): + Key for the guest attribute entry. + namespace (str): + Namespace for the guest attribute entry. + value (str): + Value for the guest attribute entry. """ - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="NodeType",) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) - + key = proto.Field(proto.STRING, number=106079, optional=True,) + namespace = proto.Field(proto.STRING, number=178476379, optional=True,) + value = proto.Field(proto.STRING, number=111972721, optional=True,) -class NotificationEndpointGrpcSettings(proto.Message): - r"""Represents a gRPC setting that describes one gRPC - notification endpoint and the retry duration attempting to send - notification to this endpoint. +class GuestAttributesValue(proto.Message): + r"""Array of guest attribute namespace/key/value tuples. Attributes: - authority (str): - Optional. If specified, this field is used to - set the authority header by the sender of - notifications. See - https://tools.ietf.org/html/rfc7540#section-8.1.2.3 - endpoint (str): - Endpoint to which gRPC notifications are - sent. This must be a valid gRPCLB DNS name. - payload_name (str): - Optional. If specified, this field is used to - populate the "name" field in gRPC requests. - resend_interval (google.cloud.compute_v1.types.Duration): - Optional. This field is used to configure how - often to send a full update of all non-healthy - backends. If unspecified, full updates are not - sent. If specified, must be in the range between - 600 seconds to 3600 seconds. Nanos are - disallowed. - retry_duration_sec (int): - How much time (in seconds) is spent - attempting notification retries until a - successful response is received. Default is 30s. - Limit is 20m (1200s). Must be a positive number. + items (Sequence[google.cloud.compute_v1.types.GuestAttributesEntry]): + """ - authority = proto.Field(proto.STRING, number=401868611, optional=True,) - endpoint = proto.Field(proto.STRING, number=130489749, optional=True,) - payload_name = proto.Field(proto.STRING, number=300358300, optional=True,) - resend_interval = proto.Field( - proto.MESSAGE, number=478288969, optional=True, message="Duration", + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="GuestAttributesEntry", ) - retry_duration_sec = proto.Field(proto.UINT32, number=115681117, optional=True,) - -class NotificationEndpoint(proto.Message): - r"""Represents a notification endpoint. - - A notification endpoint resource defines an endpoint to receive - notifications when there are status changes detected by the - associated health check service. - - For more information, see Health checks overview. (== resource_for - {$api_version}.notificationEndpoint ==) (== resource_for - {$api_version}.regionNotificationEndpoints ==) +class GuestOsFeature(proto.Message): + r"""Guest OS features. Attributes: - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - description (str): - An optional description of this resource. - Provide this property when you create the - resource. - grpc_settings (google.cloud.compute_v1.types.NotificationEndpointGrpcSettings): - Settings of the gRPC notification endpoint - including the endpoint URL and the retry - duration. - id (int): - [Output Only] A unique identifier for this resource type. - The server generates this identifier. - kind (str): - [Output Only] Type of the resource. Always - compute#notificationEndpoint for notification endpoints. - name (str): - Name of the resource. Provided by the client when the - resource is created. The name must be 1-63 characters long, - and comply with RFC1035. Specifically, the name must be 1-63 - characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. - region (str): - [Output Only] URL of the region where the notification - endpoint resides. This field applies only to the regional - resource. You must specify this field as part of the HTTP - request URL. It is not settable as a field in the request - body. - self_link (str): - [Output Only] Server-defined URL for the resource. + type_ (google.cloud.compute_v1.types.GuestOsFeature.Type): + The ID of a supported feature. Read Enabling + guest operating system features to see a list of + available options. """ - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - grpc_settings = proto.Field( - proto.MESSAGE, - number=456139556, - optional=True, - message="NotificationEndpointGrpcSettings", - ) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - region = proto.Field(proto.STRING, number=138946292, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + class Type(proto.Enum): + r"""The ID of a supported feature. Read Enabling guest operating + system features to see a list of available options. + """ + UNDEFINED_TYPE = 0 + FEATURE_TYPE_UNSPECIFIED = 531767259 + GVNIC = 68209305 + MULTI_IP_SUBNET = 151776719 + SECURE_BOOT = 376811194 + SEV_CAPABLE = 87083793 + UEFI_COMPATIBLE = 195865408 + VIRTIO_SCSI_MULTIQUEUE = 201597069 + WINDOWS = 456863331 + type_ = proto.Field(proto.ENUM, number=3575610, optional=True, enum=Type,) -class NotificationEndpointList(proto.Message): + +class HTTP2HealthCheck(proto.Message): r""" Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.NotificationEndpoint]): - A list of NotificationEndpoint resources. - kind (str): - [Output Only] Type of the resource. Always - compute#notificationEndpoint for notification endpoints. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + host (str): + The value of the host header in the HTTP/2 + health check request. If left empty (default + value), the IP on behalf of which this health + check is performed will be used. + port (int): + The TCP port number for the health check + request. The default value is 443. Valid values + are 1 through 65535. + port_name (str): + Port name as defined in InstanceGroup#NamedPort#name. If + both port and port_name are defined, port takes precedence. + port_specification (google.cloud.compute_v1.types.HTTP2HealthCheck.PortSpecification): + Specifies how port is selected for health checking, can be + one of following values: USE_FIXED_PORT: The port number in + port is used for health checking. USE_NAMED_PORT: The + portName is used for health checking. USE_SERVING_PORT: For + NetworkEndpointGroup, the port specified for each network + endpoint is used for health checking. For other backends, + the port or named port specified in the Backend Service is + used for health checking. If not specified, HTTP2 health + check follows behavior specified in port and portName + fields. + proxy_header (google.cloud.compute_v1.types.HTTP2HealthCheck.ProxyHeader): + Specifies the type of proxy header to append before sending + data to the backend, either NONE or PROXY_V1. The default is + NONE. + request_path (str): + The request path of the HTTP/2 health check + request. The default value is /. + response (str): + The string to match anywhere in the first + 1024 bytes of the response body. If left empty + (the default value), the status code determines + health. The response data can only be ASCII. """ - @property - def raw_page(self): - return self + class PortSpecification(proto.Enum): + r"""Specifies how port is selected for health checking, can be one of + following values: USE_FIXED_PORT: The port number in port is used + for health checking. USE_NAMED_PORT: The portName is used for health + checking. USE_SERVING_PORT: For NetworkEndpointGroup, the port + specified for each network endpoint is used for health checking. For + other backends, the port or named port specified in the Backend + Service is used for health checking. If not specified, HTTP2 health + check follows behavior specified in port and portName fields. + """ + UNDEFINED_PORT_SPECIFICATION = 0 + USE_FIXED_PORT = 190235748 + USE_NAMED_PORT = 349300671 + USE_SERVING_PORT = 362637516 - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="NotificationEndpoint", + class ProxyHeader(proto.Enum): + r"""Specifies the type of proxy header to append before sending data to + the backend, either NONE or PROXY_V1. The default is NONE. + """ + UNDEFINED_PROXY_HEADER = 0 + NONE = 2402104 + PROXY_V1 = 334352940 + + host = proto.Field(proto.STRING, number=3208616, optional=True,) + port = proto.Field(proto.INT32, number=3446913, optional=True,) + port_name = proto.Field(proto.STRING, number=41534345, optional=True,) + port_specification = proto.Field( + proto.ENUM, number=51590597, optional=True, enum=PortSpecification, ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + proxy_header = proto.Field( + proto.ENUM, number=160374142, optional=True, enum=ProxyHeader, ) + request_path = proto.Field(proto.STRING, number=229403605, optional=True,) + response = proto.Field(proto.STRING, number=196547649, optional=True,) -class Error(proto.Message): - r"""[Output Only] If errors are generated during processing of the - operation, this field will be populated. - - Attributes: - errors (Sequence[google.cloud.compute_v1.types.Errors]): - [Output Only] The array of errors encountered while - processing this operation. - """ - - errors = proto.RepeatedField(proto.MESSAGE, number=315977579, message="Errors",) - - -class Warnings(proto.Message): +class HTTPHealthCheck(proto.Message): r""" Attributes: - code (google.cloud.compute_v1.types.Warnings.Code): - [Output Only] A warning code, if applicable. For example, - Compute Engine returns NO_RESULTS_ON_PAGE if there are no - results in the response. - data (Sequence[google.cloud.compute_v1.types.Data]): - [Output Only] Metadata about this warning in key: value - format. For example: "data": [ { "key": "scope", "value": - "zones/us-east1-d" } - message (str): - [Output Only] A human-readable description of the warning - code. + host (str): + The value of the host header in the HTTP + health check request. If left empty (default + value), the IP on behalf of which this health + check is performed will be used. + port (int): + The TCP port number for the health check + request. The default value is 80. Valid values + are 1 through 65535. + port_name (str): + Port name as defined in InstanceGroup#NamedPort#name. If + both port and port_name are defined, port takes precedence. + port_specification (google.cloud.compute_v1.types.HTTPHealthCheck.PortSpecification): + Specifies how port is selected for health checking, can be + one of following values: USE_FIXED_PORT: The port number in + port is used for health checking. USE_NAMED_PORT: The + portName is used for health checking. USE_SERVING_PORT: For + NetworkEndpointGroup, the port specified for each network + endpoint is used for health checking. For other backends, + the port or named port specified in the Backend Service is + used for health checking. If not specified, HTTP health + check follows behavior specified in port and portName + fields. + proxy_header (google.cloud.compute_v1.types.HTTPHealthCheck.ProxyHeader): + Specifies the type of proxy header to append before sending + data to the backend, either NONE or PROXY_V1. The default is + NONE. + request_path (str): + The request path of the HTTP health check + request. The default value is /. + response (str): + The string to match anywhere in the first + 1024 bytes of the response body. If left empty + (the default value), the status code determines + health. The response data can only be ASCII. """ - class Code(proto.Enum): - r"""[Output Only] A warning code, if applicable. For example, Compute - Engine returns NO_RESULTS_ON_PAGE if there are no results in the - response. + class PortSpecification(proto.Enum): + r"""Specifies how port is selected for health checking, can be one of + following values: USE_FIXED_PORT: The port number in port is used + for health checking. USE_NAMED_PORT: The portName is used for health + checking. USE_SERVING_PORT: For NetworkEndpointGroup, the port + specified for each network endpoint is used for health checking. For + other backends, the port or named port specified in the Backend + Service is used for health checking. If not specified, HTTP health + check follows behavior specified in port and portName fields. """ - UNDEFINED_CODE = 0 - CLEANUP_FAILED = 150308440 - DEPRECATED_RESOURCE_USED = 391835586 - DEPRECATED_TYPE_USED = 346526230 - DISK_SIZE_LARGER_THAN_IMAGE_SIZE = 369442967 - EXPERIMENTAL_TYPE_USED = 451954443 - EXTERNAL_API_WARNING = 175546307 - FIELD_VALUE_OVERRIDEN = 329669423 - INJECTED_KERNELS_DEPRECATED = 417377419 - LARGE_DEPLOYMENT_WARNING = 481440678 - MISSING_TYPE_DEPENDENCY = 344505463 - NEXT_HOP_ADDRESS_NOT_ASSIGNED = 324964999 - NEXT_HOP_CANNOT_IP_FORWARD = 383382887 - NEXT_HOP_INSTANCE_NOT_FOUND = 464250446 - NEXT_HOP_INSTANCE_NOT_ON_NETWORK = 243758146 - NEXT_HOP_NOT_RUNNING = 417081265 - NOT_CRITICAL_ERROR = 105763924 - NO_RESULTS_ON_PAGE = 30036744 - PARTIAL_SUCCESS = 39966469 - REQUIRED_TOS_AGREEMENT = 3745539 - RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING = 496728641 - RESOURCE_NOT_DELETED = 168598460 - SCHEMA_VALIDATION_IGNORED = 275245642 - SINGLE_INSTANCE_PROPERTY_TEMPLATE = 268305617 - UNDECLARED_PROPERTIES = 390513439 - UNREACHABLE = 13328052 + UNDEFINED_PORT_SPECIFICATION = 0 + USE_FIXED_PORT = 190235748 + USE_NAMED_PORT = 349300671 + USE_SERVING_PORT = 362637516 - code = proto.Field(proto.ENUM, number=3059181, optional=True, enum=Code,) - data = proto.RepeatedField(proto.MESSAGE, number=3076010, message="Data",) - message = proto.Field(proto.STRING, number=418054151, optional=True,) + class ProxyHeader(proto.Enum): + r"""Specifies the type of proxy header to append before sending data to + the backend, either NONE or PROXY_V1. The default is NONE. + """ + UNDEFINED_PROXY_HEADER = 0 + NONE = 2402104 + PROXY_V1 = 334352940 + host = proto.Field(proto.STRING, number=3208616, optional=True,) + port = proto.Field(proto.INT32, number=3446913, optional=True,) + port_name = proto.Field(proto.STRING, number=41534345, optional=True,) + port_specification = proto.Field( + proto.ENUM, number=51590597, optional=True, enum=PortSpecification, + ) + proxy_header = proto.Field( + proto.ENUM, number=160374142, optional=True, enum=ProxyHeader, + ) + request_path = proto.Field(proto.STRING, number=229403605, optional=True,) + response = proto.Field(proto.STRING, number=196547649, optional=True,) -class Operation(proto.Message): - r"""Represents an Operation resource. - Google Compute Engine has three Operation resources: +class HTTPSHealthCheck(proto.Message): + r""" + Attributes: + host (str): + The value of the host header in the HTTPS + health check request. If left empty (default + value), the IP on behalf of which this health + check is performed will be used. + port (int): + The TCP port number for the health check + request. The default value is 443. Valid values + are 1 through 65535. + port_name (str): + Port name as defined in InstanceGroup#NamedPort#name. If + both port and port_name are defined, port takes precedence. + port_specification (google.cloud.compute_v1.types.HTTPSHealthCheck.PortSpecification): + Specifies how port is selected for health checking, can be + one of following values: USE_FIXED_PORT: The port number in + port is used for health checking. USE_NAMED_PORT: The + portName is used for health checking. USE_SERVING_PORT: For + NetworkEndpointGroup, the port specified for each network + endpoint is used for health checking. For other backends, + the port or named port specified in the Backend Service is + used for health checking. If not specified, HTTPS health + check follows behavior specified in port and portName + fields. + proxy_header (google.cloud.compute_v1.types.HTTPSHealthCheck.ProxyHeader): + Specifies the type of proxy header to append before sending + data to the backend, either NONE or PROXY_V1. The default is + NONE. + request_path (str): + The request path of the HTTPS health check + request. The default value is /. + response (str): + The string to match anywhere in the first + 1024 bytes of the response body. If left empty + (the default value), the status code determines + health. The response data can only be ASCII. + """ - - `Global `__ - \* - `Regional `__ - \* - `Zonal `__ + class PortSpecification(proto.Enum): + r"""Specifies how port is selected for health checking, can be one of + following values: USE_FIXED_PORT: The port number in port is used + for health checking. USE_NAMED_PORT: The portName is used for health + checking. USE_SERVING_PORT: For NetworkEndpointGroup, the port + specified for each network endpoint is used for health checking. For + other backends, the port or named port specified in the Backend + Service is used for health checking. If not specified, HTTPS health + check follows behavior specified in port and portName fields. + """ + UNDEFINED_PORT_SPECIFICATION = 0 + USE_FIXED_PORT = 190235748 + USE_NAMED_PORT = 349300671 + USE_SERVING_PORT = 362637516 - You can use an operation resource to manage asynchronous API - requests. For more information, read Handling API responses. + class ProxyHeader(proto.Enum): + r"""Specifies the type of proxy header to append before sending data to + the backend, either NONE or PROXY_V1. The default is NONE. + """ + UNDEFINED_PROXY_HEADER = 0 + NONE = 2402104 + PROXY_V1 = 334352940 - Operations can be global, regional or zonal. + host = proto.Field(proto.STRING, number=3208616, optional=True,) + port = proto.Field(proto.INT32, number=3446913, optional=True,) + port_name = proto.Field(proto.STRING, number=41534345, optional=True,) + port_specification = proto.Field( + proto.ENUM, number=51590597, optional=True, enum=PortSpecification, + ) + proxy_header = proto.Field( + proto.ENUM, number=160374142, optional=True, enum=ProxyHeader, + ) + request_path = proto.Field(proto.STRING, number=229403605, optional=True,) + response = proto.Field(proto.STRING, number=196547649, optional=True,) - - For global operations, use the ``globalOperations`` resource. - - For regional operations, use the ``regionOperations`` resource. - - For zonal operations, use the ``zonalOperations`` resource. - For more information, read Global, Regional, and Zonal Resources. - (== resource_for {$api_version}.globalOperations ==) (== - resource_for {$api_version}.regionOperations ==) (== resource_for - {$api_version}.zoneOperations ==) +class HealthCheck(proto.Message): + r"""Represents a Health Check resource. Google Compute Engine has two + Health Check resources: \* + `Global `__ \* + `Regional `__ + Internal HTTP(S) load balancers must use regional health checks + (``compute.v1.regionHealthChecks``). Traffic Director must use + global health checks (``compute.v1.HealthChecks``). Internal TCP/UDP + load balancers can use either regional or global health checks + (``compute.v1.regionHealthChecks`` or ``compute.v1.HealthChecks``). + External HTTP(S), TCP proxy, and SSL proxy load balancers as well as + managed instance group auto-healing must use global health checks + (``compute.v1.HealthChecks``). Backend service-based network load + balancers must use regional health checks + (``compute.v1.regionHealthChecks``). Target pool-based network load + balancers must use legacy HTTP health checks + (``compute.v1.httpHealthChecks``). For more information, see Health + checks overview. Attributes: - client_operation_id (str): - [Output Only] The value of ``requestId`` if you provided it - in the request. Not present otherwise. + check_interval_sec (int): + How often (in seconds) to send a health + check. The default value is 5 seconds. creation_timestamp (str): - [Deprecated] This field is deprecated. + [Output Only] Creation timestamp in 3339 text format. description (str): - [Output Only] A textual description of the operation, which - is set when the operation is created. - end_time (str): - [Output Only] The time that this operation was completed. - This value is in RFC3339 text format. - error (google.cloud.compute_v1.types.Error): - [Output Only] If errors are generated during processing of - the operation, this field will be populated. - http_error_message (str): - [Output Only] If the operation fails, this field contains - the HTTP error message that was returned, such as - ``NOT FOUND``. - http_error_status_code (int): - [Output Only] If the operation fails, this field contains - the HTTP error status code that was returned. For example, a - ``404`` means the resource was not found. + An optional description of this resource. + Provide this property when you create the + resource. + grpc_health_check (google.cloud.compute_v1.types.GRPCHealthCheck): + + healthy_threshold (int): + A so-far unhealthy instance will be marked + healthy after this many consecutive successes. + The default value is 2. + http2_health_check (google.cloud.compute_v1.types.HTTP2HealthCheck): + + http_health_check (google.cloud.compute_v1.types.HTTPHealthCheck): + + https_health_check (google.cloud.compute_v1.types.HTTPSHealthCheck): + id (int): - [Output Only] The unique identifier for the operation. This + [Output Only] The unique identifier for the resource. This identifier is defined by the server. - insert_time (str): - [Output Only] The time that this operation was requested. - This value is in RFC3339 text format. kind (str): - [Output Only] Type of the resource. Always - ``compute#operation`` for Operation resources. + Type of the resource. + log_config (google.cloud.compute_v1.types.HealthCheckLogConfig): + Configure logging on this health check. name (str): - [Output Only] Name of the operation. - operation_group_id (str): - [Output Only] An ID that represents a group of operations, - such as when a group of operations results from a - ``bulkInsert`` API request. - operation_type (str): - [Output Only] The type of operation, such as ``insert``, - ``update``, or ``delete``, and so on. - progress (int): - [Output Only] An optional progress indicator that ranges - from 0 to 100. There is no requirement that this be linear - or support any granularity of operations. This should not be - used to guess when the operation will be complete. This - number should monotonically increase as the operation - progresses. + Name of the resource. Provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. For example, a name that is 1-63 + characters long, matches the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?``, and otherwise complies with + RFC1035. This regular expression describes a name where the + first character is a lowercase letter, and all following + characters are a dash, lowercase letter, or digit, except + the last character, which isn't a dash. region (str): - [Output Only] The URL of the region where the operation - resides. Only applicable when performing regional - operations. + [Output Only] Region where the health check resides. Not + applicable to global health checks. self_link (str): [Output Only] Server-defined URL for the resource. - start_time (str): - [Output Only] The time that this operation was started by - the server. This value is in RFC3339 text format. - status (google.cloud.compute_v1.types.Operation.Status): - [Output Only] The status of the operation, which can be one - of the following: ``PENDING``, ``RUNNING``, or ``DONE``. - status_message (str): - [Output Only] An optional textual description of the current - status of the operation. - target_id (int): - [Output Only] The unique target ID, which identifies a - specific incarnation of the target resource. - target_link (str): - [Output Only] The URL of the resource that the operation - modifies. For operations related to creating a snapshot, - this points to the persistent disk that the snapshot was - created from. - user (str): - [Output Only] User who requested the operation, for example: - ``user@example.com``. - warnings (Sequence[google.cloud.compute_v1.types.Warnings]): - [Output Only] If warning messages are generated during - processing of the operation, this field will be populated. - zone (str): - [Output Only] The URL of the zone where the operation - resides. Only applicable when performing per-zone - operations. + ssl_health_check (google.cloud.compute_v1.types.SSLHealthCheck): + + tcp_health_check (google.cloud.compute_v1.types.TCPHealthCheck): + + timeout_sec (int): + How long (in seconds) to wait before claiming + failure. The default value is 5 seconds. It is + invalid for timeoutSec to have greater value + than checkIntervalSec. + type_ (google.cloud.compute_v1.types.HealthCheck.Type): + Specifies the type of the healthCheck, either + TCP, SSL, HTTP, HTTPS or HTTP2. If not + specified, the default is TCP. Exactly one of + the protocol-specific health check field must be + specified, which must match type field. + unhealthy_threshold (int): + A so-far healthy instance will be marked + unhealthy after this many consecutive failures. + The default value is 2. """ - class Status(proto.Enum): - r"""[Output Only] The status of the operation, which can be one of the - following: ``PENDING``, ``RUNNING``, or ``DONE``. + class Type(proto.Enum): + r"""Specifies the type of the healthCheck, either TCP, SSL, HTTP, + HTTPS or HTTP2. If not specified, the default is TCP. Exactly + one of the protocol-specific health check field must be + specified, which must match type field. """ - UNDEFINED_STATUS = 0 - DONE = 2104194 - PENDING = 35394935 - RUNNING = 121282975 + UNDEFINED_TYPE = 0 + GRPC = 2196510 + HTTP = 2228360 + HTTP2 = 69079210 + HTTPS = 69079243 + INVALID = 530283991 + SSL = 82412 + TCP = 82881 - client_operation_id = proto.Field(proto.STRING, number=297240295, optional=True,) + check_interval_sec = proto.Field(proto.INT32, number=345561006, optional=True,) creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) description = proto.Field(proto.STRING, number=422937596, optional=True,) - end_time = proto.Field(proto.STRING, number=114938801, optional=True,) - error = proto.Field(proto.MESSAGE, number=96784904, optional=True, message="Error",) - http_error_message = proto.Field(proto.STRING, number=202521945, optional=True,) - http_error_status_code = proto.Field(proto.INT32, number=312345196, optional=True,) + grpc_health_check = proto.Field( + proto.MESSAGE, number=85529574, optional=True, message="GRPCHealthCheck", + ) + healthy_threshold = proto.Field(proto.INT32, number=403212361, optional=True,) + http2_health_check = proto.Field( + proto.MESSAGE, number=11360986, optional=True, message="HTTP2HealthCheck", + ) + http_health_check = proto.Field( + proto.MESSAGE, number=412586940, optional=True, message="HTTPHealthCheck", + ) + https_health_check = proto.Field( + proto.MESSAGE, number=436046905, optional=True, message="HTTPSHealthCheck", + ) id = proto.Field(proto.UINT64, number=3355, optional=True,) - insert_time = proto.Field(proto.STRING, number=433722515, optional=True,) kind = proto.Field(proto.STRING, number=3292052, optional=True,) + log_config = proto.Field( + proto.MESSAGE, number=351299741, optional=True, message="HealthCheckLogConfig", + ) name = proto.Field(proto.STRING, number=3373707, optional=True,) - operation_group_id = proto.Field(proto.STRING, number=40171187, optional=True,) - operation_type = proto.Field(proto.STRING, number=177650450, optional=True,) - progress = proto.Field(proto.INT32, number=72663597, optional=True,) region = proto.Field(proto.STRING, number=138946292, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - start_time = proto.Field(proto.STRING, number=37467274, optional=True,) - status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) - status_message = proto.Field(proto.STRING, number=297428154, optional=True,) - target_id = proto.Field(proto.UINT64, number=258165385, optional=True,) - target_link = proto.Field(proto.STRING, number=62671336, optional=True,) - user = proto.Field(proto.STRING, number=3599307, optional=True,) - warnings = proto.RepeatedField(proto.MESSAGE, number=498091095, message="Warnings",) - zone = proto.Field(proto.STRING, number=3744684, optional=True,) - - -class OperationsScopedList(proto.Message): - r""" - Attributes: - operations (Sequence[google.cloud.compute_v1.types.Operation]): - [Output Only] A list of operations contained in this scope. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning which replaces the list - of operations when the list is empty. - """ - - operations = proto.RepeatedField( - proto.MESSAGE, number=4184044, message="Operation", - ) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) - - -class OperationAggregatedList(proto.Message): - r""" - Attributes: - id (str): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - items (Sequence[google.cloud.compute_v1.types.OperationAggregatedList.ItemsEntry]): - [Output Only] A map of scoped operation lists. - kind (str): - [Output Only] Type of resource. Always - ``compute#operationAggregatedList`` for aggregated lists of - operations. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than ``maxResults``, use the ``nextPageToken`` as a - value for the query parameter ``pageToken`` in the next list - request. Subsequent list requests will have their own - ``nextPageToken`` to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - unreachables (Sequence[str]): - [Output Only] Unreachable resources. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. - """ - - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.MapField( - proto.STRING, proto.MESSAGE, number=100526016, message="OperationsScopedList", + ssl_health_check = proto.Field( + proto.MESSAGE, number=280032440, optional=True, message="SSLHealthCheck", ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - unreachables = proto.RepeatedField(proto.STRING, number=243372063,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + tcp_health_check = proto.Field( + proto.MESSAGE, number=469980419, optional=True, message="TCPHealthCheck", ) + timeout_sec = proto.Field(proto.INT32, number=79994995, optional=True,) + type_ = proto.Field(proto.ENUM, number=3575610, optional=True, enum=Type,) + unhealthy_threshold = proto.Field(proto.INT32, number=227958480, optional=True,) -class OperationList(proto.Message): - r"""Contains a list of Operation resources. +class HealthCheckList(proto.Message): + r"""Contains a list of HealthCheck resources. Attributes: id (str): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - items (Sequence[google.cloud.compute_v1.types.Operation]): - [Output Only] A list of Operation resources. + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.HealthCheck]): + A list of HealthCheck resources. kind (str): - [Output Only] Type of resource. Always - ``compute#operations`` for Operations resource. + Type of resource. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is - larger than ``maxResults``, use the ``nextPageToken`` as a - value for the query parameter ``pageToken`` in the next list - request. Subsequent list requests will have their own - ``nextPageToken`` to continue paging through the results. + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. self_link (str): [Output Only] Server-defined URL for this resource. warning (google.cloud.compute_v1.types.Warning): @@ -17197,7 +16611,7 @@ def raw_page(self): return self id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Operation",) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="HealthCheck",) kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) @@ -17206,255 +16620,172 @@ def raw_page(self): ) -class PacketMirroringForwardingRuleInfo(proto.Message): - r""" - Attributes: - canonical_url (str): - [Output Only] Unique identifier for the forwarding rule; - defined by the server. - url (str): - Resource URL to the forwarding rule - representing the ILB configured as destination - of the mirrored traffic. - """ - - canonical_url = proto.Field(proto.STRING, number=512294820, optional=True,) - url = proto.Field(proto.STRING, number=116079, optional=True,) - +class HealthCheckLogConfig(proto.Message): + r"""Configuration of logging on a health check. If logging is + enabled, logs will be exported to Stackdriver. -class PacketMirroringFilter(proto.Message): - r""" Attributes: - I_p_protocols (Sequence[str]): - Protocols that apply as filter on mirrored - traffic. If no protocols are specified, all - traffic that matches the specified CIDR ranges - is mirrored. If neither cidrRanges nor - IPProtocols is specified, all traffic is - mirrored. - cidr_ranges (Sequence[str]): - IP CIDR ranges that apply as filter on the - source (ingress) or destination (egress) IP in - the IP header. Only IPv4 is supported. If no - ranges are specified, all traffic that matches - the specified IPProtocols is mirrored. If - neither cidrRanges nor IPProtocols is specified, - all traffic is mirrored. - direction (google.cloud.compute_v1.types.PacketMirroringFilter.Direction): - Direction of traffic to mirror, either - INGRESS, EGRESS, or BOTH. The default is BOTH. + enable (bool): + Indicates whether or not to export logs. This + is false by default, which means no health check + logging will be done. """ - class Direction(proto.Enum): - r"""Direction of traffic to mirror, either INGRESS, EGRESS, or - BOTH. The default is BOTH. - """ - UNDEFINED_DIRECTION = 0 - BOTH = 2044801 - EGRESS = 432880501 - INGRESS = 516931221 + enable = proto.Field(proto.BOOL, number=311764355, optional=True,) - I_p_protocols = proto.RepeatedField(proto.STRING, number=98544854,) - cidr_ranges = proto.RepeatedField(proto.STRING, number=487901697,) - direction = proto.Field( - proto.ENUM, number=111150975, optional=True, enum=Direction, - ) +class HealthCheckReference(proto.Message): + r"""A full or valid partial URL to a health check. For example, + the following are valid URLs: - + https://www.googleapis.com/compute/beta/projects/project- + id/global/httpHealthChecks/health-check - projects/project- + id/global/httpHealthChecks/health-check - + global/httpHealthChecks/health-check -class PacketMirroringMirroredResourceInfo(proto.Message): - r""" Attributes: - instances (Sequence[google.cloud.compute_v1.types.PacketMirroringMirroredResourceInfoInstanceInfo]): - A set of virtual machine instances that are - being mirrored. They must live in zones - contained in the same region as this - packetMirroring. Note that this config will - apply only to those network interfaces of the - Instances that belong to the network specified - in this packetMirroring. - You may specify a maximum of 50 Instances. - subnetworks (Sequence[google.cloud.compute_v1.types.PacketMirroringMirroredResourceInfoSubnetInfo]): - A set of subnetworks for which traffic - from/to all VM instances will be mirrored. They - must live in the same region as this - packetMirroring. You may specify a maximum of 5 - subnetworks. - tags (Sequence[str]): - A set of mirrored tags. Traffic from/to all - VM instances that have one or more of these tags - will be mirrored. - """ - - instances = proto.RepeatedField( - proto.MESSAGE, - number=29097598, - message="PacketMirroringMirroredResourceInfoInstanceInfo", - ) - subnetworks = proto.RepeatedField( - proto.MESSAGE, - number=415853125, - message="PacketMirroringMirroredResourceInfoSubnetInfo", - ) - tags = proto.RepeatedField(proto.STRING, number=3552281,) - + health_check (str): -class PacketMirroringNetworkInfo(proto.Message): - r""" - Attributes: - canonical_url (str): - [Output Only] Unique identifier for the network; defined by - the server. - url (str): - URL of the network resource. """ - canonical_url = proto.Field(proto.STRING, number=512294820, optional=True,) - url = proto.Field(proto.STRING, number=116079, optional=True,) - - -class PacketMirroring(proto.Message): - r"""Represents a Packet Mirroring resource. + health_check = proto.Field(proto.STRING, number=308876645, optional=True,) - Packet Mirroring clones the traffic of specified instances in your - Virtual Private Cloud (VPC) network and forwards it to a collector - destination, such as an instance group of an internal TCP/UDP load - balancer, for analysis or examination. For more information about - setting up Packet Mirroring, see Using Packet Mirroring. (== - resource_for {$api_version}.packetMirrorings ==) +class HealthCheckService(proto.Message): + r"""Represents a Health-Check as a Service resource. Attributes: - collector_ilb (google.cloud.compute_v1.types.PacketMirroringForwardingRuleInfo): - The Forwarding Rule resource of type - loadBalancingScheme=INTERNAL that will be used - as collector for mirrored traffic. The specified - forwarding rule must have isMirroringCollector - set to true. creation_timestamp (str): [Output Only] Creation timestamp in RFC3339 text format. description (str): An optional description of this resource. Provide this property when you create the resource. - enable (google.cloud.compute_v1.types.PacketMirroring.Enable): - Indicates whether or not this packet - mirroring takes effect. If set to FALSE, this - packet mirroring policy will not be enforced on - the network. The default is TRUE. - filter (google.cloud.compute_v1.types.PacketMirroringFilter): - Filter for mirrored traffic. If unspecified, - all traffic is mirrored. + fingerprint (str): + Fingerprint of this resource. A hash of the + contents stored in this object. This field is + used in optimistic locking. This field will be + ignored when inserting a HealthCheckService. An + up-to-date fingerprint must be provided in order + to patch/update the HealthCheckService; + Otherwise, the request will fail with error 412 + conditionNotMet. To see the latest fingerprint, + make a get() request to retrieve the + HealthCheckService. + health_checks (Sequence[str]): + A list of URLs to the HealthCheck resources. Must have at + least one HealthCheck, and not more than 10. HealthCheck + resources must have portSpecification=USE_SERVING_PORT or + portSpecification=USE_FIXED_PORT. For regional + HealthCheckService, the HealthCheck must be regional and in + the same region. For global HealthCheckService, HealthCheck + must be global. Mix of regional and global HealthChecks is + not supported. Multiple regional HealthChecks must belong to + the same region. Regional HealthChecks must belong to the + same region as zones of NEGs. + health_status_aggregation_policy (google.cloud.compute_v1.types.HealthCheckService.HealthStatusAggregationPolicy): + Optional. Policy for how the results from multiple health + checks for the same endpoint are aggregated. Defaults to + NO_AGGREGATION if unspecified. - NO_AGGREGATION. An + EndpointHealth message is returned for each pair in the + health check service. - AND. If any health check of an + endpoint reports UNHEALTHY, then UNHEALTHY is the + HealthState of the endpoint. If all health checks report + HEALTHY, the HealthState of the endpoint is HEALTHY. . id (int): [Output Only] The unique identifier for the resource. This identifier is defined by the server. kind (str): - [Output Only] Type of the resource. Always - compute#packetMirroring for packet mirrorings. - mirrored_resources (google.cloud.compute_v1.types.PacketMirroringMirroredResourceInfo): - PacketMirroring mirroredResourceInfos. - MirroredResourceInfo specifies a set of mirrored - VM instances, subnetworks and/or tags for which - traffic from/to all VM instances will be - mirrored. + [Output only] Type of the resource. Always + compute#healthCheckServicefor health check services. name (str): - Name of the resource; provided by the client when the - resource is created. The name must be 1-63 characters long, + Name of the resource. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. - network (google.cloud.compute_v1.types.PacketMirroringNetworkInfo): - Specifies the mirrored VPC network. Only - packets in this network will be mirrored. All - mirrored VMs should have a NIC in the given - network. All mirrored subnetworks should belong - to the given network. - priority (int): - The priority of applying this configuration. - Priority is used to break ties in cases where - there is more than one matching rule. In the - case of two rules that apply for a given - Instance, the one with the lowest-numbered - priority value wins. Default value is 1000. - Valid range is 0 through 65535. + network_endpoint_groups (Sequence[str]): + A list of URLs to the NetworkEndpointGroup + resources. Must not have more than 100. For + regional HealthCheckService, NEGs must be in + zones in the region of the HealthCheckService. + notification_endpoints (Sequence[str]): + A list of URLs to the NotificationEndpoint + resources. Must not have more than 10. A list of + endpoints for receiving notifications of change + in health status. For regional + HealthCheckService, NotificationEndpoint must be + regional and in the same region. For global + HealthCheckService, NotificationEndpoint must be + global. region (str): - [Output Only] URI of the region where the packetMirroring - resides. + [Output Only] URL of the region where the health check + service resides. This field is not applicable to global + health check services. You must specify this field as part + of the HTTP request URL. It is not settable as a field in + the request body. self_link (str): [Output Only] Server-defined URL for the resource. """ - class Enable(proto.Enum): - r"""Indicates whether or not this packet mirroring takes effect. - If set to FALSE, this packet mirroring policy will not be - enforced on the network. The default is TRUE. + class HealthStatusAggregationPolicy(proto.Enum): + r"""Optional. Policy for how the results from multiple health checks for + the same endpoint are aggregated. Defaults to NO_AGGREGATION if + unspecified. - NO_AGGREGATION. An EndpointHealth message is returned + for each pair in the health check service. - AND. If any health + check of an endpoint reports UNHEALTHY, then UNHEALTHY is the + HealthState of the endpoint. If all health checks report HEALTHY, + the HealthState of the endpoint is HEALTHY. . """ - UNDEFINED_ENABLE = 0 - FALSE = 66658563 - TRUE = 2583950 + UNDEFINED_HEALTH_STATUS_AGGREGATION_POLICY = 0 + AND = 64951 + NO_AGGREGATION = 426445124 - collector_ilb = proto.Field( - proto.MESSAGE, - number=426607853, - optional=True, - message="PacketMirroringForwardingRuleInfo", - ) creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) description = proto.Field(proto.STRING, number=422937596, optional=True,) - enable = proto.Field(proto.ENUM, number=311764355, optional=True, enum=Enable,) - filter = proto.Field( - proto.MESSAGE, number=336120696, optional=True, message="PacketMirroringFilter", - ) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - mirrored_resources = proto.Field( - proto.MESSAGE, - number=124817348, - optional=True, - message="PacketMirroringMirroredResourceInfo", - ) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - network = proto.Field( - proto.MESSAGE, - number=232872494, - optional=True, - message="PacketMirroringNetworkInfo", + fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) + health_checks = proto.RepeatedField(proto.STRING, number=448370606,) + health_status_aggregation_policy = proto.Field( + proto.ENUM, number=253163129, optional=True, enum=HealthStatusAggregationPolicy, ) - priority = proto.Field(proto.UINT32, number=445151652, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + network_endpoint_groups = proto.RepeatedField(proto.STRING, number=29346733,) + notification_endpoints = proto.RepeatedField(proto.STRING, number=406728490,) region = proto.Field(proto.STRING, number=138946292, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) -class PacketMirroringsScopedList(proto.Message): - r""" +class HealthCheckServiceReference(proto.Message): + r"""A full or valid partial URL to a health check service. For + example, the following are valid URLs: - + https://www.googleapis.com/compute/beta/projects/project- + id/regions/us-west1/healthCheckServices/health-check-service - + projects/project-id/regions/us-west1/healthCheckServices/health- + check-service - regions/us-west1/healthCheckServices/health- + check-service + Attributes: - packet_mirrorings (Sequence[google.cloud.compute_v1.types.PacketMirroring]): - A list of packetMirrorings contained in this - scope. - warning (google.cloud.compute_v1.types.Warning): - Informational warning which replaces the list - of packetMirrorings when the list is empty. + health_check_service (str): + """ - packet_mirrorings = proto.RepeatedField( - proto.MESSAGE, number=154615079, message="PacketMirroring", - ) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) + health_check_service = proto.Field(proto.STRING, number=408374747, optional=True,) -class PacketMirroringAggregatedList(proto.Message): - r"""Contains a list of packetMirrorings. +class HealthCheckServicesList(proto.Message): + r""" Attributes: id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.PacketMirroringAggregatedList.ItemsEntry]): - A list of PacketMirroring resources. + items (Sequence[google.cloud.compute_v1.types.HealthCheckService]): + A list of HealthCheckService resources. kind (str): - Type of resource. + [Output Only] Type of the resource. Always + compute#healthCheckServicesList for lists of + HealthCheckServices. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -17464,8 +16795,6 @@ class PacketMirroringAggregatedList(proto.Message): to continue paging through the results. self_link (str): [Output Only] Server-defined URL for this resource. - unreachables (Sequence[str]): - [Output Only] Unreachable resources. warning (google.cloud.compute_v1.types.Warning): [Output Only] Informational warning message. """ @@ -17475,1007 +16804,959 @@ def raw_page(self): return self id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.MapField( - proto.STRING, - proto.MESSAGE, - number=100526016, - message="PacketMirroringsScopedList", + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="HealthCheckService", ) kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - unreachables = proto.RepeatedField(proto.STRING, number=243372063,) warning = proto.Field( proto.MESSAGE, number=50704284, optional=True, message="Warning", ) -class PacketMirroringList(proto.Message): - r"""Contains a list of PacketMirroring resources. +class HealthChecksAggregatedList(proto.Message): + r""" Attributes: id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.PacketMirroring]): - A list of PacketMirroring resources. + items (Sequence[google.cloud.compute_v1.types.HealthChecksAggregatedList.ItemsEntry]): + A list of HealthChecksScopedList resources. kind (str): - [Output Only] Type of resource. Always - compute#packetMirroring for packetMirrorings. + Type of resource. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. - """ - - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="PacketMirroring", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) - - -class PacketMirroringMirroredResourceInfoInstanceInfo(proto.Message): - r""" - Attributes: - canonical_url (str): - [Output Only] Unique identifier for the instance; defined by - the server. - url (str): - Resource URL to the virtual machine instance - which is being mirrored. - """ - - canonical_url = proto.Field(proto.STRING, number=512294820, optional=True,) - url = proto.Field(proto.STRING, number=116079, optional=True,) - - -class PacketMirroringMirroredResourceInfoSubnetInfo(proto.Message): - r""" - Attributes: - canonical_url (str): - [Output Only] Unique identifier for the subnetwork; defined - by the server. - url (str): - Resource URL to the subnetwork for which - traffic from/to all VM instances will be - mirrored. - """ - - canonical_url = proto.Field(proto.STRING, number=512294820, optional=True,) - url = proto.Field(proto.STRING, number=116079, optional=True,) - - -class PathRule(proto.Message): - r"""A path-matching rule for a URL. If matched, will use the - specified BackendService to handle the traffic arriving at this - URL. - - Attributes: - paths (Sequence[str]): - The list of path patterns to match. Each must start with / - and the only place a \* is allowed is at the end following a - /. The string fed to the path matcher does not include any - text after the first ? or #, and those chars are not allowed - here. - route_action (google.cloud.compute_v1.types.HttpRouteAction): - In response to a matching path, the load - balancer performs advanced routing actions like - URL rewrites, header transformations, etc. prior - to forwarding the request to the selected - backend. If routeAction specifies any - weightedBackendServices, service must not be - set. Conversely if service is set, routeAction - cannot contain any weightedBackendServices. - Only one of routeAction or urlRedirect must be - set. UrlMaps for external HTTP(S) load balancers - support only the urlRewrite action within a - pathRule's routeAction. - service (str): - The full or partial URL of the backend - service resource to which traffic is directed if - this rule is matched. If routeAction is - additionally specified, advanced routing actions - like URL Rewrites, etc. take effect prior to - sending the request to the backend. However, if - service is specified, routeAction cannot contain - any weightedBackendService s. Conversely, if - routeAction specifies any - weightedBackendServices, service must not be - specified. Only one of urlRedirect, service or - routeAction.weightedBackendService must be set. - url_redirect (google.cloud.compute_v1.types.HttpRedirectAction): - When a path pattern is matched, the request - is redirected to a URL specified by urlRedirect. - If urlRedirect is specified, service or - routeAction must not be set. Not supported when - the URL map is bound to target gRPC proxy. - """ - - paths = proto.RepeatedField(proto.STRING, number=106438894,) - route_action = proto.Field( - proto.MESSAGE, number=424563948, optional=True, message="HttpRouteAction", - ) - service = proto.Field(proto.STRING, number=373540533, optional=True,) - url_redirect = proto.Field( - proto.MESSAGE, number=405147820, optional=True, message="HttpRedirectAction", - ) - - -class PathMatcher(proto.Message): - r"""A matcher for the path portion of the URL. The BackendService - from the longest-matched rule will serve the URL. If no rule was - matched, the default service will be used. - - Attributes: - default_route_action (google.cloud.compute_v1.types.HttpRouteAction): - defaultRouteAction takes effect when none of - the pathRules or routeRules match. The load - balancer performs advanced routing actions like - URL rewrites, header transformations, etc. prior - to forwarding the request to the selected - backend. If defaultRouteAction specifies any - weightedBackendServices, defaultService must not - be set. Conversely if defaultService is set, - defaultRouteAction cannot contain any - weightedBackendServices. Only one of - defaultRouteAction or defaultUrlRedirect must be - set. UrlMaps for external HTTP(S) load balancers - support only the urlRewrite action within a - pathMatcher's defaultRouteAction. - default_service (str): - The full or partial URL to the BackendService resource. This - will be used if none of the pathRules or routeRules defined - by this PathMatcher are matched. For example, the following - are all valid URLs to a BackendService resource: - - - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService - - compute/v1/projects/project/global/backendServices/backendService - - global/backendServices/backendService If - defaultRouteAction is additionally specified, advanced - routing actions like URL Rewrites, etc. take effect prior - to sending the request to the backend. However, if - defaultService is specified, defaultRouteAction cannot - contain any weightedBackendServices. Conversely, if - defaultRouteAction specifies any weightedBackendServices, - defaultService must not be specified. Only one of - defaultService, defaultUrlRedirect or - defaultRouteAction.weightedBackendService must be set. - Authorization requires one or more of the following - Google IAM permissions on the specified resource - default_service: - - compute.backendBuckets.use - - compute.backendServices.use - default_url_redirect (google.cloud.compute_v1.types.HttpRedirectAction): - When none of the specified pathRules or - routeRules match, the request is redirected to a - URL specified by defaultUrlRedirect. If - defaultUrlRedirect is specified, defaultService - or defaultRouteAction must not be set. Not - supported when the URL map is bound to target - gRPC proxy. - description (str): - An optional description of this resource. - Provide this property when you create the - resource. - header_action (google.cloud.compute_v1.types.HttpHeaderAction): - Specifies changes to request and response - headers that need to take effect for the - selected backendService. HeaderAction specified - here are applied after the matching - HttpRouteRule HeaderAction and before the - HeaderAction in the UrlMap Note that - headerAction is not supported for Loadbalancers - that have their loadBalancingScheme set to - EXTERNAL. Not supported when the URL map is - bound to target gRPC proxy that has - validateForProxyless field set to true. - name (str): - The name to which this PathMatcher is - referred by the HostRule. - path_rules (Sequence[google.cloud.compute_v1.types.PathRule]): - The list of path rules. Use this list instead of routeRules - when routing based on simple path matching is all that's - required. The order by which path rules are specified does - not matter. Matches are always done on the - longest-path-first basis. For example: a pathRule with a - path /a/b/c/\* will match before /a/b/\* irrespective of the - order in which those paths appear in this list. Within a - given pathMatcher, only one of pathRules or routeRules must - be set. - route_rules (Sequence[google.cloud.compute_v1.types.HttpRouteRule]): - The list of HTTP route rules. Use this list - instead of pathRules when advanced route - matching and routing actions are desired. - routeRules are evaluated in order of priority, - from the lowest to highest number. Within a - given pathMatcher, you can set only one of - pathRules or routeRules. - """ - - default_route_action = proto.Field( - proto.MESSAGE, number=378919466, optional=True, message="HttpRouteAction", - ) - default_service = proto.Field(proto.STRING, number=370242231, optional=True,) - default_url_redirect = proto.Field( - proto.MESSAGE, number=359503338, optional=True, message="HttpRedirectAction", - ) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - header_action = proto.Field( - proto.MESSAGE, number=328077352, optional=True, message="HttpHeaderAction", - ) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - path_rules = proto.RepeatedField( - proto.MESSAGE, number=104439901, message="PathRule", - ) - route_rules = proto.RepeatedField( - proto.MESSAGE, number=376292225, message="HttpRouteRule", - ) - - -class Rule(proto.Message): - r"""A rule to be applied in a Policy. - Attributes: - action (google.cloud.compute_v1.types.Rule.Action): - Required - conditions (Sequence[google.cloud.compute_v1.types.Condition]): - Additional restrictions that must be met. All - conditions must pass for the rule to match. - description (str): - Human-readable description of the rule. - ins (Sequence[str]): - If one or more 'in' clauses are specified, the rule matches - if the PRINCIPAL/AUTHORITY_SELECTOR is in at least one of - these entries. - log_configs (Sequence[google.cloud.compute_v1.types.LogConfig]): - The config returned to callers of - tech.iam.IAM.CheckPolicy for any entries that - match the LOG action. - not_ins (Sequence[str]): - If one or more 'not_in' clauses are specified, the rule - matches if the PRINCIPAL/AUTHORITY_SELECTOR is in none of - the entries. - permissions (Sequence[str]): - A permission is a string of form '..' (e.g., - 'storage.buckets.list'). A value of '*' matches all - permissions, and a verb part of '*' (e.g., - 'storage.buckets.*') matches all verbs. - """ - - class Action(proto.Enum): - r"""Required""" - UNDEFINED_ACTION = 0 - ALLOW = 62368553 - ALLOW_WITH_LOG = 76034177 - DENY = 2094604 - DENY_WITH_LOG = 351433982 - LOG = 75556 - NO_ACTION = 260643444 - - action = proto.Field(proto.ENUM, number=187661878, optional=True, enum=Action,) - conditions = proto.RepeatedField( - proto.MESSAGE, number=142882488, message="Condition", - ) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - ins = proto.RepeatedField(proto.STRING, number=104430,) - log_configs = proto.RepeatedField( - proto.MESSAGE, number=152873846, message="LogConfig", - ) - not_ins = proto.RepeatedField(proto.STRING, number=518443138,) - permissions = proto.RepeatedField(proto.STRING, number=59962500,) - - -class WafExpressionSet(proto.Message): - r""" - Attributes: - aliases (Sequence[str]): - A list of alternate IDs. The format should - be: - E.g. XSS-stable Generic suffix like - "stable" is particularly useful if a policy - likes to avail newer set of expressions without - having to change the policy. A given alias name - can't be used for more than one entity set. - expressions (Sequence[google.cloud.compute_v1.types.WafExpressionSetExpression]): - List of available expressions. - id (str): - Google specified expression set ID. The - format should be: - E.g. XSS-20170329 - """ - - aliases = proto.RepeatedField(proto.STRING, number=159207166,) - expressions = proto.RepeatedField( - proto.MESSAGE, number=175554779, message="WafExpressionSetExpression", - ) - id = proto.Field(proto.STRING, number=3355, optional=True,) - - -class PreconfiguredWafSet(proto.Message): - r""" - Attributes: - expression_sets (Sequence[google.cloud.compute_v1.types.WafExpressionSet]): - List of entities that are currently supported - for WAF rules. - """ - - expression_sets = proto.RepeatedField( - proto.MESSAGE, number=474011032, message="WafExpressionSet", - ) - - -class PreservedStatePreservedDisk(proto.Message): - r""" - Attributes: - auto_delete (google.cloud.compute_v1.types.PreservedStatePreservedDisk.AutoDelete): - These stateful disks will never be deleted during - autohealing, update, instance recreate operations. This flag - is used to configure if the disk should be deleted after it - is no longer used by the group, e.g. when the given instance - or the whole MIG is deleted. Note: disks attached in - READ_ONLY mode cannot be auto-deleted. - mode (google.cloud.compute_v1.types.PreservedStatePreservedDisk.Mode): - The mode in which to attach this disk, either READ_WRITE or - READ_ONLY. If not specified, the default is to attach the - disk in READ_WRITE mode. - source (str): - The URL of the disk resource that is stateful - and should be attached to the VM instance. - """ - - class AutoDelete(proto.Enum): - r"""These stateful disks will never be deleted during autohealing, - update, instance recreate operations. This flag is used to configure - if the disk should be deleted after it is no longer used by the - group, e.g. when the given instance or the whole MIG is deleted. - Note: disks attached in READ_ONLY mode cannot be auto-deleted. - """ - UNDEFINED_AUTO_DELETE = 0 - NEVER = 74175084 - ON_PERMANENT_INSTANCE_DELETION = 95727719 - - class Mode(proto.Enum): - r"""The mode in which to attach this disk, either READ_WRITE or - READ_ONLY. If not specified, the default is to attach the disk in - READ_WRITE mode. - """ - UNDEFINED_MODE = 0 - READ_ONLY = 91950261 - READ_WRITE = 173607894 - - auto_delete = proto.Field( - proto.ENUM, number=464761403, optional=True, enum=AutoDelete, - ) - mode = proto.Field(proto.ENUM, number=3357091, optional=True, enum=Mode,) - source = proto.Field(proto.STRING, number=177235995, optional=True,) - - -class Quota(proto.Message): - r"""A quotas entry. - Attributes: - limit (float): - [Output Only] Quota limit for this metric. - metric (google.cloud.compute_v1.types.Quota.Metric): - [Output Only] Name of the quota metric. - owner (str): - [Output Only] Owning resource. This is the resource on which - this quota is applied. - usage (float): - [Output Only] Current usage of this metric. - """ - - class Metric(proto.Enum): - r"""[Output Only] Name of the quota metric.""" - UNDEFINED_METRIC = 0 - A2_CPUS = 153206585 - AFFINITY_GROUPS = 108303563 - AUTOSCALERS = 471248988 - BACKEND_BUCKETS = 137626846 - BACKEND_SERVICES = 269623753 - C2D_CPUS = 508182517 - C2_CPUS = 317601211 - COMMITMENTS = 456141790 - COMMITTED_A2_CPUS = 59330902 - COMMITTED_C2D_CPUS = 282390904 - COMMITTED_C2_CPUS = 223725528 - COMMITTED_CPUS = 292394702 - COMMITTED_E2_CPUS = 388120154 - COMMITTED_LICENSES = 357606869 - COMMITTED_LOCAL_SSD_TOTAL_GB = 308393480 - COMMITTED_MEMORY_OPTIMIZED_CPUS = 489057886 - COMMITTED_N2A_CPUS = 40064304 - COMMITTED_N2D_CPUS = 125951757 - COMMITTED_N2_CPUS = 322589603 - COMMITTED_NVIDIA_A100_GPUS = 375799445 - COMMITTED_NVIDIA_K80_GPUS = 3857188 - COMMITTED_NVIDIA_P100_GPUS = 107528100 - COMMITTED_NVIDIA_P4_GPUS = 347952897 - COMMITTED_NVIDIA_T4_GPUS = 139871237 - COMMITTED_NVIDIA_V100_GPUS = 219562 - CPUS = 2075595 - CPUS_ALL_REGIONS = 470911149 - DISKS_TOTAL_GB = 353520543 - E2_CPUS = 481995837 - EXTERNAL_NETWORK_LB_FORWARDING_RULES = 374298265 - EXTERNAL_PROTOCOL_FORWARDING_RULES = 63478888 - EXTERNAL_VPN_GATEWAYS = 272457134 - FIREWALLS = 374485843 - FORWARDING_RULES = 432668949 - GLOBAL_INTERNAL_ADDRESSES = 42738332 - GPUS_ALL_REGIONS = 39387177 - HEALTH_CHECKS = 289347502 - IMAGES = 15562360 - INSTANCES = 131337822 - INSTANCE_GROUPS = 355919038 - INSTANCE_GROUP_MANAGERS = 101798192 - INSTANCE_TEMPLATES = 226188271 - INTERCONNECTS = 415204741 - INTERCONNECT_ATTACHMENTS_PER_REGION = 159968086 - INTERCONNECT_ATTACHMENTS_TOTAL_MBPS = 425090419 - INTERCONNECT_TOTAL_GBPS = 285341866 - INTERNAL_ADDRESSES = 197899392 - INTERNAL_TRAFFIC_DIRECTOR_FORWARDING_RULES = 266433668 - IN_PLACE_SNAPSHOTS = 151359133 - IN_USE_ADDRESSES = 402125072 - IN_USE_BACKUP_SCHEDULES = 32786705 - IN_USE_SNAPSHOT_SCHEDULES = 462104083 - LOCAL_SSD_TOTAL_GB = 330878021 - M1_CPUS = 37203366 - M2_CPUS = 65832517 - MACHINE_IMAGES = 446986640 - N2A_CPUS = 265855917 - N2D_CPUS = 351743370 - N2_CPUS = 416465286 - NETWORKS = 485481477 - NETWORK_ENDPOINT_GROUPS = 102144909 - NETWORK_FIREWALL_POLICIES = 101117374 - NODE_GROUPS = 24624817 - NODE_TEMPLATES = 474896668 - NVIDIA_A100_GPUS = 504872978 - NVIDIA_K80_GPUS = 163886599 - NVIDIA_P100_GPUS = 236601633 - NVIDIA_P100_VWS_GPUS = 213970574 - NVIDIA_P4_GPUS = 283841470 - NVIDIA_P4_VWS_GPUS = 528296619 - NVIDIA_T4_GPUS = 75759810 - NVIDIA_T4_VWS_GPUS = 319813039 - NVIDIA_V100_GPUS = 129293095 - PACKET_MIRRORINGS = 15578407 - PD_EXTREME_TOTAL_PROVISIONED_IOPS = 69593965 - PREEMPTIBLE_CPUS = 251184841 - PREEMPTIBLE_LOCAL_SSD_GB = 260819336 - PREEMPTIBLE_NVIDIA_A100_GPUS = 68832784 - PREEMPTIBLE_NVIDIA_K80_GPUS = 374960201 - PREEMPTIBLE_NVIDIA_P100_GPUS = 337432351 - PREEMPTIBLE_NVIDIA_P100_VWS_GPUS = 313544076 - PREEMPTIBLE_NVIDIA_P4_GPUS = 429197628 - PREEMPTIBLE_NVIDIA_P4_VWS_GPUS = 252981545 - PREEMPTIBLE_NVIDIA_T4_GPUS = 221115968 - PREEMPTIBLE_NVIDIA_T4_VWS_GPUS = 44497965 - PREEMPTIBLE_NVIDIA_V100_GPUS = 230123813 - PSC_ILB_CONSUMER_FORWARDING_RULES_PER_PRODUCER_NETWORK = 231164291 - PUBLIC_ADVERTISED_PREFIXES = 471371980 - PUBLIC_DELEGATED_PREFIXES = 532465974 - REGIONAL_AUTOSCALERS = 29363772 - REGIONAL_INSTANCE_GROUP_MANAGERS = 37543696 - RESERVATIONS = 32644647 - RESOURCE_POLICIES = 83955297 - ROUTERS = 493018666 - ROUTES = 275680074 - SECURITY_POLICIES = 189518703 - SECURITY_POLICY_CEVAL_RULES = 470815689 - SECURITY_POLICY_RULES = 203549225 - SNAPSHOTS = 343405327 - SSD_TOTAL_GB = 161732561 - SSL_CERTIFICATES = 378372399 - STATIC_ADDRESSES = 93624049 - STATIC_BYOIP_ADDRESSES = 275809649 - SUBNETWORKS = 421330469 - TARGET_HTTPS_PROXIES = 219522506 - TARGET_HTTP_PROXIES = 164117155 - TARGET_INSTANCES = 284519728 - TARGET_POOLS = 348261257 - TARGET_SSL_PROXIES = 159216235 - TARGET_TCP_PROXIES = 182243136 - TARGET_VPN_GATEWAYS = 75029928 - URL_MAPS = 378660743 - VPN_GATEWAYS = 35620282 - VPN_TUNNELS = 104327296 - XPN_SERVICE_PROJECTS = 95191981 + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. + """ - limit = proto.Field(proto.DOUBLE, number=102976443, optional=True,) - metric = proto.Field(proto.ENUM, number=533067184, optional=True, enum=Metric,) - owner = proto.Field(proto.STRING, number=106164915, optional=True,) - usage = proto.Field(proto.DOUBLE, number=111574433, optional=True,) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.MapField( + proto.STRING, proto.MESSAGE, number=100526016, message="HealthChecksScopedList", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class UsageExportLocation(proto.Message): - r"""The location in Cloud Storage and naming method of the daily usage - report. Contains bucket_name and report_name prefix. +class HealthChecksScopedList(proto.Message): + r""" Attributes: - bucket_name (str): - The name of an existing bucket in Cloud - Storage where the usage report object is stored. - The Google Service Account is granted write - access to this bucket. This can either be the - bucket name by itself, such as example-bucket, - or the bucket name with gs:// or - https://storage.googleapis.com/ in front of it, - such as gs://example-bucket. - report_name_prefix (str): - An optional prefix for the name of the usage report object - stored in bucketName. If not supplied, defaults to usage. - The report is stored as a CSV file named - report_name_prefix_gce_YYYYMMDD.csv where YYYYMMDD is the - day of the usage according to Pacific Time. If you supply a - prefix, it should conform to Cloud Storage object naming - conventions. + health_checks (Sequence[google.cloud.compute_v1.types.HealthCheck]): + A list of HealthChecks contained in this + scope. + warning (google.cloud.compute_v1.types.Warning): + Informational warning which replaces the list + of backend services when the list is empty. """ - bucket_name = proto.Field(proto.STRING, number=283610048, optional=True,) - report_name_prefix = proto.Field(proto.STRING, number=320198715, optional=True,) + health_checks = proto.RepeatedField( + proto.MESSAGE, number=448370606, message="HealthCheck", + ) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class Project(proto.Message): - r"""Represents a Project resource. +class HealthStatus(proto.Message): + r""" + Attributes: + annotations (Sequence[google.cloud.compute_v1.types.HealthStatus.AnnotationsEntry]): + Metadata defined as annotations for network + endpoint. + forwarding_rule (str): + URL of the forwarding rule associated with + the health status of the instance. + forwarding_rule_ip (str): + A forwarding rule IP address assigned to this + instance. + health_state (google.cloud.compute_v1.types.HealthStatus.HealthState): + Health state of the instance. + instance (str): + URL of the instance resource. + ip_address (str): + For target pool based Network Load Balancing, + it indicates the forwarding rule's IP address + assigned to this instance. For other types of + load balancing, the field indicates VM internal + ip. + port (int): + The named port of the instance group, not + necessarily the port that is health-checked. + weight (str): - A project is used to organize resources in a Google Cloud Platform - environment. For more information, read about the Resource - Hierarchy. (== resource_for {$api_version}.projects ==) + weight_error (google.cloud.compute_v1.types.HealthStatus.WeightError): - Attributes: - common_instance_metadata (google.cloud.compute_v1.types.Metadata): - Metadata key/value pairs available to all - instances contained in this project. See Custom - metadata for more information. - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - default_network_tier (google.cloud.compute_v1.types.Project.DefaultNetworkTier): - This signifies the default network tier used - for configuring resources of the project and can - only take the following values: PREMIUM, - STANDARD. Initially the default network tier is - PREMIUM. - default_service_account (str): - [Output Only] Default service account used by VMs running in - this project. - description (str): - An optional textual description of the - resource. - enabled_features (Sequence[str]): - Restricted features enabled for use on this - project. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. This is not the project - ID, and is just a unique ID used by Compute Engine to - identify resources. - kind (str): - [Output Only] Type of the resource. Always compute#project - for projects. - name (str): - The project ID. For example: my-example- - roject. Use the project ID to make requests to - Compute Engine. - quotas (Sequence[google.cloud.compute_v1.types.Quota]): - [Output Only] Quotas assigned to this project. - self_link (str): - [Output Only] Server-defined URL for the resource. - usage_export_location (google.cloud.compute_v1.types.UsageExportLocation): - The naming prefix for daily usage reports and - the Google Cloud Storage bucket where they are - stored. - xpn_project_status (google.cloud.compute_v1.types.Project.XpnProjectStatus): - [Output Only] The role this project has in a shared VPC - configuration. Currently, only projects with the host role, - which is specified by the value HOST, are differentiated. """ - class DefaultNetworkTier(proto.Enum): - r"""This signifies the default network tier used for configuring - resources of the project and can only take the following values: - PREMIUM, STANDARD. Initially the default network tier is - PREMIUM. - """ - UNDEFINED_DEFAULT_NETWORK_TIER = 0 - PREMIUM = 399530551 - STANDARD = 484642493 + class HealthState(proto.Enum): + r"""Health state of the instance.""" + UNDEFINED_HEALTH_STATE = 0 + HEALTHY = 439801213 + UNHEALTHY = 462118084 - class XpnProjectStatus(proto.Enum): - r"""[Output Only] The role this project has in a shared VPC - configuration. Currently, only projects with the host role, which is - specified by the value HOST, are differentiated. + class WeightError(proto.Enum): + r"""""" + UNDEFINED_WEIGHT_ERROR = 0 + INVALID_WEIGHT = 383698400 + MISSING_WEIGHT = 384027537 + UNAVAILABLE_WEIGHT = 439464295 + WEIGHT_NONE = 502428831 + + annotations = proto.MapField(proto.STRING, proto.STRING, number=112032548,) + forwarding_rule = proto.Field(proto.STRING, number=269964030, optional=True,) + forwarding_rule_ip = proto.Field(proto.STRING, number=172250632, optional=True,) + health_state = proto.Field( + proto.ENUM, number=324007150, optional=True, enum=HealthState, + ) + instance = proto.Field(proto.STRING, number=18257045, optional=True,) + ip_address = proto.Field(proto.STRING, number=406272220, optional=True,) + port = proto.Field(proto.INT32, number=3446913, optional=True,) + weight = proto.Field(proto.STRING, number=282149496, optional=True,) + weight_error = proto.Field( + proto.ENUM, number=522501505, optional=True, enum=WeightError, + ) + + +class HealthStatusForNetworkEndpoint(proto.Message): + r""" + Attributes: + backend_service (google.cloud.compute_v1.types.BackendServiceReference): + URL of the backend service associated with + the health state of the network endpoint. + forwarding_rule (google.cloud.compute_v1.types.ForwardingRuleReference): + URL of the forwarding rule associated with + the health state of the network endpoint. + health_check (google.cloud.compute_v1.types.HealthCheckReference): + URL of the health check associated with the + health state of the network endpoint. + health_check_service (google.cloud.compute_v1.types.HealthCheckServiceReference): + URL of the health check service associated + with the health state of the network endpoint. + health_state (google.cloud.compute_v1.types.HealthStatusForNetworkEndpoint.HealthState): + Health state of the network endpoint + determined based on the health checks + configured. + """ + + class HealthState(proto.Enum): + r"""Health state of the network endpoint determined based on the + health checks configured. """ - UNDEFINED_XPN_PROJECT_STATUS = 0 - HOST = 2223528 - UNSPECIFIED_XPN_PROJECT_STATUS = 340393257 + UNDEFINED_HEALTH_STATE = 0 + DRAINING = 480455402 + HEALTHY = 439801213 + UNHEALTHY = 462118084 + UNKNOWN = 433141802 - common_instance_metadata = proto.Field( - proto.MESSAGE, number=185794117, optional=True, message="Metadata", + backend_service = proto.Field( + proto.MESSAGE, + number=306946058, + optional=True, + message="BackendServiceReference", ) - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - default_network_tier = proto.Field( - proto.ENUM, number=471753361, optional=True, enum=DefaultNetworkTier, + forwarding_rule = proto.Field( + proto.MESSAGE, + number=269964030, + optional=True, + message="ForwardingRuleReference", ) - default_service_account = proto.Field( - proto.STRING, number=298712229, optional=True, + health_check = proto.Field( + proto.MESSAGE, number=308876645, optional=True, message="HealthCheckReference", ) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - enabled_features = proto.RepeatedField(proto.STRING, number=469017467,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - quotas = proto.RepeatedField(proto.MESSAGE, number=125341947, message="Quota",) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - usage_export_location = proto.Field( - proto.MESSAGE, number=347543874, optional=True, message="UsageExportLocation", + health_check_service = proto.Field( + proto.MESSAGE, + number=408374747, + optional=True, + message="HealthCheckServiceReference", ) - xpn_project_status = proto.Field( - proto.ENUM, number=228419265, optional=True, enum=XpnProjectStatus, + health_state = proto.Field( + proto.ENUM, number=324007150, optional=True, enum=HealthState, ) -class XpnResourceId(proto.Message): - r"""Service resource (a.k.a service project) ID. +class HostRule(proto.Message): + r"""UrlMaps A host-matching rule for a URL. If matched, will use + the named PathMatcher to select the BackendService. + Attributes: - id (str): - The ID of the service resource. In the case - of projects, this field supports project id - (e.g., my-project-123) and project number (e.g. - 12345678). - type_ (google.cloud.compute_v1.types.XpnResourceId.Type): - The type of the service resource. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + hosts (Sequence[str]): + The list of host patterns to match. They must be valid + hostnames with optional port numbers in the format + host:port. \* matches any string of ([a-z0-9-.]*). In that + case, \* must be the first character and must be followed in + the pattern by either - or .. \* based matching is not + supported when the URL map is bound to target gRPC proxy + that has validateForProxyless field set to true. + path_matcher (str): + The name of the PathMatcher to use to match + the path portion of the URL if the hostRule + matches the URL's host portion. """ - class Type(proto.Enum): - r"""The type of the service resource.""" - UNDEFINED_TYPE = 0 - PROJECT = 408671993 - XPN_RESOURCE_TYPE_UNSPECIFIED = 151607034 + description = proto.Field(proto.STRING, number=422937596, optional=True,) + hosts = proto.RepeatedField(proto.STRING, number=99467211,) + path_matcher = proto.Field(proto.STRING, number=337813272, optional=True,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - type_ = proto.Field(proto.ENUM, number=3575610, optional=True, enum=Type,) +class HttpFaultAbort(proto.Message): + r"""Specification for how requests are aborted as part of fault + injection. -class ProjectsDisableXpnResourceRequest(proto.Message): - r""" Attributes: - xpn_resource (google.cloud.compute_v1.types.XpnResourceId): - Service resource (a.k.a service project) ID. + http_status (int): + The HTTP status code used to abort the + request. The value must be between 200 and 599 + inclusive. For gRPC protocol, the gRPC status + code is mapped to HTTP status code according to + this mapping table. HTTP status 200 is mapped to + gRPC status UNKNOWN. Injecting an OK status is + currently not supported by Traffic Director. + percentage (float): + The percentage of traffic + (connections/operations/requests) which will be + aborted as part of fault injection. The value + must be between 0.0 and 100.0 inclusive. """ - xpn_resource = proto.Field( - proto.MESSAGE, number=133384631, optional=True, message="XpnResourceId", + http_status = proto.Field(proto.UINT32, number=468949897, optional=True,) + percentage = proto.Field(proto.DOUBLE, number=151909018, optional=True,) + + +class HttpFaultDelay(proto.Message): + r"""Specifies the delay introduced by Loadbalancer before + forwarding the request to the backend service as part of fault + injection. + + Attributes: + fixed_delay (google.cloud.compute_v1.types.Duration): + Specifies the value of the fixed delay + interval. + percentage (float): + The percentage of traffic + (connections/operations/requests) on which delay + will be introduced as part of fault injection. + The value must be between 0.0 and 100.0 + inclusive. + """ + + fixed_delay = proto.Field( + proto.MESSAGE, number=317037816, optional=True, message="Duration", ) + percentage = proto.Field(proto.DOUBLE, number=151909018, optional=True,) -class ProjectsEnableXpnResourceRequest(proto.Message): - r""" +class HttpFaultInjection(proto.Message): + r"""The specification for fault injection introduced into traffic + to test the resiliency of clients to backend service failure. As + part of fault injection, when clients send requests to a backend + service, delays can be introduced by Loadbalancer on a + percentage of requests before sending those request to the + backend service. Similarly requests from clients can be aborted + by the Loadbalancer for a percentage of requests. + Attributes: - xpn_resource (google.cloud.compute_v1.types.XpnResourceId): - Service resource (a.k.a service project) ID. + abort (google.cloud.compute_v1.types.HttpFaultAbort): + The specification for how client requests are + aborted as part of fault injection. + delay (google.cloud.compute_v1.types.HttpFaultDelay): + The specification for how client requests are + delayed as part of fault injection, before being + sent to a backend service. """ - xpn_resource = proto.Field( - proto.MESSAGE, number=133384631, optional=True, message="XpnResourceId", + abort = proto.Field( + proto.MESSAGE, number=92611376, optional=True, message="HttpFaultAbort", + ) + delay = proto.Field( + proto.MESSAGE, number=95467907, optional=True, message="HttpFaultDelay", ) -class ProjectsGetXpnResources(proto.Message): - r""" +class HttpHeaderAction(proto.Message): + r"""The request and response header transformations that take + effect before the request is passed along to the selected + backendService. + Attributes: - kind (str): - [Output Only] Type of resource. Always - compute#projectsGetXpnResources for lists of service - resources (a.k.a service projects) - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - resources (Sequence[google.cloud.compute_v1.types.XpnResourceId]): - Service resources (a.k.a service projects) - attached to this project as their shared VPC - host. + request_headers_to_add (Sequence[google.cloud.compute_v1.types.HttpHeaderOption]): + Headers to add to a matching request prior to + forwarding the request to the backendService. + request_headers_to_remove (Sequence[str]): + A list of header names for headers that need + to be removed from the request prior to + forwarding the request to the backendService. + response_headers_to_add (Sequence[google.cloud.compute_v1.types.HttpHeaderOption]): + Headers to add the response prior to sending + the response back to the client. + response_headers_to_remove (Sequence[str]): + A list of header names for headers that need + to be removed from the response prior to sending + the response back to the client. + """ + + request_headers_to_add = proto.RepeatedField( + proto.MESSAGE, number=72111974, message="HttpHeaderOption", + ) + request_headers_to_remove = proto.RepeatedField(proto.STRING, number=218425247,) + response_headers_to_add = proto.RepeatedField( + proto.MESSAGE, number=32136052, message="HttpHeaderOption", + ) + response_headers_to_remove = proto.RepeatedField(proto.STRING, number=75415761,) + + +class HttpHeaderMatch(proto.Message): + r"""matchRule criteria for request header matches. + Attributes: + exact_match (str): + The value should exactly match contents of + exactMatch. Only one of exactMatch, prefixMatch, + suffixMatch, regexMatch, presentMatch or + rangeMatch must be set. + header_name (str): + The name of the HTTP header to match. For matching against + the HTTP request's authority, use a headerMatch with the + header name ":authority". For matching a request's method, + use the headerName ":method". When the URL map is bound to + target gRPC proxy that has validateForProxyless field set to + true, only non-binary user-specified custom metadata and the + ``content-type`` header are supported. The following + transport-level headers cannot be used in header matching + rules: ``:authority``, ``:method``, ``:path``, ``:scheme``, + ``user-agent``, ``accept-encoding``, ``content-encoding``, + ``grpc-accept-encoding``, ``grpc-encoding``, + ``grpc-previous-rpc-attempts``, ``grpc-tags-bin``, + ``grpc-timeout`` and \`grpc-trace-bin. + invert_match (bool): + If set to false, the headerMatch is + considered a match if the match criteria above + are met. If set to true, the headerMatch is + considered a match if the match criteria above + are NOT met. The default setting is false. + prefix_match (str): + The value of the header must start with the + contents of prefixMatch. Only one of exactMatch, + prefixMatch, suffixMatch, regexMatch, + presentMatch or rangeMatch must be set. + present_match (bool): + A header with the contents of headerName must + exist. The match takes place whether or not the + request's header has a value. Only one of + exactMatch, prefixMatch, suffixMatch, + regexMatch, presentMatch or rangeMatch must be + set. + range_match (google.cloud.compute_v1.types.Int64RangeMatch): + The header value must be an integer and its value must be in + the range specified in rangeMatch. If the header does not + contain an integer, number or is empty, the match fails. For + example for a range [-5, 0] - -3 will match. - 0 will not + match. - 0.25 will not match. - -3someString will not match. + Only one of exactMatch, prefixMatch, suffixMatch, + regexMatch, presentMatch or rangeMatch must be set. Note + that rangeMatch is not supported for Loadbalancers that have + their loadBalancingScheme set to EXTERNAL. + regex_match (str): + The value of the header must match the regular expression + specified in regexMatch. For regular expression grammar, + please see: github.com/google/re2/wiki/Syntax For matching + against a port specified in the HTTP request, use a + headerMatch with headerName set to PORT and a regular + expression that satisfies the RFC2616 Host header's port + specifier. Only one of exactMatch, prefixMatch, suffixMatch, + regexMatch, presentMatch or rangeMatch must be set. Note + that regexMatch only applies to Loadbalancers that have + their loadBalancingScheme set to INTERNAL_SELF_MANAGED. + suffix_match (str): + The value of the header must end with the + contents of suffixMatch. Only one of exactMatch, + prefixMatch, suffixMatch, regexMatch, + presentMatch or rangeMatch must be set. + """ + + exact_match = proto.Field(proto.STRING, number=457641093, optional=True,) + header_name = proto.Field(proto.STRING, number=110223613, optional=True,) + invert_match = proto.Field(proto.BOOL, number=501130268, optional=True,) + prefix_match = proto.Field(proto.STRING, number=257898968, optional=True,) + present_match = proto.Field(proto.BOOL, number=67435841, optional=True,) + range_match = proto.Field( + proto.MESSAGE, number=97244227, optional=True, message="Int64RangeMatch", + ) + regex_match = proto.Field(proto.STRING, number=107387853, optional=True,) + suffix_match = proto.Field(proto.STRING, number=426488663, optional=True,) + + +class HttpHeaderOption(proto.Message): + r"""Specification determining how headers are added to requests + or responses. + + Attributes: + header_name (str): + The name of the header. + header_value (str): + The value of the header to add. + replace (bool): + If false, headerValue is appended to any + values that already exist for the header. If + true, headerValue is set for the header, + discarding any values that were set for that + header. The default value is false. + """ + + header_name = proto.Field(proto.STRING, number=110223613, optional=True,) + header_value = proto.Field(proto.STRING, number=203094335, optional=True,) + replace = proto.Field(proto.BOOL, number=20755124, optional=True,) + + +class HttpQueryParameterMatch(proto.Message): + r"""HttpRouteRuleMatch criteria for a request's query parameter. + Attributes: + exact_match (str): + The queryParameterMatch matches if the value + of the parameter exactly matches the contents of + exactMatch. Only one of presentMatch, exactMatch + or regexMatch must be set. + name (str): + The name of the query parameter to match. The + query parameter must exist in the request, in + the absence of which the request match fails. + present_match (bool): + Specifies that the queryParameterMatch + matches if the request contains the query + parameter, irrespective of whether the parameter + has a value or not. Only one of presentMatch, + exactMatch or regexMatch must be set. + regex_match (str): + The queryParameterMatch matches if the value of the + parameter matches the regular expression specified by + regexMatch. For the regular expression grammar, please see + github.com/google/re2/wiki/Syntax Only one of presentMatch, + exactMatch or regexMatch must be set. Note that regexMatch + only applies when the loadBalancingScheme is set to + INTERNAL_SELF_MANAGED. """ - @property - def raw_page(self): - return self - - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - resources = proto.RepeatedField( - proto.MESSAGE, number=164412965, message="XpnResourceId", - ) + exact_match = proto.Field(proto.STRING, number=457641093, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + present_match = proto.Field(proto.BOOL, number=67435841, optional=True,) + regex_match = proto.Field(proto.STRING, number=107387853, optional=True,) -class ProjectsListXpnHostsRequest(proto.Message): - r""" +class HttpRedirectAction(proto.Message): + r"""Specifies settings for an HTTP redirect. Attributes: - organization (str): - Optional organization ID managed by Cloud - Resource Manager, for which to list shared VPC - host projects. If not specified, the - organization will be inferred from the project. + host_redirect (str): + The host that will be used in the redirect + response instead of the one that was supplied in + the request. The value must be between 1 and 255 + characters. + https_redirect (bool): + If set to true, the URL scheme in the + redirected request is set to https. If set to + false, the URL scheme of the redirected request + will remain the same as that of the request. + This must only be set for UrlMaps used in + TargetHttpProxys. Setting this true for + TargetHttpsProxy is not permitted. The default + is set to false. + path_redirect (str): + The path that will be used in the redirect + response instead of the one that was supplied in + the request. pathRedirect cannot be supplied + together with prefixRedirect. Supply one alone + or neither. If neither is supplied, the path of + the original request will be used for the + redirect. The value must be between 1 and 1024 + characters. + prefix_redirect (str): + The prefix that replaces the prefixMatch + specified in the HttpRouteRuleMatch, retaining + the remaining portion of the URL before + redirecting the request. prefixRedirect cannot + be supplied together with pathRedirect. Supply + one alone or neither. If neither is supplied, + the path of the original request will be used + for the redirect. The value must be between 1 + and 1024 characters. + redirect_response_code (google.cloud.compute_v1.types.HttpRedirectAction.RedirectResponseCode): + The HTTP Status code to use for this RedirectAction. + Supported values are: - MOVED_PERMANENTLY_DEFAULT, which is + the default value and corresponds to 301. - FOUND, which + corresponds to 302. - SEE_OTHER which corresponds to 303. - + TEMPORARY_REDIRECT, which corresponds to 307. In this case, + the request method will be retained. - PERMANENT_REDIRECT, + which corresponds to 308. In this case, the request method + will be retained. + strip_query (bool): + If set to true, any accompanying query + portion of the original URL is removed prior to + redirecting the request. If set to false, the + query portion of the original URL is retained. + The default is set to false. """ - organization = proto.Field(proto.STRING, number=105180467, optional=True,) + class RedirectResponseCode(proto.Enum): + r"""The HTTP Status code to use for this RedirectAction. Supported + values are: - MOVED_PERMANENTLY_DEFAULT, which is the default value + and corresponds to 301. - FOUND, which corresponds to 302. - + SEE_OTHER which corresponds to 303. - TEMPORARY_REDIRECT, which + corresponds to 307. In this case, the request method will be + retained. - PERMANENT_REDIRECT, which corresponds to 308. In this + case, the request method will be retained. + """ + UNDEFINED_REDIRECT_RESPONSE_CODE = 0 + FOUND = 67084130 + MOVED_PERMANENTLY_DEFAULT = 386698449 + PERMANENT_REDIRECT = 382006381 + SEE_OTHER = 445380580 + TEMPORARY_REDIRECT = 489550378 + + host_redirect = proto.Field(proto.STRING, number=107417747, optional=True,) + https_redirect = proto.Field(proto.BOOL, number=170260656, optional=True,) + path_redirect = proto.Field(proto.STRING, number=272342710, optional=True,) + prefix_redirect = proto.Field(proto.STRING, number=446184169, optional=True,) + redirect_response_code = proto.Field( + proto.ENUM, number=436710408, optional=True, enum=RedirectResponseCode, + ) + strip_query = proto.Field(proto.BOOL, number=52284641, optional=True,) -class ProjectsSetDefaultNetworkTierRequest(proto.Message): - r""" +class HttpRetryPolicy(proto.Message): + r"""The retry policy associates with HttpRouteRule Attributes: - network_tier (google.cloud.compute_v1.types.ProjectsSetDefaultNetworkTierRequest.NetworkTier): - Default network tier to be set. + num_retries (int): + Specifies the allowed number retries. This + number must be > 0. If not specified, defaults + to 1. + per_try_timeout (google.cloud.compute_v1.types.Duration): + Specifies a non-zero timeout per retry + attempt. If not specified, will use the timeout + set in HttpRouteAction. If timeout in + HttpRouteAction is not set, will use the largest + timeout among all backend services associated + with the route. + retry_conditions (Sequence[str]): + Specifies one or more conditions when this retry policy + applies. Valid values are: - 5xx: Retry will be attempted if + the instance or endpoint responds with any 5xx response + code, or if the instance or endpoint does not respond at + all, example: disconnects, reset, read timeout, connection + failure, and refused streams. - gateway-error: Similar to + 5xx, but only applies to response codes 502, 503 or 504. - - + connect-failure: A retry will be attempted on failures + connecting to the instance or endpoint, for example due to + connection timeouts. - retriable-4xx: A retry will be + attempted if the instance or endpoint responds with a + retriable 4xx response code. Currently the only retriable + error supported is 409. - refused-stream: A retry will be + attempted if the instance or endpoint resets the stream with + a REFUSED_STREAM error code. This reset type indicates that + it is safe to retry. - cancelled: A retry will be attempted + if the gRPC status code in the response header is set to + cancelled. - deadline-exceeded: A retry will be attempted if + the gRPC status code in the response header is set to + deadline-exceeded. - internal: A retry will be attempted if + the gRPC status code in the response header is set to + internal. - resource-exhausted: A retry will be attempted if + the gRPC status code in the response header is set to + resource-exhausted. - unavailable: A retry will be attempted + if the gRPC status code in the response header is set to + unavailable. """ - class NetworkTier(proto.Enum): - r"""Default network tier to be set.""" - UNDEFINED_NETWORK_TIER = 0 - PREMIUM = 399530551 - STANDARD = 484642493 - - network_tier = proto.Field( - proto.ENUM, number=517397843, optional=True, enum=NetworkTier, + num_retries = proto.Field(proto.UINT32, number=251680141, optional=True,) + per_try_timeout = proto.Field( + proto.MESSAGE, number=280041147, optional=True, message="Duration", ) + retry_conditions = proto.RepeatedField(proto.STRING, number=28815535,) -class PublicAdvertisedPrefixPublicDelegatedPrefix(proto.Message): - r"""Represents a CIDR range which can be used to assign - addresses. - +class HttpRouteAction(proto.Message): + r""" Attributes: - ip_range (str): - The IP address range of the public delegated - prefix - name (str): - The name of the public delegated prefix - project (str): - The project number of the public delegated - prefix - region (str): - The region of the public delegated prefix if - it is regional. If absent, the prefix is global. - status (str): - The status of the public delegated prefix. - Possible values are: INITIALIZING: The public - delegated prefix is being initialized and - addresses cannot be created yet. ANNOUNCED: The - public delegated prefix is active. + cors_policy (google.cloud.compute_v1.types.CorsPolicy): + The specification for allowing client side + cross-origin requests. Please see W3C + Recommendation for Cross Origin Resource Sharing + Not supported when the URL map is bound to + target gRPC proxy. + fault_injection_policy (google.cloud.compute_v1.types.HttpFaultInjection): + The specification for fault injection introduced into + traffic to test the resiliency of clients to backend service + failure. As part of fault injection, when clients send + requests to a backend service, delays can be introduced by + Loadbalancer on a percentage of requests before sending + those request to the backend service. Similarly requests + from clients can be aborted by the Loadbalancer for a + percentage of requests. For the requests impacted by fault + injection, timeout and retry_policy will be ignored by + clients that are configured with a fault_injection_policy. + max_stream_duration (google.cloud.compute_v1.types.Duration): + Specifies the maximum duration (timeout) for streams on the + selected route. Unlike the timeout field where the timeout + duration starts from the time the request has been fully + processed (i.e. end-of-stream), the duration in this field + is computed from the beginning of the stream until the + response has been completely processed, including all + retries. A stream that does not complete in this duration is + closed. If not specified, will use the largest + maxStreamDuration among all backend services associated with + the route. This field is only allowed if the Url map is used + with backend services with loadBalancingScheme set to + INTERNAL_SELF_MANAGED. + request_mirror_policy (google.cloud.compute_v1.types.RequestMirrorPolicy): + Specifies the policy on how requests intended + for the route's backends are shadowed to a + separate mirrored backend service. Loadbalancer + does not wait for responses from the shadow + service. Prior to sending traffic to the shadow + service, the host / authority header is suffixed + with -shadow. Not supported when the URL map is + bound to target gRPC proxy that has + validateForProxyless field set to true. + retry_policy (google.cloud.compute_v1.types.HttpRetryPolicy): + Specifies the retry policy associated with + this route. Not supported when the URL map is + bound to target gRPC proxy that has + validateForProxyless field set to true. + timeout (google.cloud.compute_v1.types.Duration): + Specifies the timeout for the selected route. + Timeout is computed from the time the request + has been fully processed (i.e. end-of-stream) up + until the response has been completely + processed. Timeout includes all retries. If not + specified, will use the largest timeout among + all backend services associated with the route. + Not supported when the URL map is bound to + target gRPC proxy that has validateForProxyless + field set to true. + url_rewrite (google.cloud.compute_v1.types.UrlRewrite): + The spec to modify the URL of the request, + prior to forwarding the request to the matched + service. urlRewrite is the only action supported + in UrlMaps for external HTTP(S) load balancers. + Not supported when the URL map is bound to + target gRPC proxy that has validateForProxyless + field set to true. + weighted_backend_services (Sequence[google.cloud.compute_v1.types.WeightedBackendService]): + A list of weighted backend services to send + traffic to when a route match occurs. The + weights determine the fraction of traffic that + flows to their corresponding backend service. If + all traffic needs to go to a single backend + service, there must be one + weightedBackendService with weight set to a non- + zero number. Once a backendService is identified + and before forwarding the request to the backend + service, advanced routing actions such as URL + rewrites and header transformations are applied + depending on additional settings specified in + this HttpRouteAction. """ - ip_range = proto.Field(proto.STRING, number=145092645, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - project = proto.Field(proto.STRING, number=227560217, optional=True,) - region = proto.Field(proto.STRING, number=138946292, optional=True,) - status = proto.Field(proto.STRING, number=181260274, optional=True,) + cors_policy = proto.Field( + proto.MESSAGE, number=398943748, optional=True, message="CorsPolicy", + ) + fault_injection_policy = proto.Field( + proto.MESSAGE, number=412781079, optional=True, message="HttpFaultInjection", + ) + max_stream_duration = proto.Field( + proto.MESSAGE, number=61428376, optional=True, message="Duration", + ) + request_mirror_policy = proto.Field( + proto.MESSAGE, number=220196866, optional=True, message="RequestMirrorPolicy", + ) + retry_policy = proto.Field( + proto.MESSAGE, number=56799913, optional=True, message="HttpRetryPolicy", + ) + timeout = proto.Field( + proto.MESSAGE, number=296701281, optional=True, message="Duration", + ) + url_rewrite = proto.Field( + proto.MESSAGE, number=273333948, optional=True, message="UrlRewrite", + ) + weighted_backend_services = proto.RepeatedField( + proto.MESSAGE, number=337028049, message="WeightedBackendService", + ) -class PublicAdvertisedPrefix(proto.Message): - r"""A public advertised prefix represents an aggregated IP prefix - or netblock which customers bring to cloud. The IP prefix is a - single unit of route advertisement and is announced globally to - the internet. +class HttpRouteRule(proto.Message): + r"""An HttpRouteRule specifies how to match an HTTP request and + the corresponding routing action that load balancing proxies + will perform. Attributes: - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. description (str): - An optional description of this resource. - Provide this property when you create the - resource. - dns_verification_ip (str): - The IPv4 address to be used for reverse DNS - verification. - fingerprint (str): - Fingerprint of this resource. A hash of the - contents stored in this object. This field is - used in optimistic locking. This field will be - ignored when inserting a new - PublicAdvertisedPrefix. An up-to-date - fingerprint must be provided in order to update - the PublicAdvertisedPrefix, otherwise the - request will fail with error 412 - conditionNotMet. To see the latest fingerprint, - make a get() request to retrieve a - PublicAdvertisedPrefix. - id (int): - [Output Only] The unique identifier for the resource type. - The server generates this identifier. - ip_cidr_range (str): - The IPv4 address range, in CIDR format, - represented by this public advertised prefix. - kind (str): - [Output Only] Type of the resource. Always - compute#publicAdvertisedPrefix for public advertised - prefixes. - name (str): - Name of the resource. Provided by the client when the - resource is created. The name must be 1-63 characters long, - and comply with RFC1035. Specifically, the name must be 1-63 - characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. - public_delegated_prefixs (Sequence[google.cloud.compute_v1.types.PublicAdvertisedPrefixPublicDelegatedPrefix]): - [Output Only] The list of public delegated prefixes that - exist for this public advertised prefix. - self_link (str): - [Output Only] Server-defined URL for the resource. - shared_secret (str): - [Output Only] The shared secret to be used for reverse DNS - verification. - status (google.cloud.compute_v1.types.PublicAdvertisedPrefix.Status): - The status of the public advertised prefix. + The short description conveying the intent of + this routeRule. The description can have a + maximum length of 1024 characters. + header_action (google.cloud.compute_v1.types.HttpHeaderAction): + Specifies changes to request and response headers that need + to take effect for the selected backendService. The + headerAction specified here are applied before the matching + pathMatchers[].headerAction and after + pathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction + Note that headerAction is not supported for Loadbalancers + that have their loadBalancingScheme set to EXTERNAL. Not + supported when the URL map is bound to target gRPC proxy + that has validateForProxyless field set to true. + match_rules (Sequence[google.cloud.compute_v1.types.HttpRouteRuleMatch]): + The list of criteria for matching attributes + of a request to this routeRule. This list has OR + semantics: the request matches this routeRule + when any of the matchRules are satisfied. + However predicates within a given matchRule have + AND semantics. All predicates within a matchRule + must match for the request to match the rule. + priority (int): + For routeRules within a given pathMatcher, + priority determines the order in which load + balancer will interpret routeRules. RouteRules + are evaluated in order of priority, from the + lowest to highest number. The priority of a rule + decreases as its number increases (1, 2, 3, + N+1). The first rule that matches the request is + applied. You cannot configure two or more + routeRules with the same priority. Priority for + each rule must be set to a number between 0 and + 2147483647 inclusive. Priority numbers can have + gaps, which enable you to add or remove rules in + the future without affecting the rest of the + rules. For example, 1, 2, 3, 4, 5, 9, 12, 16 is + a valid series of priority numbers to which you + could add rules numbered from 6 to 8, 10 to 11, + and 13 to 15 in the future without any impact on + existing rules. + route_action (google.cloud.compute_v1.types.HttpRouteAction): + In response to a matching matchRule, the load + balancer performs advanced routing actions like + URL rewrites, header transformations, etc. prior + to forwarding the request to the selected + backend. If routeAction specifies any + weightedBackendServices, service must not be + set. Conversely if service is set, routeAction + cannot contain any weightedBackendServices. Only + one of urlRedirect, service or + routeAction.weightedBackendService must be set. + UrlMaps for external HTTP(S) load balancers + support only the urlRewrite action within a + routeRule's routeAction. + service (str): + The full or partial URL of the backend + service resource to which traffic is directed if + this rule is matched. If routeAction is + additionally specified, advanced routing actions + like URL Rewrites, etc. take effect prior to + sending the request to the backend. However, if + service is specified, routeAction cannot contain + any weightedBackendService s. Conversely, if + routeAction specifies any + weightedBackendServices, service must not be + specified. Only one of urlRedirect, service or + routeAction.weightedBackendService must be set. + url_redirect (google.cloud.compute_v1.types.HttpRedirectAction): + When this rule is matched, the request is + redirected to a URL specified by urlRedirect. If + urlRedirect is specified, service or routeAction + must not be set. Not supported when the URL map + is bound to target gRPC proxy. """ - class Status(proto.Enum): - r"""The status of the public advertised prefix.""" - UNDEFINED_STATUS = 0 - INITIAL = 518841124 - PREFIX_CONFIGURATION_COMPLETE = 480889551 - PREFIX_CONFIGURATION_IN_PROGRESS = 378550961 - PREFIX_REMOVAL_IN_PROGRESS = 284375783 - PTR_CONFIGURED = 513497167 - REVERSE_DNS_LOOKUP_FAILED = 295755183 - VALIDATED = 66197998 - - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) description = proto.Field(proto.STRING, number=422937596, optional=True,) - dns_verification_ip = proto.Field(proto.STRING, number=241011381, optional=True,) - fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - ip_cidr_range = proto.Field(proto.STRING, number=98117322, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - public_delegated_prefixs = proto.RepeatedField( - proto.MESSAGE, - number=425811723, - message="PublicAdvertisedPrefixPublicDelegatedPrefix", + header_action = proto.Field( + proto.MESSAGE, number=328077352, optional=True, message="HttpHeaderAction", ) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - shared_secret = proto.Field(proto.STRING, number=381932490, optional=True,) - status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) - - -class PublicAdvertisedPrefixList(proto.Message): - r""" - Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.PublicAdvertisedPrefix]): - A list of PublicAdvertisedPrefix resources. - kind (str): - [Output Only] Type of the resource. Always - compute#publicAdvertisedPrefix for public advertised - prefixes. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. - """ - - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="PublicAdvertisedPrefix", + match_rules = proto.RepeatedField( + proto.MESSAGE, number=376200701, message="HttpRouteRuleMatch", ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + priority = proto.Field(proto.INT32, number=445151652, optional=True,) + route_action = proto.Field( + proto.MESSAGE, number=424563948, optional=True, message="HttpRouteAction", + ) + service = proto.Field(proto.STRING, number=373540533, optional=True,) + url_redirect = proto.Field( + proto.MESSAGE, number=405147820, optional=True, message="HttpRedirectAction", ) -class PublicDelegatedPrefixPublicDelegatedSubPrefix(proto.Message): - r"""Represents a sub PublicDelegatedPrefix. +class HttpRouteRuleMatch(proto.Message): + r"""HttpRouteRuleMatch specifies a set of criteria for matching + requests to an HttpRouteRule. All specified criteria must be + satisfied for a match to occur. + Attributes: - delegatee_project (str): - Name of the project scoping this - PublicDelegatedSubPrefix. - description (str): - An optional description of this resource. - Provide this property when you create the - resource. - ip_cidr_range (str): - The IPv4 address range, in CIDR format, - represented by this sub public delegated prefix. - is_address (bool): - Whether the sub prefix is delegated to create - Address resources in the delegatee project. - name (str): - The name of the sub public delegated prefix. - region (str): - [Output Only] The region of the sub public delegated prefix - if it is regional. If absent, the sub prefix is global. - status (google.cloud.compute_v1.types.PublicDelegatedPrefixPublicDelegatedSubPrefix.Status): - [Output Only] The status of the sub public delegated prefix. + full_path_match (str): + For satisfying the matchRule condition, the + path of the request must exactly match the value + specified in fullPathMatch after removing any + query parameters and anchor that may be part of + the original URL. fullPathMatch must be between + 1 and 1024 characters. Only one of prefixMatch, + fullPathMatch or regexMatch must be specified. + header_matches (Sequence[google.cloud.compute_v1.types.HttpHeaderMatch]): + Specifies a list of header match criteria, + all of which must match corresponding headers in + the request. + ignore_case (bool): + Specifies that prefixMatch and fullPathMatch + matches are case sensitive. The default value is + false. ignoreCase must not be used with + regexMatch. Not supported when the URL map is + bound to target gRPC proxy. + metadata_filters (Sequence[google.cloud.compute_v1.types.MetadataFilter]): + Opaque filter criteria used by Loadbalancer to restrict + routing configuration to a limited set of xDS compliant + clients. In their xDS requests to Loadbalancer, xDS clients + present node metadata. When there is a match, the relevant + routing configuration is made available to those proxies. + For each metadataFilter in this list, if its + filterMatchCriteria is set to MATCH_ANY, at least one of the + filterLabels must match the corresponding label provided in + the metadata. If its filterMatchCriteria is set to + MATCH_ALL, then all of its filterLabels must match with + corresponding labels provided in the metadata. If multiple + metadataFilters are specified, all of them need to be + satisfied in order to be considered a match. metadataFilters + specified here will be applied after those specified in + ForwardingRule that refers to the UrlMap this + HttpRouteRuleMatch belongs to. metadataFilters only applies + to Loadbalancers that have their loadBalancingScheme set to + INTERNAL_SELF_MANAGED. Not supported when the URL map is + bound to target gRPC proxy that has validateForProxyless + field set to true. + prefix_match (str): + For satisfying the matchRule condition, the + request's path must begin with the specified + prefixMatch. prefixMatch must begin with a /. + The value must be between 1 and 1024 characters. + Only one of prefixMatch, fullPathMatch or + regexMatch must be specified. + query_parameter_matches (Sequence[google.cloud.compute_v1.types.HttpQueryParameterMatch]): + Specifies a list of query parameter match + criteria, all of which must match corresponding + query parameters in the request. Not supported + when the URL map is bound to target gRPC proxy. + regex_match (str): + For satisfying the matchRule condition, the path of the + request must satisfy the regular expression specified in + regexMatch after removing any query parameters and anchor + supplied with the original URL. For regular expression + grammar please see github.com/google/re2/wiki/Syntax Only + one of prefixMatch, fullPathMatch or regexMatch must be + specified. Note that regexMatch only applies to + Loadbalancers that have their loadBalancingScheme set to + INTERNAL_SELF_MANAGED. """ - class Status(proto.Enum): - r"""[Output Only] The status of the sub public delegated prefix.""" - UNDEFINED_STATUS = 0 - ACTIVE = 314733318 - INACTIVE = 270421099 - - delegatee_project = proto.Field(proto.STRING, number=414860634, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - ip_cidr_range = proto.Field(proto.STRING, number=98117322, optional=True,) - is_address = proto.Field(proto.BOOL, number=352617951, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - region = proto.Field(proto.STRING, number=138946292, optional=True,) - status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) + full_path_match = proto.Field(proto.STRING, number=214598875, optional=True,) + header_matches = proto.RepeatedField( + proto.MESSAGE, number=361903489, message="HttpHeaderMatch", + ) + ignore_case = proto.Field(proto.BOOL, number=464324989, optional=True,) + metadata_filters = proto.RepeatedField( + proto.MESSAGE, number=464725739, message="MetadataFilter", + ) + prefix_match = proto.Field(proto.STRING, number=257898968, optional=True,) + query_parameter_matches = proto.RepeatedField( + proto.MESSAGE, number=286231270, message="HttpQueryParameterMatch", + ) + regex_match = proto.Field(proto.STRING, number=107387853, optional=True,) -class PublicDelegatedPrefix(proto.Message): - r"""A PublicDelegatedPrefix resource represents an IP block - within a PublicAdvertisedPrefix that is configured within a - single cloud scope (global or region). IPs in the block can be - allocated to resources within that scope. Public delegated - prefixes may be further broken up into smaller IP blocks in the - same scope as the parent block. +class Image(proto.Message): + r"""Represents an Image resource. You can use images to create + boot disks for your VM instances. For more information, read + Images. Attributes: + archive_size_bytes (int): + Size of the image tar.gz archive stored in + Google Cloud Storage (in bytes). creation_timestamp (str): [Output Only] Creation timestamp in RFC3339 text format. + deprecated (google.cloud.compute_v1.types.DeprecationStatus): + The deprecation status associated with this + image. description (str): An optional description of this resource. Provide this property when you create the resource. - fingerprint (str): - Fingerprint of this resource. A hash of the - contents stored in this object. This field is - used in optimistic locking. This field will be - ignored when inserting a new - PublicDelegatedPrefix. An up-to-date fingerprint - must be provided in order to update the - PublicDelegatedPrefix, otherwise the request - will fail with error 412 conditionNotMet. To - see the latest fingerprint, make a get() request - to retrieve a PublicDelegatedPrefix. + disk_size_gb (int): + Size of the image when restored onto a + persistent disk (in GB). + family (str): + The name of the image family to which this + image belongs. You can create disks by + specifying an image family instead of a specific + image name. The image family always returns its + latest image that is not deprecated. The name of + the image family must comply with RFC1035. + guest_os_features (Sequence[google.cloud.compute_v1.types.GuestOsFeature]): + A list of features to enable on the guest + operating system. Applicable only for bootable + images. Read Enabling guest operating system + features to see a list of available options. id (int): - [Output Only] The unique identifier for the resource type. - The server generates this identifier. - ip_cidr_range (str): - The IPv4 address range, in CIDR format, - represented by this public delegated prefix. - is_live_migration (bool): - If true, the prefix will be live migrated. + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + image_encryption_key (google.cloud.compute_v1.types.CustomerEncryptionKey): + Encrypts the image using a customer-supplied + encryption key. After you encrypt an image with + a customer-supplied key, you must provide the + same key if you use the image later (e.g. to + create a disk from the image). Customer-supplied + encryption keys do not protect access to + metadata of the disk. If you do not provide an + encryption key when creating the image, then the + disk will be encrypted using an automatically + generated key and you do not need to provide a + key to use the image later. kind (str): - [Output Only] Type of the resource. Always - compute#publicDelegatedPrefix for public delegated prefixes. + [Output Only] Type of the resource. Always compute#image for + images. + label_fingerprint (str): + A fingerprint for the labels being applied to + this image, which is essentially a hash of the + labels used for optimistic locking. The + fingerprint is initially generated by Compute + Engine and changes after every request to modify + or update labels. You must always provide an up- + to-date fingerprint hash in order to update or + change labels, otherwise the request will fail + with error 412 conditionNotMet. To see the + latest fingerprint, make a get() request to + retrieve an image. + labels (Sequence[google.cloud.compute_v1.types.Image.LabelsEntry]): + Labels to apply to this image. These can be + later modified by the setLabels method. + license_codes (Sequence[int]): + Integer license codes indicating which + licenses are attached to this image. + licenses (Sequence[str]): + Any applicable license URI. name (str): - Name of the resource. Provided by the client when the + Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression @@ -18483,82 +17764,182 @@ class PublicDelegatedPrefix(proto.Message): character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. - parent_prefix (str): - The URL of parent prefix. Either - PublicAdvertisedPrefix or PublicDelegatedPrefix. - public_delegated_sub_prefixs (Sequence[google.cloud.compute_v1.types.PublicDelegatedPrefixPublicDelegatedSubPrefix]): - The list of sub public delegated prefixes - that exist for this public delegated prefix. - region (str): - [Output Only] URL of the region where the public delegated - prefix resides. This field applies only to the region - resource. You must specify this field as part of the HTTP - request URL. It is not settable as a field in the request - body. + raw_disk (google.cloud.compute_v1.types.RawDisk): + The parameters of the raw disk image. + satisfies_pzs (bool): + [Output Only] Reserved for future use. self_link (str): [Output Only] Server-defined URL for the resource. - status (google.cloud.compute_v1.types.PublicDelegatedPrefix.Status): - [Output Only] The status of the public delegated prefix. + shielded_instance_initial_state (google.cloud.compute_v1.types.InitialStateConfig): + Set the secure boot keys of shielded + instance. + source_disk (str): + URL of the source disk used to create this + image. For example, the following are valid + values: - + https://www.googleapis.com/compute/v1/projects/project/zones/zone + /disks/disk - + projects/project/zones/zone/disks/disk - + zones/zone/disks/disk In order to create an + image, you must provide the full or partial URL + of one of the following: - The rawDisk.source + URL - The sourceDisk URL - The sourceImage URL - + The sourceSnapshot URL + source_disk_encryption_key (google.cloud.compute_v1.types.CustomerEncryptionKey): + The customer-supplied encryption key of the + source disk. Required if the source disk is + protected by a customer-supplied encryption key. + source_disk_id (str): + [Output Only] The ID value of the disk used to create this + image. This value may be used to determine whether the image + was taken from the current or a previous instance of a given + disk name. + source_image (str): + URL of the source image used to create this image. The + following are valid formats for the URL: - + https://www.googleapis.com/compute/v1/projects/project_id/global/ + images/image_name - + projects/project_id/global/images/image_name In order to + create an image, you must provide the full or partial URL of + one of the following: - The rawDisk.source URL - The + sourceDisk URL - The sourceImage URL - The sourceSnapshot + URL + source_image_encryption_key (google.cloud.compute_v1.types.CustomerEncryptionKey): + The customer-supplied encryption key of the + source image. Required if the source image is + protected by a customer-supplied encryption key. + source_image_id (str): + [Output Only] The ID value of the image used to create this + image. This value may be used to determine whether the image + was taken from the current or a previous instance of a given + image name. + source_snapshot (str): + URL of the source snapshot used to create this image. The + following are valid formats for the URL: - + https://www.googleapis.com/compute/v1/projects/project_id/global/ + snapshots/snapshot_name - + projects/project_id/global/snapshots/snapshot_name In order + to create an image, you must provide the full or partial URL + of one of the following: - The rawDisk.source URL - The + sourceDisk URL - The sourceImage URL - The sourceSnapshot + URL + source_snapshot_encryption_key (google.cloud.compute_v1.types.CustomerEncryptionKey): + The customer-supplied encryption key of the + source snapshot. Required if the source snapshot + is protected by a customer-supplied encryption + key. + source_snapshot_id (str): + [Output Only] The ID value of the snapshot used to create + this image. This value may be used to determine whether the + snapshot was taken from the current or a previous instance + of a given snapshot name. + source_type (google.cloud.compute_v1.types.Image.SourceType): + The type of the image used to create this + disk. The default and only value is RAW + status (google.cloud.compute_v1.types.Image.Status): + [Output Only] The status of the image. An image can be used + to create other resources, such as instances, only after the + image has been successfully created and the status is set to + READY. Possible values are FAILED, PENDING, or READY. + storage_locations (Sequence[str]): + Cloud Storage bucket storage location of the + image (regional or multi-regional). """ + class SourceType(proto.Enum): + r"""The type of the image used to create this disk. The default + and only value is RAW + """ + UNDEFINED_SOURCE_TYPE = 0 + RAW = 80904 + class Status(proto.Enum): - r"""[Output Only] The status of the public delegated prefix.""" + r"""[Output Only] The status of the image. An image can be used to + create other resources, such as instances, only after the image has + been successfully created and the status is set to READY. Possible + values are FAILED, PENDING, or READY. + """ UNDEFINED_STATUS = 0 - ANNOUNCED = 365103355 DELETING = 528602024 - INITIALIZING = 306588749 + FAILED = 455706685 + PENDING = 35394935 + READY = 77848963 + archive_size_bytes = proto.Field(proto.INT64, number=381093450, optional=True,) creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + deprecated = proto.Field( + proto.MESSAGE, number=515138995, optional=True, message="DeprecationStatus", + ) description = proto.Field(proto.STRING, number=422937596, optional=True,) - fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) + disk_size_gb = proto.Field(proto.INT64, number=316263735, optional=True,) + family = proto.Field(proto.STRING, number=328751972, optional=True,) + guest_os_features = proto.RepeatedField( + proto.MESSAGE, number=79294545, message="GuestOsFeature", + ) id = proto.Field(proto.UINT64, number=3355, optional=True,) - ip_cidr_range = proto.Field(proto.STRING, number=98117322, optional=True,) - is_live_migration = proto.Field(proto.BOOL, number=511823856, optional=True,) + image_encryption_key = proto.Field( + proto.MESSAGE, number=379512583, optional=True, message="CustomerEncryptionKey", + ) kind = proto.Field(proto.STRING, number=3292052, optional=True,) + label_fingerprint = proto.Field(proto.STRING, number=178124825, optional=True,) + labels = proto.MapField(proto.STRING, proto.STRING, number=500195327,) + license_codes = proto.RepeatedField(proto.INT64, number=45482664,) + licenses = proto.RepeatedField(proto.STRING, number=337642578,) name = proto.Field(proto.STRING, number=3373707, optional=True,) - parent_prefix = proto.Field(proto.STRING, number=15233991, optional=True,) - public_delegated_sub_prefixs = proto.RepeatedField( - proto.MESSAGE, - number=188940044, - message="PublicDelegatedPrefixPublicDelegatedSubPrefix", + raw_disk = proto.Field( + proto.MESSAGE, number=503113556, optional=True, message="RawDisk", ) - region = proto.Field(proto.STRING, number=138946292, optional=True,) + satisfies_pzs = proto.Field(proto.BOOL, number=480964267, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + shielded_instance_initial_state = proto.Field( + proto.MESSAGE, number=192356867, optional=True, message="InitialStateConfig", + ) + source_disk = proto.Field(proto.STRING, number=451753793, optional=True,) + source_disk_encryption_key = proto.Field( + proto.MESSAGE, number=531501153, optional=True, message="CustomerEncryptionKey", + ) + source_disk_id = proto.Field(proto.STRING, number=454190809, optional=True,) + source_image = proto.Field(proto.STRING, number=50443319, optional=True,) + source_image_encryption_key = proto.Field( + proto.MESSAGE, number=381503659, optional=True, message="CustomerEncryptionKey", + ) + source_image_id = proto.Field(proto.STRING, number=55328291, optional=True,) + source_snapshot = proto.Field(proto.STRING, number=126061928, optional=True,) + source_snapshot_encryption_key = proto.Field( + proto.MESSAGE, number=303679322, optional=True, message="CustomerEncryptionKey", + ) + source_snapshot_id = proto.Field(proto.STRING, number=98962258, optional=True,) + source_type = proto.Field( + proto.ENUM, number=452245726, optional=True, enum=SourceType, + ) status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) + storage_locations = proto.RepeatedField(proto.STRING, number=328005274,) -class PublicDelegatedPrefixesScopedList(proto.Message): +class ImageFamilyView(proto.Message): r""" Attributes: - public_delegated_prefixes (Sequence[google.cloud.compute_v1.types.PublicDelegatedPrefix]): - [Output Only] A list of PublicDelegatedPrefixes contained in - this scope. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning which replaces the list - of public delegated prefixes when the list is empty. + image (google.cloud.compute_v1.types.Image): + The latest image that is part of the + specified image family in the requested + location, and that is not deprecated. """ - public_delegated_prefixes = proto.RepeatedField( - proto.MESSAGE, number=315261206, message="PublicDelegatedPrefix", - ) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + image = proto.Field( + proto.MESSAGE, number=100313435, optional=True, message="Image", ) -class PublicDelegatedPrefixAggregatedList(proto.Message): - r""" +class ImageList(proto.Message): + r"""Contains a list of images. Attributes: id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.PublicDelegatedPrefixAggregatedList.ItemsEntry]): - A list of PublicDelegatedPrefixesScopedList - resources. + items (Sequence[google.cloud.compute_v1.types.Image]): + A list of Image resources. kind (str): - [Output Only] Type of the resource. Always - compute#publicDelegatedPrefixAggregatedList for aggregated - lists of public delegated prefixes. + Type of resource. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -18568,8 +17949,6 @@ class PublicDelegatedPrefixAggregatedList(proto.Message): to continue paging through the results. self_link (str): [Output Only] Server-defined URL for this resource. - unreachables (Sequence[str]): - [Output Only] Unreachable resources. warning (google.cloud.compute_v1.types.Warning): [Output Only] Informational warning message. """ @@ -18579,2218 +17958,2536 @@ def raw_page(self): return self id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.MapField( - proto.STRING, - proto.MESSAGE, - number=100526016, - message="PublicDelegatedPrefixesScopedList", - ) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Image",) kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - unreachables = proto.RepeatedField(proto.STRING, number=243372063,) warning = proto.Field( proto.MESSAGE, number=50704284, optional=True, message="Warning", ) -class PublicDelegatedPrefixList(proto.Message): - r""" +class InitialStateConfig(proto.Message): + r"""Initial State for shielded instance, these are public keys + which are safe to store in public + Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.PublicDelegatedPrefix]): - A list of PublicDelegatedPrefix resources. - kind (str): - [Output Only] Type of the resource. Always - compute#publicDelegatedPrefixList for public delegated - prefixes. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + dbs (Sequence[google.cloud.compute_v1.types.FileContentBuffer]): + The Key Database (db). + dbxs (Sequence[google.cloud.compute_v1.types.FileContentBuffer]): + The forbidden key database (dbx). + keks (Sequence[google.cloud.compute_v1.types.FileContentBuffer]): + The Key Exchange Key (KEK). + pk (google.cloud.compute_v1.types.FileContentBuffer): + The Platform Key (PK). """ - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="PublicDelegatedPrefix", + dbs = proto.RepeatedField(proto.MESSAGE, number=99253, message="FileContentBuffer",) + dbxs = proto.RepeatedField( + proto.MESSAGE, number=3077113, message="FileContentBuffer", ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + keks = proto.RepeatedField( + proto.MESSAGE, number=3288130, message="FileContentBuffer", + ) + pk = proto.Field( + proto.MESSAGE, number=3579, optional=True, message="FileContentBuffer", ) -class Region(proto.Message): - r"""Represents a Region resource. - - A region is a geographical area where a resource is located. For - more information, read Regions and Zones. (== resource_for - {$api_version}.regions ==) +class InsertAddressRequest(proto.Message): + r"""A request message for Addresses.Insert. See the method + description for details. Attributes: - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - deprecated (google.cloud.compute_v1.types.DeprecationStatus): - [Output Only] The deprecation status associated with this - region. - description (str): - [Output Only] Textual description of the resource. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - kind (str): - [Output Only] Type of the resource. Always compute#region - for regions. - name (str): - [Output Only] Name of the resource. - quotas (Sequence[google.cloud.compute_v1.types.Quota]): - [Output Only] Quotas assigned to this region. - self_link (str): - [Output Only] Server-defined URL for the resource. - status (google.cloud.compute_v1.types.Region.Status): - [Output Only] Status of the region, either UP or DOWN. - supports_pzs (bool): - [Output Only] Reserved for future use. - zones (Sequence[str]): - [Output Only] A list of zones available in this region, in - the form of resource URLs. + address_resource (google.cloud.compute_v1.types.Address): + The body resource for this request + project (str): + Project ID for this request. + region (str): + Name of the region for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - class Status(proto.Enum): - r"""[Output Only] Status of the region, either UP or DOWN.""" - UNDEFINED_STATUS = 0 - DOWN = 2104482 - UP = 2715 + address_resource = proto.Field(proto.MESSAGE, number=483888121, message="Address",) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - deprecated = proto.Field( - proto.MESSAGE, number=515138995, optional=True, message="DeprecationStatus", - ) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - quotas = proto.RepeatedField(proto.MESSAGE, number=125341947, message="Quota",) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) - supports_pzs = proto.Field(proto.BOOL, number=83983214, optional=True,) - zones = proto.RepeatedField(proto.STRING, number=116085319,) +class InsertAutoscalerRequest(proto.Message): + r"""A request message for Autoscalers.Insert. See the method + description for details. -class RegionAutoscalerList(proto.Message): - r"""Contains a list of autoscalers. Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.Autoscaler]): - A list of Autoscaler resources. - kind (str): - Type of resource. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + autoscaler_resource (google.cloud.compute_v1.types.Autoscaler): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + Name of the zone for this request. """ - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Autoscaler",) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + autoscaler_resource = proto.Field( + proto.MESSAGE, number=207616118, message="Autoscaler", ) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class RegionDiskTypeList(proto.Message): - r""" - Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.DiskType]): - A list of DiskType resources. - kind (str): - [Output Only] Type of resource. Always - compute#regionDiskTypeList for region disk types. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. - """ - - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="DiskType",) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) - +class InsertBackendBucketRequest(proto.Message): + r"""A request message for BackendBuckets.Insert. See the method + description for details. -class RegionDisksAddResourcePoliciesRequest(proto.Message): - r""" Attributes: - resource_policies (Sequence[str]): - Resource policies to be added to this disk. + backend_bucket_resource (google.cloud.compute_v1.types.BackendBucket): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - resource_policies = proto.RepeatedField(proto.STRING, number=22220385,) + backend_bucket_resource = proto.Field( + proto.MESSAGE, number=380757784, message="BackendBucket", + ) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class RegionDisksRemoveResourcePoliciesRequest(proto.Message): - r""" +class InsertBackendServiceRequest(proto.Message): + r"""A request message for BackendServices.Insert. See the method + description for details. + Attributes: - resource_policies (Sequence[str]): - Resource policies to be removed from this - disk. + backend_service_resource (google.cloud.compute_v1.types.BackendService): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - resource_policies = proto.RepeatedField(proto.STRING, number=22220385,) + backend_service_resource = proto.Field( + proto.MESSAGE, number=347586723, message="BackendService", + ) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class RegionDisksResizeRequest(proto.Message): - r""" +class InsertDiskRequest(proto.Message): + r"""A request message for Disks.Insert. See the method + description for details. + Attributes: - size_gb (int): - The new size of the regional persistent disk, - which is specified in GB. + disk_resource (google.cloud.compute_v1.types.Disk): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + source_image (str): + Source image to restore onto a disk. This + field is optional. + zone (str): + The name of the zone for this request. """ - size_gb = proto.Field(proto.INT64, number=494929369, optional=True,) + disk_resource = proto.Field(proto.MESSAGE, number=25880688, message="Disk",) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + source_image = proto.Field(proto.STRING, number=50443319, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class RegionInstanceGroupList(proto.Message): - r"""Contains a list of InstanceGroup resources. +class InsertExternalVpnGatewayRequest(proto.Message): + r"""A request message for ExternalVpnGateways.Insert. See the + method description for details. + Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.InstanceGroup]): - A list of InstanceGroup resources. - kind (str): - The resource type. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + external_vpn_gateway_resource (google.cloud.compute_v1.types.ExternalVpnGateway): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="InstanceGroup", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + external_vpn_gateway_resource = proto.Field( + proto.MESSAGE, number=486813576, message="ExternalVpnGateway", ) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class RegionInstanceGroupManagerDeleteInstanceConfigReq(proto.Message): - r"""RegionInstanceGroupManagers.deletePerInstanceConfigs +class InsertFirewallPolicyRequest(proto.Message): + r"""A request message for FirewallPolicies.Insert. See the method + description for details. + Attributes: - names (Sequence[str]): - The list of instance names for which we want - to delete per-instance configs on this managed - instance group. + firewall_policy_resource (google.cloud.compute_v1.types.FirewallPolicy): + The body resource for this request + parent_id (str): + Parent ID for this request. The ID can be either be + "folders/[FOLDER_ID]" if the parent is a folder or + "organizations/[ORGANIZATION_ID]" if the parent is an + organization. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - names = proto.RepeatedField(proto.STRING, number=104585032,) + firewall_policy_resource = proto.Field( + proto.MESSAGE, number=495049532, message="FirewallPolicy", + ) + parent_id = proto.Field(proto.STRING, number=459714768, optional=True,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class RegionInstanceGroupManagerList(proto.Message): - r"""Contains a list of managed instance groups. +class InsertFirewallRequest(proto.Message): + r"""A request message for Firewalls.Insert. See the method + description for details. + Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.InstanceGroupManager]): - A list of InstanceGroupManager resources. - kind (str): - [Output Only] The resource type, which is always - compute#instanceGroupManagerList for a list of managed - instance groups that exist in th regional scope. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + firewall_resource (google.cloud.compute_v1.types.Firewall): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - @property - def raw_page(self): - return self + firewall_resource = proto.Field(proto.MESSAGE, number=41425005, message="Firewall",) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="InstanceGroupManager", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) +class InsertForwardingRuleRequest(proto.Message): + r"""A request message for ForwardingRules.Insert. See the method + description for details. -class RegionInstanceGroupManagerPatchInstanceConfigReq(proto.Message): - r"""RegionInstanceGroupManagers.patchPerInstanceConfigs Attributes: - per_instance_configs (Sequence[google.cloud.compute_v1.types.PerInstanceConfig]): - The list of per-instance configs to insert or - patch on this managed instance group. + forwarding_rule_resource (google.cloud.compute_v1.types.ForwardingRule): + The body resource for this request + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - per_instance_configs = proto.RepeatedField( - proto.MESSAGE, number=526265001, message="PerInstanceConfig", + forwarding_rule_resource = proto.Field( + proto.MESSAGE, number=301211695, message="ForwardingRule", ) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class RegionInstanceGroupManagerUpdateInstanceConfigReq(proto.Message): - r"""RegionInstanceGroupManagers.updatePerInstanceConfigs +class InsertGlobalAddressRequest(proto.Message): + r"""A request message for GlobalAddresses.Insert. See the method + description for details. + Attributes: - per_instance_configs (Sequence[google.cloud.compute_v1.types.PerInstanceConfig]): - The list of per-instance configs to insert or - patch on this managed instance group. + address_resource (google.cloud.compute_v1.types.Address): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - per_instance_configs = proto.RepeatedField( - proto.MESSAGE, number=526265001, message="PerInstanceConfig", - ) + address_resource = proto.Field(proto.MESSAGE, number=483888121, message="Address",) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class RegionInstanceGroupManagersAbandonInstancesRequest(proto.Message): - r""" +class InsertGlobalForwardingRuleRequest(proto.Message): + r"""A request message for GlobalForwardingRules.Insert. See the + method description for details. + Attributes: - instances (Sequence[str]): - The URLs of one or more instances to abandon. This can be a - full URL or a partial URL, such as - zones/[ZONE]/instances/[INSTANCE_NAME]. + forwarding_rule_resource (google.cloud.compute_v1.types.ForwardingRule): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - instances = proto.RepeatedField(proto.STRING, number=29097598,) + forwarding_rule_resource = proto.Field( + proto.MESSAGE, number=301211695, message="ForwardingRule", + ) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class RegionInstanceGroupManagersApplyUpdatesRequest(proto.Message): - r"""RegionInstanceGroupManagers.applyUpdatesToInstances +class InsertGlobalNetworkEndpointGroupRequest(proto.Message): + r"""A request message for GlobalNetworkEndpointGroups.Insert. See + the method description for details. + Attributes: - all_instances (bool): - Flag to update all instances instead of - specified list of ?instances?. If the flag is - set to true then the instances may not be - specified in the request. - instances (Sequence[str]): - The list of URLs of one or more instances for which you want - to apply updates. Each URL can be a full URL or a partial - URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. - minimal_action (str): - The minimal action that you want to perform - on each instance during the update: - REPLACE: - At minimum, delete the instance and create it - again. - RESTART: Stop the instance and start it - again. - REFRESH: Do not stop the instance. - - NONE: Do not disrupt the instance at all. By - default, the minimum action is NONE. If your - update requires a more disruptive action than - you set with this flag, the necessary action is - performed to execute the update. - most_disruptive_allowed_action (str): - The most disruptive action that you want to - perform on each instance during the update: - - REPLACE: Delete the instance and create it - again. - RESTART: Stop the instance and start it - again. - REFRESH: Do not stop the instance. - - NONE: Do not disrupt the instance at all. By - default, the most disruptive allowed action is - REPLACE. If your update requires a more - disruptive action than you set with this flag, - the update request will fail. + network_endpoint_group_resource (google.cloud.compute_v1.types.NetworkEndpointGroup): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - all_instances = proto.Field(proto.BOOL, number=403676512, optional=True,) - instances = proto.RepeatedField(proto.STRING, number=29097598,) - minimal_action = proto.Field(proto.STRING, number=270567060, optional=True,) - most_disruptive_allowed_action = proto.Field( - proto.STRING, number=66103053, optional=True, + network_endpoint_group_resource = proto.Field( + proto.MESSAGE, number=525788839, message="NetworkEndpointGroup", ) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class RegionInstanceGroupManagersCreateInstancesRequest(proto.Message): - r"""RegionInstanceGroupManagers.createInstances +class InsertGlobalPublicDelegatedPrefixeRequest(proto.Message): + r"""A request message for GlobalPublicDelegatedPrefixes.Insert. + See the method description for details. + Attributes: - instances (Sequence[google.cloud.compute_v1.types.PerInstanceConfig]): - [Required] List of specifications of per-instance configs. + project (str): + Project ID for this request. + public_delegated_prefix_resource (google.cloud.compute_v1.types.PublicDelegatedPrefix): + The body resource for this request + request_id (str): + An optional request ID to identify requests. Specify a + unique request ID so that if you must retry your request, + the server will know to ignore the request if it has already + been completed. For example, consider a situation where you + make an initial request and the request times out. If you + make the request again with the same request ID, the server + can check if original operation with the same request ID was + received, and if so, will ignore the second request. This + prevents clients from accidentally creating duplicate + commitments. The request ID must be a valid UUID with the + exception that zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). end_interface: + MixerMutationRequestBuilder """ - instances = proto.RepeatedField( - proto.MESSAGE, number=29097598, message="PerInstanceConfig", + project = proto.Field(proto.STRING, number=227560217,) + public_delegated_prefix_resource = proto.Field( + proto.MESSAGE, number=47594501, message="PublicDelegatedPrefix", ) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class RegionInstanceGroupManagersDeleteInstancesRequest(proto.Message): - r""" +class InsertHealthCheckRequest(proto.Message): + r"""A request message for HealthChecks.Insert. See the method + description for details. + Attributes: - instances (Sequence[str]): - The URLs of one or more instances to delete. This can be a - full URL or a partial URL, such as - zones/[ZONE]/instances/[INSTANCE_NAME]. + health_check_resource (google.cloud.compute_v1.types.HealthCheck): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - instances = proto.RepeatedField(proto.STRING, number=29097598,) + health_check_resource = proto.Field( + proto.MESSAGE, number=201925032, message="HealthCheck", + ) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class RegionInstanceGroupManagersListErrorsResponse(proto.Message): - r""" +class InsertImageRequest(proto.Message): + r"""A request message for Images.Insert. See the method + description for details. + Attributes: - items (Sequence[google.cloud.compute_v1.types.InstanceManagedByIgmError]): - [Output Only] The list of errors of the managed instance - group. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. + force_create (bool): + Force image creation if true. + image_resource (google.cloud.compute_v1.types.Image): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - @property - def raw_page(self): - return self + force_create = proto.Field(proto.BOOL, number=197723344, optional=True,) + image_resource = proto.Field(proto.MESSAGE, number=371171954, message="Image",) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="InstanceManagedByIgmError", - ) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) +class InsertInstanceGroupManagerRequest(proto.Message): + r"""A request message for InstanceGroupManagers.Insert. See the + method description for details. -class RegionInstanceGroupManagersListInstanceConfigsResp(proto.Message): - r""" Attributes: - items (Sequence[google.cloud.compute_v1.types.PerInstanceConfig]): - [Output Only] The list of PerInstanceConfig. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + instance_group_manager_resource (google.cloud.compute_v1.types.InstanceGroupManager): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone where you want to create + the managed instance group. """ - @property - def raw_page(self): - return self - - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="PerInstanceConfig", - ) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + instance_group_manager_resource = proto.Field( + proto.MESSAGE, number=261063946, message="InstanceGroupManager", ) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class RegionInstanceGroupManagersListInstancesResponse(proto.Message): - r""" +class InsertInstanceGroupRequest(proto.Message): + r"""A request message for InstanceGroups.Insert. See the method + description for details. + Attributes: - managed_instances (Sequence[google.cloud.compute_v1.types.ManagedInstance]): - A list of managed instances. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. + instance_group_resource (google.cloud.compute_v1.types.InstanceGroup): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone where you want to create + the instance group. """ - @property - def raw_page(self): - return self - - managed_instances = proto.RepeatedField( - proto.MESSAGE, number=336219614, message="ManagedInstance", + instance_group_resource = proto.Field( + proto.MESSAGE, number=286612152, message="InstanceGroup", ) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class RegionInstanceGroupManagersRecreateRequest(proto.Message): - r""" +class InsertInstanceRequest(proto.Message): + r"""A request message for Instances.Insert. See the method + description for details. + Attributes: - instances (Sequence[str]): - The URLs of one or more instances to recreate. This can be a - full URL or a partial URL, such as - zones/[ZONE]/instances/[INSTANCE_NAME]. + instance_resource (google.cloud.compute_v1.types.Instance): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + source_instance_template (str): + Specifies instance template to create the + instance. This field is optional. It can be a + full or partial URL. For example, the following + are all valid URLs to an instance template: - + https://www.googleapis.com/compute/v1/projects/project + /global/instanceTemplates/instanceTemplate - + projects/project/global/instanceTemplates/instanceTemplate + - global/instanceTemplates/instanceTemplate + zone (str): + The name of the zone for this request. """ - instances = proto.RepeatedField(proto.STRING, number=29097598,) + instance_resource = proto.Field( + proto.MESSAGE, number=215988344, message="Instance", + ) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + source_instance_template = proto.Field( + proto.STRING, number=332423616, optional=True, + ) + zone = proto.Field(proto.STRING, number=3744684,) -class RegionInstanceGroupManagersSetTargetPoolsRequest(proto.Message): - r""" +class InsertInstanceTemplateRequest(proto.Message): + r"""A request message for InstanceTemplates.Insert. See the + method description for details. + Attributes: - fingerprint (str): - Fingerprint of the target pools information, - which is a hash of the contents. This field is - used for optimistic locking when you update the - target pool entries. This field is optional. - target_pools (Sequence[str]): - The URL of all TargetPool resources to which - instances in the instanceGroup field are added. - The target pools automatically apply to all of - the instances in the managed instance group. + instance_template_resource (google.cloud.compute_v1.types.InstanceTemplate): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) - target_pools = proto.RepeatedField(proto.STRING, number=336072617,) + instance_template_resource = proto.Field( + proto.MESSAGE, number=10679561, message="InstanceTemplate", + ) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class RegionInstanceGroupManagersSetTemplateRequest(proto.Message): - r""" +class InsertInterconnectAttachmentRequest(proto.Message): + r"""A request message for InterconnectAttachments.Insert. See the + method description for details. + Attributes: - instance_template (str): - URL of the InstanceTemplate resource from - which all new instances will be created. + interconnect_attachment_resource (google.cloud.compute_v1.types.InterconnectAttachment): + The body resource for this request + project (str): + Project ID for this request. + region (str): + Name of the region for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + validate_only (bool): + If true, the request will not be committed. """ - instance_template = proto.Field(proto.STRING, number=309248228, optional=True,) + interconnect_attachment_resource = proto.Field( + proto.MESSAGE, number=212341369, message="InterconnectAttachment", + ) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + validate_only = proto.Field(proto.BOOL, number=242744629, optional=True,) -class RegionInstanceGroupsListInstances(proto.Message): - r""" +class InsertInterconnectRequest(proto.Message): + r"""A request message for Interconnects.Insert. See the method + description for details. + Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.InstanceWithNamedPorts]): - A list of InstanceWithNamedPorts resources. - kind (str): - The resource type. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + interconnect_resource (google.cloud.compute_v1.types.Interconnect): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="InstanceWithNamedPorts", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + interconnect_resource = proto.Field( + proto.MESSAGE, number=397611167, message="Interconnect", ) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class RegionInstanceGroupsListInstancesRequest(proto.Message): - r""" +class InsertLicenseRequest(proto.Message): + r"""A request message for Licenses.Insert. See the method + description for details. + Attributes: - instance_state (google.cloud.compute_v1.types.RegionInstanceGroupsListInstancesRequest.InstanceState): - Instances in which state should be returned. - Valid options are: 'ALL', 'RUNNING'. By default, - it lists all instances. - port_name (str): - Name of port user is interested in. It is - optional. If it is set, only information about - this ports will be returned. If it is not set, - all the named ports will be returned. Always - lists all instances. + license_resource (google.cloud.compute_v1.types.License): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - class InstanceState(proto.Enum): - r"""Instances in which state should be returned. Valid options - are: 'ALL', 'RUNNING'. By default, it lists all instances. - """ - UNDEFINED_INSTANCE_STATE = 0 - ALL = 64897 - RUNNING = 121282975 + license_resource = proto.Field(proto.MESSAGE, number=437955148, message="License",) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - instance_state = proto.Field( - proto.ENUM, number=92223591, optional=True, enum=InstanceState, - ) - port_name = proto.Field(proto.STRING, number=41534345, optional=True,) +class InsertNetworkEndpointGroupRequest(proto.Message): + r"""A request message for NetworkEndpointGroups.Insert. See the + method description for details. -class RegionInstanceGroupsSetNamedPortsRequest(proto.Message): - r""" Attributes: - fingerprint (str): - The fingerprint of the named ports - information for this instance group. Use this - optional property to prevent conflicts when - multiple users change the named ports settings - concurrently. Obtain the fingerprint with the - instanceGroups.get method. Then, include the - fingerprint in your request to ensure that you - do not overwrite changes that were applied from - another concurrent request. - named_ports (Sequence[google.cloud.compute_v1.types.NamedPort]): - The list of named ports to set for this - instance group. + network_endpoint_group_resource (google.cloud.compute_v1.types.NetworkEndpointGroup): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone where you want to create + the network endpoint group. It should comply + with RFC1035. """ - fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) - named_ports = proto.RepeatedField( - proto.MESSAGE, number=427598732, message="NamedPort", + network_endpoint_group_resource = proto.Field( + proto.MESSAGE, number=525788839, message="NetworkEndpointGroup", ) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class RegionList(proto.Message): - r"""Contains a list of region resources. +class InsertNetworkRequest(proto.Message): + r"""A request message for Networks.Insert. See the method + description for details. + Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.Region]): - A list of Region resources. - kind (str): - [Output Only] Type of resource. Always compute#regionList - for lists of regions. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + network_resource (google.cloud.compute_v1.types.Network): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - @property - def raw_page(self): - return self + network_resource = proto.Field(proto.MESSAGE, number=122105599, message="Network",) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Region",) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) +class InsertNodeGroupRequest(proto.Message): + r"""A request message for NodeGroups.Insert. See the method + description for details. -class RegionSetLabelsRequest(proto.Message): - r""" Attributes: - label_fingerprint (str): - The fingerprint of the previous set of labels - for this resource, used to detect conflicts. The - fingerprint is initially generated by Compute - Engine and changes after every request to modify - or update labels. You must always provide an up- - to-date fingerprint hash in order to update or - change labels. Make a get() request to the - resource to get the latest fingerprint. - labels (Sequence[google.cloud.compute_v1.types.RegionSetLabelsRequest.LabelsEntry]): - The labels to set for this resource. + initial_node_count (int): + Initial count of nodes in the node group. + node_group_resource (google.cloud.compute_v1.types.NodeGroup): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. """ - label_fingerprint = proto.Field(proto.STRING, number=178124825, optional=True,) - labels = proto.MapField(proto.STRING, proto.STRING, number=500195327,) + initial_node_count = proto.Field(proto.INT32, number=71951469,) + node_group_resource = proto.Field( + proto.MESSAGE, number=505321899, message="NodeGroup", + ) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class RegionSetPolicyRequest(proto.Message): - r""" +class InsertNodeTemplateRequest(proto.Message): + r"""A request message for NodeTemplates.Insert. See the method + description for details. + Attributes: - bindings (Sequence[google.cloud.compute_v1.types.Binding]): - Flatten Policy to create a backwacd - compatible wire-format. Deprecated. Use 'policy' - to specify bindings. - etag (str): - Flatten Policy to create a backward - compatible wire-format. Deprecated. Use 'policy' - to specify the etag. - policy (google.cloud.compute_v1.types.Policy): - REQUIRED: The complete policy to be applied - to the 'resource'. The size of the policy is - limited to a few 10s of KB. An empty policy is - in general a valid policy but certain services - (like Projects) might reject them. + node_template_resource (google.cloud.compute_v1.types.NodeTemplate): + The body resource for this request + project (str): + Project ID for this request. + region (str): + The name of the region for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - bindings = proto.RepeatedField(proto.MESSAGE, number=403251854, message="Binding",) - etag = proto.Field(proto.STRING, number=3123477, optional=True,) - policy = proto.Field( - proto.MESSAGE, number=91071794, optional=True, message="Policy", + node_template_resource = proto.Field( + proto.MESSAGE, number=127364406, message="NodeTemplate", ) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class RegionTargetHttpsProxiesSetSslCertificatesRequest(proto.Message): - r""" +class InsertPacketMirroringRequest(proto.Message): + r"""A request message for PacketMirrorings.Insert. See the method + description for details. + Attributes: - ssl_certificates (Sequence[str]): - New set of SslCertificate resources to - associate with this TargetHttpsProxy resource. - Currently exactly one SslCertificate resource - must be specified. + packet_mirroring_resource (google.cloud.compute_v1.types.PacketMirroring): + The body resource for this request + project (str): + Project ID for this request. + region (str): + Name of the region for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - ssl_certificates = proto.RepeatedField(proto.STRING, number=366006543,) - - -class UrlMap(proto.Message): - r"""Represents a URL Map resource. - - Google Compute Engine has two URL Map resources: - - - `Global `__ - \* - `Regional `__ + packet_mirroring_resource = proto.Field( + proto.MESSAGE, number=493501985, message="PacketMirroring", + ) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - A URL map resource is a component of certain types of GCP load - balancers and Traffic Director. - - urlMaps are used by external HTTP(S) load balancers and Traffic - Director. \* regionUrlMaps are used by internal HTTP(S) load - balancers. +class InsertPublicAdvertisedPrefixeRequest(proto.Message): + r"""A request message for PublicAdvertisedPrefixes.Insert. See + the method description for details. - For a list of supported URL map features by load balancer type, see - the Load balancing features: Routing and traffic management table. + Attributes: + project (str): + Project ID for this request. + public_advertised_prefix_resource (google.cloud.compute_v1.types.PublicAdvertisedPrefix): + The body resource for this request + request_id (str): + An optional request ID to identify requests. Specify a + unique request ID so that if you must retry your request, + the server will know to ignore the request if it has already + been completed. For example, consider a situation where you + make an initial request and the request times out. If you + make the request again with the same request ID, the server + can check if original operation with the same request ID was + received, and if so, will ignore the second request. This + prevents clients from accidentally creating duplicate + commitments. The request ID must be a valid UUID with the + exception that zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). end_interface: + MixerMutationRequestBuilder + """ - For a list of supported URL map features for Traffic Director, see - the Traffic Director features: Routing and traffic management table. + project = proto.Field(proto.STRING, number=227560217,) + public_advertised_prefix_resource = proto.Field( + proto.MESSAGE, number=233614223, message="PublicAdvertisedPrefix", + ) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - This resource defines mappings from host names and URL paths to - either a backend service or a backend bucket. - To use the global urlMaps resource, the backend service must have a - loadBalancingScheme of either EXTERNAL or INTERNAL_SELF_MANAGED. To - use the regionUrlMaps resource, the backend service must have a - loadBalancingScheme of INTERNAL_MANAGED. For more information, read - URL Map Concepts. +class InsertPublicDelegatedPrefixeRequest(proto.Message): + r"""A request message for PublicDelegatedPrefixes.Insert. See the + method description for details. Attributes: - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - default_route_action (google.cloud.compute_v1.types.HttpRouteAction): - defaultRouteAction takes effect when none of - the hostRules match. The load balancer performs - advanced routing actions like URL rewrites, - header transformations, etc. prior to forwarding - the request to the selected backend. If - defaultRouteAction specifies any - weightedBackendServices, defaultService must not - be set. Conversely if defaultService is set, - defaultRouteAction cannot contain any - weightedBackendServices. Only one of - defaultRouteAction or defaultUrlRedirect must be - set. UrlMaps for external HTTP(S) load balancers - support only the urlRewrite action within - defaultRouteAction. defaultRouteAction has no - effect when the URL map is bound to target gRPC - proxy that has validateForProxyless field set to - true. - default_service (str): - The full or partial URL of the defaultService - resource to which traffic is directed if none of - the hostRules match. If defaultRouteAction is - additionally specified, advanced routing actions - like URL Rewrites, etc. take effect prior to - sending the request to the backend. However, if - defaultService is specified, defaultRouteAction - cannot contain any weightedBackendServices. - Conversely, if routeAction specifies any - weightedBackendServices, service must not be - specified. Only one of defaultService, - defaultUrlRedirect or - defaultRouteAction.weightedBackendService must - be set. defaultService has no effect when the - URL map is bound to target gRPC proxy that has - validateForProxyless field set to true. - default_url_redirect (google.cloud.compute_v1.types.HttpRedirectAction): - When none of the specified hostRules match, - the request is redirected to a URL specified by - defaultUrlRedirect. If defaultUrlRedirect is - specified, defaultService or defaultRouteAction - must not be set. Not supported when the URL map - is bound to target gRPC proxy. - description (str): - An optional description of this resource. - Provide this property when you create the - resource. - fingerprint (str): - Fingerprint of this resource. A hash of the - contents stored in this object. This field is - used in optimistic locking. This field will be - ignored when inserting a UrlMap. An up-to-date - fingerprint must be provided in order to update - the UrlMap, otherwise the request will fail with - error 412 conditionNotMet. To see the latest - fingerprint, make a get() request to retrieve a - UrlMap. - header_action (google.cloud.compute_v1.types.HttpHeaderAction): - Specifies changes to request and response - headers that need to take effect for the - selected backendService. The headerAction - specified here take effect after headerAction - specified under pathMatcher. Note that - headerAction is not supported for Loadbalancers - that have their loadBalancingScheme set to - EXTERNAL. Not supported when the URL map is - bound to target gRPC proxy that has - validateForProxyless field set to true. - host_rules (Sequence[google.cloud.compute_v1.types.HostRule]): - The list of HostRules to use against the URL. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - kind (str): - [Output Only] Type of the resource. Always compute#urlMaps - for url maps. - name (str): - Name of the resource. Provided by the client when the - resource is created. The name must be 1-63 characters long, - and comply with RFC1035. Specifically, the name must be 1-63 - characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. - path_matchers (Sequence[google.cloud.compute_v1.types.PathMatcher]): - The list of named PathMatchers to use against - the URL. + project (str): + Project ID for this request. + public_delegated_prefix_resource (google.cloud.compute_v1.types.PublicDelegatedPrefix): + The body resource for this request region (str): - [Output Only] URL of the region where the regional URL map - resides. This field is not applicable to global URL maps. - You must specify this field as part of the HTTP request URL. - It is not settable as a field in the request body. - self_link (str): - [Output Only] Server-defined URL for the resource. - tests (Sequence[google.cloud.compute_v1.types.UrlMapTest]): - The list of expected URL mapping tests. - Request to update this UrlMap will succeed only - if all of the test cases pass. You can specify a - maximum of 100 tests per UrlMap. Not supported - when the URL map is bound to target gRPC proxy - that has validateForProxyless field set to true. + Name of the region of this request. + request_id (str): + An optional request ID to identify requests. Specify a + unique request ID so that if you must retry your request, + the server will know to ignore the request if it has already + been completed. For example, consider a situation where you + make an initial request and the request times out. If you + make the request again with the same request ID, the server + can check if original operation with the same request ID was + received, and if so, will ignore the second request. This + prevents clients from accidentally creating duplicate + commitments. The request ID must be a valid UUID with the + exception that zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). end_interface: + MixerMutationRequestBuilder """ - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - default_route_action = proto.Field( - proto.MESSAGE, number=378919466, optional=True, message="HttpRouteAction", - ) - default_service = proto.Field(proto.STRING, number=370242231, optional=True,) - default_url_redirect = proto.Field( - proto.MESSAGE, number=359503338, optional=True, message="HttpRedirectAction", - ) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) - header_action = proto.Field( - proto.MESSAGE, number=328077352, optional=True, message="HttpHeaderAction", - ) - host_rules = proto.RepeatedField( - proto.MESSAGE, number=311804832, message="HostRule", - ) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - path_matchers = proto.RepeatedField( - proto.MESSAGE, number=271664219, message="PathMatcher", + project = proto.Field(proto.STRING, number=227560217,) + public_delegated_prefix_resource = proto.Field( + proto.MESSAGE, number=47594501, message="PublicDelegatedPrefix", ) - region = proto.Field(proto.STRING, number=138946292, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - tests = proto.RepeatedField(proto.MESSAGE, number=110251553, message="UrlMapTest",) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class RegionUrlMapsValidateRequest(proto.Message): - r""" +class InsertRegionAutoscalerRequest(proto.Message): + r"""A request message for RegionAutoscalers.Insert. See the + method description for details. + Attributes: - resource (google.cloud.compute_v1.types.UrlMap): - Content of the UrlMap to be validated. + autoscaler_resource (google.cloud.compute_v1.types.Autoscaler): + The body resource for this request + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - resource = proto.Field( - proto.MESSAGE, number=195806222, optional=True, message="UrlMap", + autoscaler_resource = proto.Field( + proto.MESSAGE, number=207616118, message="Autoscaler", ) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class ReservationsScopedList(proto.Message): - r""" +class InsertRegionBackendServiceRequest(proto.Message): + r"""A request message for RegionBackendServices.Insert. See the + method description for details. + Attributes: - reservations (Sequence[google.cloud.compute_v1.types.Reservation]): - A list of reservations contained in this - scope. - warning (google.cloud.compute_v1.types.Warning): - Informational warning which replaces the list - of reservations when the list is empty. + backend_service_resource (google.cloud.compute_v1.types.BackendService): + The body resource for this request + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - reservations = proto.RepeatedField( - proto.MESSAGE, number=399717927, message="Reservation", - ) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + backend_service_resource = proto.Field( + proto.MESSAGE, number=347586723, message="BackendService", ) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class ReservationAggregatedList(proto.Message): - r"""Contains a list of reservations. +class InsertRegionCommitmentRequest(proto.Message): + r"""A request message for RegionCommitments.Insert. See the + method description for details. + Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.ReservationAggregatedList.ItemsEntry]): - A list of Allocation resources. - kind (str): - Type of resource. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - unreachables (Sequence[str]): - [Output Only] Unreachable resources. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + commitment_resource (google.cloud.compute_v1.types.Commitment): + The body resource for this request + project (str): + Project ID for this request. + region (str): + Name of the region for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.MapField( - proto.STRING, proto.MESSAGE, number=100526016, message="ReservationsScopedList", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - unreachables = proto.RepeatedField(proto.STRING, number=243372063,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + commitment_resource = proto.Field( + proto.MESSAGE, number=244240888, message="Commitment", ) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class ReservationList(proto.Message): - r""" +class InsertRegionDiskRequest(proto.Message): + r"""A request message for RegionDisks.Insert. See the method + description for details. + Attributes: - id (str): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - items (Sequence[google.cloud.compute_v1.types.Reservation]): - [Output Only] A list of Allocation resources. - kind (str): - [Output Only] Type of resource.Always - compute#reservationsList for listsof reservations - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + disk_resource (google.cloud.compute_v1.types.Disk): + The body resource for this request + project (str): + Project ID for this request. + region (str): + Name of the region for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + source_image (str): + Source image to restore onto a disk. This + field is optional. """ - @property - def raw_page(self): - return self + disk_resource = proto.Field(proto.MESSAGE, number=25880688, message="Disk",) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + source_image = proto.Field(proto.STRING, number=50443319, optional=True,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Reservation",) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) +class InsertRegionHealthCheckRequest(proto.Message): + r"""A request message for RegionHealthChecks.Insert. See the + method description for details. -class ReservationsResizeRequest(proto.Message): - r""" Attributes: - specific_sku_count (int): - Number of allocated resources can be resized - with minimum = 1 and maximum = 1000. + health_check_resource (google.cloud.compute_v1.types.HealthCheck): + The body resource for this request + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - specific_sku_count = proto.Field(proto.INT64, number=13890720, optional=True,) + health_check_resource = proto.Field( + proto.MESSAGE, number=201925032, message="HealthCheck", + ) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class ResourceGroupReference(proto.Message): - r""" +class InsertRegionHealthCheckServiceRequest(proto.Message): + r"""A request message for RegionHealthCheckServices.Insert. See + the method description for details. + Attributes: - group (str): - A URI referencing one of the instance groups - or network endpoint groups listed in the backend - service. + health_check_service_resource (google.cloud.compute_v1.types.HealthCheckService): + The body resource for this request + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - group = proto.Field(proto.STRING, number=98629247, optional=True,) - + health_check_service_resource = proto.Field( + proto.MESSAGE, number=477367794, message="HealthCheckService", + ) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class ResourcePolicy(proto.Message): - r"""Represents a Resource Policy resource. You can use resource policies - to schedule actions for some Compute Engine resources. For example, - you can use them to schedule persistent disk snapshots. - (== resource_for {$api_version}.resourcePolicies ==) +class InsertRegionInstanceGroupManagerRequest(proto.Message): + r"""A request message for RegionInstanceGroupManagers.Insert. See + the method description for details. Attributes: - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - description (str): - - group_placement_policy (google.cloud.compute_v1.types.ResourcePolicyGroupPlacementPolicy): - Resource policy for instances for placement - configuration. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - instance_schedule_policy (google.cloud.compute_v1.types.ResourcePolicyInstanceSchedulePolicy): - Resource policy for scheduling instance - operations. - kind (str): - [Output Only] Type of the resource. Always - compute#resource_policies for resource policies. - name (str): - The name of the resource, provided by the client when - initially creating the resource. The resource name must be - 1-63 characters long, and comply with RFC1035. Specifically, - the name must be 1-63 characters long and match the regular - expression ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the - first character must be a lowercase letter, and all - following characters must be a dash, lowercase letter, or - digit, except the last character, which cannot be a dash. + instance_group_manager_resource (google.cloud.compute_v1.types.InstanceGroupManager): + The body resource for this request + project (str): + Project ID for this request. region (str): - - resource_status (google.cloud.compute_v1.types.ResourcePolicyResourceStatus): - [Output Only] The system status of the resource policy. - self_link (str): - [Output Only] Server-defined fully-qualified URL for this - resource. - snapshot_schedule_policy (google.cloud.compute_v1.types.ResourcePolicySnapshotSchedulePolicy): - Resource policy for persistent disks for - creating snapshots. - status (google.cloud.compute_v1.types.ResourcePolicy.Status): - [Output Only] The status of resource policy creation. + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - class Status(proto.Enum): - r"""[Output Only] The status of resource policy creation.""" - UNDEFINED_STATUS = 0 - CREATING = 455564985 - DELETING = 528602024 - EXPIRED = 482489093 - INVALID = 530283991 - READY = 77848963 - - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - group_placement_policy = proto.Field( - proto.MESSAGE, - number=10931596, - optional=True, - message="ResourcePolicyGroupPlacementPolicy", - ) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - instance_schedule_policy = proto.Field( - proto.MESSAGE, - number=344877104, - optional=True, - message="ResourcePolicyInstanceSchedulePolicy", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - region = proto.Field(proto.STRING, number=138946292, optional=True,) - resource_status = proto.Field( - proto.MESSAGE, - number=249429315, - optional=True, - message="ResourcePolicyResourceStatus", - ) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - snapshot_schedule_policy = proto.Field( - proto.MESSAGE, - number=218131295, - optional=True, - message="ResourcePolicySnapshotSchedulePolicy", + instance_group_manager_resource = proto.Field( + proto.MESSAGE, number=261063946, message="InstanceGroupManager", ) - status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + +class InsertRegionNetworkEndpointGroupRequest(proto.Message): + r"""A request message for RegionNetworkEndpointGroups.Insert. See + the method description for details. -class ResourcePoliciesScopedList(proto.Message): - r""" Attributes: - resource_policies (Sequence[google.cloud.compute_v1.types.ResourcePolicy]): - A list of resourcePolicies contained in this - scope. - warning (google.cloud.compute_v1.types.Warning): - Informational warning which replaces the list - of resourcePolicies when the list is empty. + network_endpoint_group_resource (google.cloud.compute_v1.types.NetworkEndpointGroup): + The body resource for this request + project (str): + Project ID for this request. + region (str): + The name of the region where you want to + create the network endpoint group. It should + comply with RFC1035. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - resource_policies = proto.RepeatedField( - proto.MESSAGE, number=22220385, message="ResourcePolicy", - ) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + network_endpoint_group_resource = proto.Field( + proto.MESSAGE, number=525788839, message="NetworkEndpointGroup", ) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class ResourcePolicyGroupPlacementPolicy(proto.Message): - r"""A GroupPlacementPolicy specifies resource placement - configuration. It specifies the failure bucket separation as - well as network locality +class InsertRegionNotificationEndpointRequest(proto.Message): + r"""A request message for RegionNotificationEndpoints.Insert. See + the method description for details. Attributes: - availability_domain_count (int): - The number of availability domains instances - will be spread across. If two instances are in - different availability domain, they will not be - put in the same low latency network - collocation (google.cloud.compute_v1.types.ResourcePolicyGroupPlacementPolicy.Collocation): - Specifies network collocation - vm_count (int): - Number of vms in this placement group + notification_endpoint_resource (google.cloud.compute_v1.types.NotificationEndpoint): + The body resource for this request + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. Specify a + unique request ID so that if you must retry your request, + the server will know to ignore the request if it has already + been completed. For example, consider a situation where you + make an initial request and the request times out. If you + make the request again with the same request ID, the server + can check if original operation with the same request ID was + received, and if so, will ignore the second request. This + prevents clients from accidentally creating duplicate + commitments. The request ID must be a valid UUID with the + exception that zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). end_interface: + MixerMutationRequestBuilder """ - class Collocation(proto.Enum): - r"""Specifies network collocation""" - UNDEFINED_COLLOCATION = 0 - COLLOCATED = 103257554 - UNSPECIFIED_COLLOCATION = 464308205 - - availability_domain_count = proto.Field( - proto.INT32, number=12453432, optional=True, - ) - collocation = proto.Field( - proto.ENUM, number=511156533, optional=True, enum=Collocation, + notification_endpoint_resource = proto.Field( + proto.MESSAGE, number=338459940, message="NotificationEndpoint", ) - vm_count = proto.Field(proto.INT32, number=261463431, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class ResourcePolicyInstanceSchedulePolicy(proto.Message): - r"""An InstanceSchedulePolicy specifies when and how frequent - certain operations are performed on the instance. +class InsertRegionSslCertificateRequest(proto.Message): + r"""A request message for RegionSslCertificates.Insert. See the + method description for details. Attributes: - expiration_time (str): - The expiration time of the schedule. The - timestamp is an RFC3339 string. - start_time (str): - The start time of the schedule. The timestamp - is an RFC3339 string. - time_zone (str): - Specifies the time zone to be used in interpreting - Schedule.schedule. The value of this field must be a time - zone name from the tz database: - http://en.wikipedia.org/wiki/Tz_database. - vm_start_schedule (google.cloud.compute_v1.types.ResourcePolicyInstanceSchedulePolicySchedule): - Specifies the schedule for starting - instances. - vm_stop_schedule (google.cloud.compute_v1.types.ResourcePolicyInstanceSchedulePolicySchedule): - Specifies the schedule for stopping - instances. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. Specify a + unique request ID so that if you must retry your request, + the server will know to ignore the request if it has already + been completed. For example, consider a situation where you + make an initial request and the request times out. If you + make the request again with the same request ID, the server + can check if original operation with the same request ID was + received, and if so, will ignore the second request. This + prevents clients from accidentally creating duplicate + commitments. The request ID must be a valid UUID with the + exception that zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). end_interface: + MixerMutationRequestBuilder + ssl_certificate_resource (google.cloud.compute_v1.types.SslCertificate): + The body resource for this request """ - expiration_time = proto.Field(proto.STRING, number=230299229, optional=True,) - start_time = proto.Field(proto.STRING, number=37467274, optional=True,) - time_zone = proto.Field(proto.STRING, number=36848094, optional=True,) - vm_start_schedule = proto.Field( - proto.MESSAGE, - number=17762396, - optional=True, - message="ResourcePolicyInstanceSchedulePolicySchedule", - ) - vm_stop_schedule = proto.Field( - proto.MESSAGE, - number=426242732, - optional=True, - message="ResourcePolicyInstanceSchedulePolicySchedule", + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + ssl_certificate_resource = proto.Field( + proto.MESSAGE, number=180709897, message="SslCertificate", ) -class ResourcePolicyResourceStatus(proto.Message): - r"""Contains output only fields. Use this sub-message for all - output fields set on ResourcePolicy. The internal structure of - this "status" field should mimic the structure of ResourcePolicy - proto specification. +class InsertRegionTargetHttpProxyRequest(proto.Message): + r"""A request message for RegionTargetHttpProxies.Insert. See the + method description for details. Attributes: - instance_schedule_policy (google.cloud.compute_v1.types.ResourcePolicyResourceStatusInstanceSchedulePolicyStatus): - [Output Only] Specifies a set of output values reffering to - the instance_schedule_policy system status. This field - should have the same name as corresponding policy field. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_http_proxy_resource (google.cloud.compute_v1.types.TargetHttpProxy): + The body resource for this request """ - instance_schedule_policy = proto.Field( - proto.MESSAGE, - number=344877104, - optional=True, - message="ResourcePolicyResourceStatusInstanceSchedulePolicyStatus", + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_http_proxy_resource = proto.Field( + proto.MESSAGE, number=24696744, message="TargetHttpProxy", ) -class ResourcePolicySnapshotSchedulePolicy(proto.Message): - r"""A snapshot schedule policy specifies when and how frequently - snapshots are to be created for the target disk. Also specifies - how many and how long these scheduled snapshots should be - retained. +class InsertRegionTargetHttpsProxyRequest(proto.Message): + r"""A request message for RegionTargetHttpsProxies.Insert. See + the method description for details. Attributes: - retention_policy (google.cloud.compute_v1.types.ResourcePolicySnapshotSchedulePolicyRetentionPolicy): - Retention policy applied to snapshots created - by this resource policy. - schedule (google.cloud.compute_v1.types.ResourcePolicySnapshotSchedulePolicySchedule): - A Vm Maintenance Policy specifies what kind - of infrastructure maintenance we are allowed to - perform on this VM and when. Schedule that is - applied to disks covered by this policy. - snapshot_properties (google.cloud.compute_v1.types.ResourcePolicySnapshotSchedulePolicySnapshotProperties): - Properties with which snapshots are created - such as labels, encryption keys. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. Specify a + unique request ID so that if you must retry your request, + the server will know to ignore the request if it has already + been completed. For example, consider a situation where you + make an initial request and the request times out. If you + make the request again with the same request ID, the server + can check if original operation with the same request ID was + received, and if so, will ignore the second request. This + prevents clients from accidentally creating duplicate + commitments. The request ID must be a valid UUID with the + exception that zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). end_interface: + MixerMutationRequestBuilder + target_https_proxy_resource (google.cloud.compute_v1.types.TargetHttpsProxy): + The body resource for this request """ - retention_policy = proto.Field( - proto.MESSAGE, - number=68625779, - optional=True, - message="ResourcePolicySnapshotSchedulePolicyRetentionPolicy", - ) - schedule = proto.Field( - proto.MESSAGE, - number=375820951, - optional=True, - message="ResourcePolicySnapshotSchedulePolicySchedule", - ) - snapshot_properties = proto.Field( - proto.MESSAGE, - number=185371278, - optional=True, - message="ResourcePolicySnapshotSchedulePolicySnapshotProperties", + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_https_proxy_resource = proto.Field( + proto.MESSAGE, number=433657473, message="TargetHttpsProxy", ) -class ResourcePolicyAggregatedList(proto.Message): - r"""Contains a list of resourcePolicies. - Attributes: - etag (str): +class InsertRegionUrlMapRequest(proto.Message): + r"""A request message for RegionUrlMaps.Insert. See the method + description for details. - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.ResourcePolicyAggregatedList.ItemsEntry]): - A list of ResourcePolicy resources. - kind (str): - Type of resource. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - unreachables (Sequence[str]): - [Output Only] Unreachable resources. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + Attributes: + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + request_id (str): + begin_interface: MixerMutationRequestBuilder Request ID to + support idempotency. + url_map_resource (google.cloud.compute_v1.types.UrlMap): + The body resource for this request """ - @property - def raw_page(self): - return self + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + url_map_resource = proto.Field(proto.MESSAGE, number=168675425, message="UrlMap",) - etag = proto.Field(proto.STRING, number=3123477, optional=True,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.MapField( - proto.STRING, - proto.MESSAGE, - number=100526016, - message="ResourcePoliciesScopedList", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - unreachables = proto.RepeatedField(proto.STRING, number=243372063,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) +class InsertReservationRequest(proto.Message): + r"""A request message for Reservations.Insert. See the method + description for details. -class ResourcePolicyDailyCycle(proto.Message): - r"""Time window specified for daily operations. Attributes: - days_in_cycle (int): - Defines a schedule with units measured in - months. The value determines how many months - pass between the start of each cycle. - duration (str): - [Output only] A predetermined duration for the window, - automatically chosen to be the smallest possible in the - given scenario. - start_time (str): - Start time of the window. This must be in UTC - format that resolves to one of 00:00, 04:00, - 08:00, 12:00, 16:00, or 20:00. For example, both - 13:00-5 and 08:00 are valid. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + reservation_resource (google.cloud.compute_v1.types.Reservation): + The body resource for this request + zone (str): + Name of the zone for this request. """ - days_in_cycle = proto.Field(proto.INT32, number=369790004, optional=True,) - duration = proto.Field(proto.STRING, number=155471252, optional=True,) - start_time = proto.Field(proto.STRING, number=37467274, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + reservation_resource = proto.Field( + proto.MESSAGE, number=285030177, message="Reservation", + ) + zone = proto.Field(proto.STRING, number=3744684,) -class ResourcePolicyHourlyCycle(proto.Message): - r"""Time window specified for hourly operations. +class InsertResourcePolicyRequest(proto.Message): + r"""A request message for ResourcePolicies.Insert. See the method + description for details. + Attributes: - duration (str): - [Output only] Duration of the time window, automatically - chosen to be smallest possible in the given scenario. - hours_in_cycle (int): - Defines a schedule with units measured in - hours. The value determines how many hours pass - between the start of each cycle. - start_time (str): - Time within the window to start the operations. It must be - in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT. + project (str): + Project ID for this request. + region (str): + Name of the region for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + resource_policy_resource (google.cloud.compute_v1.types.ResourcePolicy): + The body resource for this request """ - duration = proto.Field(proto.STRING, number=155471252, optional=True,) - hours_in_cycle = proto.Field(proto.INT32, number=526763132, optional=True,) - start_time = proto.Field(proto.STRING, number=37467274, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + resource_policy_resource = proto.Field( + proto.MESSAGE, number=76826186, message="ResourcePolicy", + ) -class ResourcePolicyInstanceSchedulePolicySchedule(proto.Message): - r"""Schedule for an instance operation. +class InsertRouteRequest(proto.Message): + r"""A request message for Routes.Insert. See the method + description for details. + Attributes: - schedule (str): - Specifies the frequency for the operation, - using the unix-cron format. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + route_resource (google.cloud.compute_v1.types.Route): + The body resource for this request """ - schedule = proto.Field(proto.STRING, number=375820951, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + route_resource = proto.Field(proto.MESSAGE, number=225428804, message="Route",) -class ResourcePolicyList(proto.Message): - r""" - Attributes: - etag (str): +class InsertRouterRequest(proto.Message): + r"""A request message for Routers.Insert. See the method + description for details. - id (str): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - items (Sequence[google.cloud.compute_v1.types.ResourcePolicy]): - [Output Only] A list of ResourcePolicy resources. - kind (str): - [Output Only] Type of resource.Always - compute#resourcePoliciesList for listsof resourcePolicies - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + Attributes: + project (str): + Project ID for this request. + region (str): + Name of the region for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + router_resource (google.cloud.compute_v1.types.Router): + The body resource for this request """ - @property - def raw_page(self): - return self + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + router_resource = proto.Field(proto.MESSAGE, number=155222084, message="Router",) - etag = proto.Field(proto.STRING, number=3123477, optional=True,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="ResourcePolicy", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) +class InsertSecurityPolicyRequest(proto.Message): + r"""A request message for SecurityPolicies.Insert. See the method + description for details. -class ResourcePolicyResourceStatusInstanceSchedulePolicyStatus(proto.Message): - r""" Attributes: - last_run_start_time (str): - [Output Only] The last time the schedule successfully ran. - The timestamp is an RFC3339 string. - next_run_start_time (str): - [Output Only] The next time the schedule is planned to run. - The actual time might be slightly different. The timestamp - is an RFC3339 string. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + security_policy_resource (google.cloud.compute_v1.types.SecurityPolicy): + The body resource for this request """ - last_run_start_time = proto.Field(proto.STRING, number=303069063, optional=True,) - next_run_start_time = proto.Field(proto.STRING, number=318642570, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + security_policy_resource = proto.Field( + proto.MESSAGE, number=216159612, message="SecurityPolicy", + ) -class ResourcePolicySnapshotSchedulePolicyRetentionPolicy(proto.Message): - r"""Policy for retention of scheduled snapshots. +class InsertServiceAttachmentRequest(proto.Message): + r"""A request message for ServiceAttachments.Insert. See the + method description for details. + Attributes: - max_retention_days (int): - Maximum age of the snapshot that is allowed - to be kept. - on_source_disk_delete (google.cloud.compute_v1.types.ResourcePolicySnapshotSchedulePolicyRetentionPolicy.OnSourceDiskDelete): - Specifies the behavior to apply to scheduled - snapshots when the source disk is deleted. + project (str): + Project ID for this request. + region (str): + Name of the region of this request. + request_id (str): + An optional request ID to identify requests. Specify a + unique request ID so that if you must retry your request, + the server will know to ignore the request if it has already + been completed. For example, consider a situation where you + make an initial request and the request times out. If you + make the request again with the same request ID, the server + can check if original operation with the same request ID was + received, and if so, will ignore the second request. This + prevents clients from accidentally creating duplicate + commitments. The request ID must be a valid UUID with the + exception that zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). end_interface: + MixerMutationRequestBuilder + service_attachment_resource (google.cloud.compute_v1.types.ServiceAttachment): + The body resource for this request """ - - class OnSourceDiskDelete(proto.Enum): - r"""Specifies the behavior to apply to scheduled snapshots when - the source disk is deleted. - """ - UNDEFINED_ON_SOURCE_DISK_DELETE = 0 - APPLY_RETENTION_POLICY = 535071332 - KEEP_AUTO_SNAPSHOTS = 258925689 - UNSPECIFIED_ON_SOURCE_DISK_DELETE = 239140769 - - max_retention_days = proto.Field(proto.INT32, number=324296979, optional=True,) - on_source_disk_delete = proto.Field( - proto.ENUM, number=321955529, optional=True, enum=OnSourceDiskDelete, + + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + service_attachment_resource = proto.Field( + proto.MESSAGE, number=472980256, message="ServiceAttachment", ) -class ResourcePolicySnapshotSchedulePolicySchedule(proto.Message): - r"""A schedule for disks where the schedueled operations are - performed. +class InsertSslCertificateRequest(proto.Message): + r"""A request message for SslCertificates.Insert. See the method + description for details. Attributes: - daily_schedule (google.cloud.compute_v1.types.ResourcePolicyDailyCycle): + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. Specify a + unique request ID so that if you must retry your request, + the server will know to ignore the request if it has already + been completed. For example, consider a situation where you + make an initial request and the request times out. If you + make the request again with the same request ID, the server + can check if original operation with the same request ID was + received, and if so, will ignore the second request. This + prevents clients from accidentally creating duplicate + commitments. The request ID must be a valid UUID with the + exception that zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). end_interface: + MixerMutationRequestBuilder + ssl_certificate_resource (google.cloud.compute_v1.types.SslCertificate): + The body resource for this request + """ - hourly_schedule (google.cloud.compute_v1.types.ResourcePolicyHourlyCycle): + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + ssl_certificate_resource = proto.Field( + proto.MESSAGE, number=180709897, message="SslCertificate", + ) - weekly_schedule (google.cloud.compute_v1.types.ResourcePolicyWeeklyCycle): +class InsertSslPolicyRequest(proto.Message): + r"""A request message for SslPolicies.Insert. See the method + description for details. + + Attributes: + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + ssl_policy_resource (google.cloud.compute_v1.types.SslPolicy): + The body resource for this request """ - daily_schedule = proto.Field( - proto.MESSAGE, - number=86159869, - optional=True, - message="ResourcePolicyDailyCycle", - ) - hourly_schedule = proto.Field( - proto.MESSAGE, - number=38328485, - optional=True, - message="ResourcePolicyHourlyCycle", - ) - weekly_schedule = proto.Field( - proto.MESSAGE, - number=359548053, - optional=True, - message="ResourcePolicyWeeklyCycle", + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + ssl_policy_resource = proto.Field( + proto.MESSAGE, number=274891848, message="SslPolicy", ) -class ResourcePolicySnapshotSchedulePolicySnapshotProperties(proto.Message): - r"""Specified snapshot properties for scheduled snapshots created - by this policy. +class InsertSubnetworkRequest(proto.Message): + r"""A request message for Subnetworks.Insert. See the method + description for details. Attributes: - chain_name (str): - Chain name that the snapshot is created in. - guest_flush (bool): - Indication to perform a 'guest aware' - snapshot. - labels (Sequence[google.cloud.compute_v1.types.ResourcePolicySnapshotSchedulePolicySnapshotProperties.LabelsEntry]): - Labels to apply to scheduled snapshots. These - can be later modified by the setLabels method. - Label values may be empty. - storage_locations (Sequence[str]): - Cloud Storage bucket storage location of the - auto snapshot (regional or multi-regional). + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + subnetwork_resource (google.cloud.compute_v1.types.Subnetwork): + The body resource for this request """ - chain_name = proto.Field(proto.STRING, number=68644169, optional=True,) - guest_flush = proto.Field(proto.BOOL, number=385550813, optional=True,) - labels = proto.MapField(proto.STRING, proto.STRING, number=500195327,) - storage_locations = proto.RepeatedField(proto.STRING, number=328005274,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + subnetwork_resource = proto.Field( + proto.MESSAGE, number=42233151, message="Subnetwork", + ) -class ResourcePolicyWeeklyCycle(proto.Message): - r"""Time window specified for weekly operations. +class InsertTargetGrpcProxyRequest(proto.Message): + r"""A request message for TargetGrpcProxies.Insert. See the + method description for details. + Attributes: - day_of_weeks (Sequence[google.cloud.compute_v1.types.ResourcePolicyWeeklyCycleDayOfWeek]): - Up to 7 intervals/windows, one for each day - of the week. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. Specify a + unique request ID so that if you must retry your request, + the server will know to ignore the request if it has already + been completed. For example, consider a situation where you + make an initial request and the request times out. If you + make the request again with the same request ID, the server + can check if original operation with the same request ID was + received, and if so, will ignore the second request. This + prevents clients from accidentally creating duplicate + commitments. The request ID must be a valid UUID with the + exception that zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). end_interface: + MixerMutationRequestBuilder + target_grpc_proxy_resource (google.cloud.compute_v1.types.TargetGrpcProxy): + The body resource for this request """ - day_of_weeks = proto.RepeatedField( - proto.MESSAGE, number=257871834, message="ResourcePolicyWeeklyCycleDayOfWeek", + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_grpc_proxy_resource = proto.Field( + proto.MESSAGE, number=328922450, message="TargetGrpcProxy", ) -class ResourcePolicyWeeklyCycleDayOfWeek(proto.Message): - r""" +class InsertTargetHttpProxyRequest(proto.Message): + r"""A request message for TargetHttpProxies.Insert. See the + method description for details. + Attributes: - day (google.cloud.compute_v1.types.ResourcePolicyWeeklyCycleDayOfWeek.Day): - Defines a schedule that runs on specific days - of the week. Specify one or more days. The - following options are available: MONDAY, - TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, - SUNDAY. - duration (str): - [Output only] Duration of the time window, automatically - chosen to be smallest possible in the given scenario. - start_time (str): - Time within the window to start the operations. It must be - in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_http_proxy_resource (google.cloud.compute_v1.types.TargetHttpProxy): + The body resource for this request """ - class Day(proto.Enum): - r"""Defines a schedule that runs on specific days of the week. - Specify one or more days. The following options are available: - MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY. - """ - UNDEFINED_DAY = 0 - FRIDAY = 471398751 - INVALID = 530283991 - MONDAY = 132310288 - SATURDAY = 279037881 - SUNDAY = 309626320 - THURSDAY = 207198682 - TUESDAY = 277509677 - WEDNESDAY = 422029110 - - day = proto.Field(proto.ENUM, number=99228, optional=True, enum=Day,) - duration = proto.Field(proto.STRING, number=155471252, optional=True,) - start_time = proto.Field(proto.STRING, number=37467274, optional=True,) - + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_http_proxy_resource = proto.Field( + proto.MESSAGE, number=24696744, message="TargetHttpProxy", + ) -class Route(proto.Message): - r"""Represents a Route resource. - A route defines a path from VM instances in the VPC network to a - specific destination. This destination can be inside or outside the - VPC network. For more information, read the Routes overview. (== - resource_for {$api_version}.routes ==) +class InsertTargetHttpsProxyRequest(proto.Message): + r"""A request message for TargetHttpsProxies.Insert. See the + method description for details. Attributes: - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - description (str): - An optional description of this resource. - Provide this field when you create the resource. - dest_range (str): - The destination range of outgoing packets - that this route applies to. Both IPv4 and IPv6 - are supported. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - kind (str): - [Output Only] Type of this resource. Always compute#routes - for Route resources. - name (str): - Name of the resource. Provided by the client when the - resource is created. The name must be 1-63 characters long, - and comply with RFC1035. Specifically, the name must be 1-63 - characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?``. The first character must be - a lowercase letter, and all following characters (except for - the last character) must be a dash, lowercase letter, or - digit. The last character must be a lowercase letter or - digit. - network (str): - Fully-qualified URL of the network that this - route applies to. - next_hop_gateway (str): - The URL to a gateway that should handle - matching packets. You can only specify the - internet gateway using a full or partial valid - URL: projects/project/global/gateways/default- - internet-gateway - next_hop_ilb (str): - The URL to a forwarding rule of type - loadBalancingScheme=INTERNAL that should handle - matching packets or the IP address of the - forwarding Rule. For example, the following are - all valid URLs: - 10.128.0.56 - - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule - - regions/region/forwardingRules/forwardingRule - next_hop_instance (str): - The URL to an instance that should handle - matching packets. You can specify this as a full - or partial URL. For example: - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/ - next_hop_ip (str): - The network IP address of an instance that - should handle matching packets. Only IPv4 is - supported. - next_hop_network (str): - The URL of the local network if it should - handle matching packets. - next_hop_peering (str): - [Output Only] The network peering name that should handle - matching packets, which should conform to RFC1035. - next_hop_vpn_tunnel (str): - The URL to a VpnTunnel that should handle - matching packets. - priority (int): - The priority of this route. Priority is used to break ties - in cases where there is more than one matching route of - equal prefix length. In cases where multiple routes have - equal prefix length, the one with the lowest-numbered - priority value wins. The default value is ``1000``. The - priority value must be from ``0`` to ``65535``, inclusive. - self_link (str): - [Output Only] Server-defined fully-qualified URL for this - resource. - tags (Sequence[str]): - A list of instance tags to which this route - applies. - warnings (Sequence[google.cloud.compute_v1.types.Warnings]): - [Output Only] If potential misconfigurations are detected - for this route, this field will be populated with warning - messages. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_https_proxy_resource (google.cloud.compute_v1.types.TargetHttpsProxy): + The body resource for this request """ - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - dest_range = proto.Field(proto.STRING, number=381327712, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - network = proto.Field(proto.STRING, number=232872494, optional=True,) - next_hop_gateway = proto.Field(proto.STRING, number=377175298, optional=True,) - next_hop_ilb = proto.Field(proto.STRING, number=198679901, optional=True,) - next_hop_instance = proto.Field(proto.STRING, number=393508247, optional=True,) - next_hop_ip = proto.Field(proto.STRING, number=110319529, optional=True,) - next_hop_network = proto.Field(proto.STRING, number=262295788, optional=True,) - next_hop_peering = proto.Field(proto.STRING, number=412682750, optional=True,) - next_hop_vpn_tunnel = proto.Field(proto.STRING, number=519844501, optional=True,) - priority = proto.Field(proto.UINT32, number=445151652, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - tags = proto.RepeatedField(proto.STRING, number=3552281,) - warnings = proto.RepeatedField(proto.MESSAGE, number=498091095, message="Warnings",) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_https_proxy_resource = proto.Field( + proto.MESSAGE, number=433657473, message="TargetHttpsProxy", + ) -class RouteList(proto.Message): - r"""Contains a list of Route resources. +class InsertTargetInstanceRequest(proto.Message): + r"""A request message for TargetInstances.Insert. See the method + description for details. + Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.Route]): - A list of Route resources. - kind (str): - Type of resource. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_instance_resource (google.cloud.compute_v1.types.TargetInstance): + The body resource for this request + zone (str): + Name of the zone scoping this request. """ - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Route",) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_instance_resource = proto.Field( + proto.MESSAGE, number=430453066, message="TargetInstance", ) + zone = proto.Field(proto.STRING, number=3744684,) -class RouterBgp(proto.Message): - r""" +class InsertTargetPoolRequest(proto.Message): + r"""A request message for TargetPools.Insert. See the method + description for details. + Attributes: - advertise_mode (google.cloud.compute_v1.types.RouterBgp.AdvertiseMode): - User-specified flag to indicate which mode to - use for advertisement. The options are DEFAULT - or CUSTOM. - advertised_groups (Sequence[google.cloud.compute_v1.types.RouterBgp.AdvertisedGroups]): - User-specified list of prefix groups to advertise in custom - mode. This field can only be populated if advertise_mode is - CUSTOM and is advertised to all peers of the router. These - groups will be advertised in addition to any specified - prefixes. Leave this field blank to advertise no custom - groups. - advertised_ip_ranges (Sequence[google.cloud.compute_v1.types.RouterAdvertisedIpRange]): - User-specified list of individual IP ranges to advertise in - custom mode. This field can only be populated if - advertise_mode is CUSTOM and is advertised to all peers of - the router. These IP ranges will be advertised in addition - to any specified groups. Leave this field blank to advertise - no custom IP ranges. - asn (int): - Local BGP Autonomous System Number (ASN). - Must be an RFC6996 private ASN, either 16-bit or - 32-bit. The value will be fixed for this router - resource. All VPN tunnels that link to this - router will have the same local ASN. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_pool_resource (google.cloud.compute_v1.types.TargetPool): + The body resource for this request """ - class AdvertiseMode(proto.Enum): - r"""User-specified flag to indicate which mode to use for - advertisement. The options are DEFAULT or CUSTOM. - """ - UNDEFINED_ADVERTISE_MODE = 0 - CUSTOM = 388595569 - DEFAULT = 115302945 - - class AdvertisedGroups(proto.Enum): - r"""""" - UNDEFINED_ADVERTISED_GROUPS = 0 - ALL_SUBNETS = 3622872 - - advertise_mode = proto.Field( - proto.ENUM, number=312134331, optional=True, enum=AdvertiseMode, - ) - advertised_groups = proto.RepeatedField( - proto.ENUM, number=21065526, enum=AdvertisedGroups, - ) - advertised_ip_ranges = proto.RepeatedField( - proto.MESSAGE, number=35449932, message="RouterAdvertisedIpRange", + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_pool_resource = proto.Field( + proto.MESSAGE, number=101281443, message="TargetPool", ) - asn = proto.Field(proto.UINT32, number=96892, optional=True,) -class RouterBgpPeer(proto.Message): - r""" +class InsertTargetSslProxyRequest(proto.Message): + r"""A request message for TargetSslProxies.Insert. See the method + description for details. + Attributes: - advertise_mode (google.cloud.compute_v1.types.RouterBgpPeer.AdvertiseMode): - User-specified flag to indicate which mode to - use for advertisement. - advertised_groups (Sequence[google.cloud.compute_v1.types.RouterBgpPeer.AdvertisedGroups]): - User-specified list of prefix groups to advertise in custom - mode, which can take one of the following options: - - - ALL_SUBNETS: Advertises all available subnets, including - peer VPC subnets. - - ALL_VPC_SUBNETS: Advertises the router's own VPC subnets. - Note that this field can only be populated if - advertise_mode is CUSTOM and overrides the list defined - for the router (in the "bgp" message). These groups are - advertised in addition to any specified prefixes. Leave - this field blank to advertise no custom groups. - advertised_ip_ranges (Sequence[google.cloud.compute_v1.types.RouterAdvertisedIpRange]): - User-specified list of individual IP ranges to advertise in - custom mode. This field can only be populated if - advertise_mode is CUSTOM and overrides the list defined for - the router (in the "bgp" message). These IP ranges are - advertised in addition to any specified groups. Leave this - field blank to advertise no custom IP ranges. - advertised_route_priority (int): - The priority of routes advertised to this BGP - peer. Where there is more than one matching - route of maximum length, the routes with the - lowest priority value win. - interface_name (str): - Name of the interface the BGP peer is - associated with. - ip_address (str): - IP address of the interface inside Google - Cloud Platform. Only IPv4 is supported. - management_type (google.cloud.compute_v1.types.RouterBgpPeer.ManagementType): - [Output Only] The resource that configures and manages this - BGP peer. - - - MANAGED_BY_USER is the default value and can be managed - by you or other users - - MANAGED_BY_ATTACHMENT is a BGP peer that is configured - and managed by Cloud Interconnect, specifically by an - InterconnectAttachment of type PARTNER. Google - automatically creates, updates, and deletes this type of - BGP peer when the PARTNER InterconnectAttachment is - created, updated, or deleted. - name (str): - Name of this BGP peer. The name must be 1-63 characters - long, and comply with RFC1035. Specifically, the name must - be 1-63 characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. - peer_asn (int): - Peer BGP Autonomous System Number (ASN). Each - BGP interface may use a different value. - peer_ip_address (str): - IP address of the BGP interface outside - Google Cloud Platform. Only IPv4 is supported. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_ssl_proxy_resource (google.cloud.compute_v1.types.TargetSslProxy): + The body resource for this request """ - class AdvertiseMode(proto.Enum): - r"""User-specified flag to indicate which mode to use for - advertisement. - """ - UNDEFINED_ADVERTISE_MODE = 0 - CUSTOM = 388595569 - DEFAULT = 115302945 + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_ssl_proxy_resource = proto.Field( + proto.MESSAGE, number=142016192, message="TargetSslProxy", + ) - class AdvertisedGroups(proto.Enum): - r"""""" - UNDEFINED_ADVERTISED_GROUPS = 0 - ALL_SUBNETS = 3622872 - class ManagementType(proto.Enum): - r"""[Output Only] The resource that configures and manages this BGP - peer. - - - MANAGED_BY_USER is the default value and can be managed by you or - other users - - MANAGED_BY_ATTACHMENT is a BGP peer that is configured and - managed by Cloud Interconnect, specifically by an - InterconnectAttachment of type PARTNER. Google automatically - creates, updates, and deletes this type of BGP peer when the - PARTNER InterconnectAttachment is created, updated, or deleted. - """ - UNDEFINED_MANAGEMENT_TYPE = 0 - MANAGED_BY_ATTACHMENT = 458926411 - MANAGED_BY_USER = 317294067 +class InsertTargetTcpProxyRequest(proto.Message): + r"""A request message for TargetTcpProxies.Insert. See the method + description for details. + + Attributes: + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_tcp_proxy_resource (google.cloud.compute_v1.types.TargetTcpProxy): + The body resource for this request + """ - advertise_mode = proto.Field( - proto.ENUM, number=312134331, optional=True, enum=AdvertiseMode, - ) - advertised_groups = proto.RepeatedField( - proto.ENUM, number=21065526, enum=AdvertisedGroups, - ) - advertised_ip_ranges = proto.RepeatedField( - proto.MESSAGE, number=35449932, message="RouterAdvertisedIpRange", - ) - advertised_route_priority = proto.Field( - proto.UINT32, number=186486332, optional=True, - ) - interface_name = proto.Field(proto.STRING, number=437854673, optional=True,) - ip_address = proto.Field(proto.STRING, number=406272220, optional=True,) - management_type = proto.Field( - proto.ENUM, number=173703606, optional=True, enum=ManagementType, + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_tcp_proxy_resource = proto.Field( + proto.MESSAGE, number=145913931, message="TargetTcpProxy", ) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - peer_asn = proto.Field(proto.UINT32, number=69573151, optional=True,) - peer_ip_address = proto.Field(proto.STRING, number=207735769, optional=True,) -class RouterInterface(proto.Message): - r""" - Attributes: - ip_range (str): - IP address and range of the interface. The IP - range must be in the RFC3927 link-local IP - address space. The value must be a CIDR- - formatted string, for example: 169.254.0.1/30. - NOTE: Do not truncate the address as it - represents the IP address of the interface. - linked_interconnect_attachment (str): - URI of the linked Interconnect attachment. It - must be in the same region as the router. Each - interface can have one linked resource, which - can be a VPN tunnel, an Interconnect attachment, - or a virtual machine instance. - linked_vpn_tunnel (str): - URI of the linked VPN tunnel, which must be - in the same region as the router. Each interface - can have one linked resource, which can be a VPN - tunnel, an Interconnect attachment, or a virtual - machine instance. - management_type (google.cloud.compute_v1.types.RouterInterface.ManagementType): - [Output Only] The resource that configures and manages this - interface. +class InsertTargetVpnGatewayRequest(proto.Message): + r"""A request message for TargetVpnGateways.Insert. See the + method description for details. - - MANAGED_BY_USER is the default value and can be managed - directly by users. - - MANAGED_BY_ATTACHMENT is an interface that is configured - and managed by Cloud Interconnect, specifically, by an - InterconnectAttachment of type PARTNER. Google - automatically creates, updates, and deletes this type of - interface when the PARTNER InterconnectAttachment is - created, updated, or deleted. - name (str): - Name of this interface entry. The name must be 1-63 - characters long, and comply with RFC1035. Specifically, the - name must be 1-63 characters long and match the regular - expression ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the - first character must be a lowercase letter, and all - following characters must be a dash, lowercase letter, or - digit, except the last character, which cannot be a dash. + Attributes: + project (str): + Project ID for this request. + region (str): + Name of the region for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_vpn_gateway_resource (google.cloud.compute_v1.types.TargetVpnGateway): + The body resource for this request """ - class ManagementType(proto.Enum): - r"""[Output Only] The resource that configures and manages this - interface. - - - MANAGED_BY_USER is the default value and can be managed directly - by users. - - MANAGED_BY_ATTACHMENT is an interface that is configured and - managed by Cloud Interconnect, specifically, by an - InterconnectAttachment of type PARTNER. Google automatically - creates, updates, and deletes this type of interface when the - PARTNER InterconnectAttachment is created, updated, or deleted. - """ - UNDEFINED_MANAGEMENT_TYPE = 0 - MANAGED_BY_ATTACHMENT = 458926411 - MANAGED_BY_USER = 317294067 - - ip_range = proto.Field(proto.STRING, number=145092645, optional=True,) - linked_interconnect_attachment = proto.Field( - proto.STRING, number=501085518, optional=True, - ) - linked_vpn_tunnel = proto.Field(proto.STRING, number=352296953, optional=True,) - management_type = proto.Field( - proto.ENUM, number=173703606, optional=True, enum=ManagementType, + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_vpn_gateway_resource = proto.Field( + proto.MESSAGE, number=498050, message="TargetVpnGateway", ) - name = proto.Field(proto.STRING, number=3373707, optional=True,) -class RouterNat(proto.Message): - r"""Represents a Nat resource. It enables the VMs within the - specified subnetworks to access Internet without external IP - addresses. It specifies a list of subnetworks (and the ranges - within) that want to use NAT. Customers can also provide the - external IPs that would be used for NAT. GCP would auto-allocate - ephemeral IPs if no external IPs are provided. +class InsertUrlMapRequest(proto.Message): + r"""A request message for UrlMaps.Insert. See the method + description for details. Attributes: - drain_nat_ips (Sequence[str]): - A list of URLs of the IP resources to be - drained. These IPs must be valid static external - IPs that have been assigned to the NAT. These - IPs should be used for updating/patching a NAT - only. - enable_endpoint_independent_mapping (bool): + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + url_map_resource (google.cloud.compute_v1.types.UrlMap): + The body resource for this request + """ - icmp_idle_timeout_sec (int): - Timeout (in seconds) for ICMP connections. - Defaults to 30s if not set. - log_config (google.cloud.compute_v1.types.RouterNatLogConfig): - Configure logging on this NAT. - min_ports_per_vm (int): - Minimum number of ports allocated to a VM - from this NAT config. If not set, a default - number of ports is allocated to a VM. This is - rounded up to the nearest power of 2. For - example, if the value of this field is 50, at - least 64 ports are allocated to a VM. - name (str): - Unique name of this Nat service. The name - must be 1-63 characters long and comply with - RFC1035. - nat_ip_allocate_option (google.cloud.compute_v1.types.RouterNat.NatIpAllocateOption): - Specify the NatIpAllocateOption, which can take one of the - following values: - - - MANUAL_ONLY: Uses only Nat IP addresses provided by - customers. When there are not enough specified Nat IPs, - the Nat service fails for new VMs. - - AUTO_ONLY: Nat IPs are allocated by Google Cloud - Platform; customers can't specify any Nat IPs. When - choosing AUTO_ONLY, then nat_ip should be empty. - nat_ips (Sequence[str]): - A list of URLs of the IP resources used for - this Nat service. These IP addresses must be - valid static external IP addresses assigned to - the project. - source_subnetwork_ip_ranges_to_nat (google.cloud.compute_v1.types.RouterNat.SourceSubnetworkIpRangesToNat): - Specify the Nat option, which can take one of the following - values: + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + url_map_resource = proto.Field(proto.MESSAGE, number=168675425, message="UrlMap",) - - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in - every Subnetwork are allowed to Nat. - - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary - IP ranges in every Subnetwork are allowed to Nat. - - LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to - Nat (specified in the field subnetwork below) The default - is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED. Note - that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES - or ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES, then there - should not be any other Router.Nat section in any Router - for this network in this region. - subnetworks (Sequence[google.cloud.compute_v1.types.RouterNatSubnetworkToNat]): - A list of Subnetwork resources whose traffic should be - translated by NAT Gateway. It is used only when - LIST_OF_SUBNETWORKS is selected for the - SubnetworkIpRangeToNatOption above. - tcp_established_idle_timeout_sec (int): - Timeout (in seconds) for TCP established - connections. Defaults to 1200s if not set. - tcp_transitory_idle_timeout_sec (int): - Timeout (in seconds) for TCP transitory - connections. Defaults to 30s if not set. - udp_idle_timeout_sec (int): - Timeout (in seconds) for UDP connections. - Defaults to 30s if not set. + +class InsertVpnGatewayRequest(proto.Message): + r"""A request message for VpnGateways.Insert. See the method + description for details. + + Attributes: + project (str): + Project ID for this request. + region (str): + Name of the region for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + vpn_gateway_resource (google.cloud.compute_v1.types.VpnGateway): + The body resource for this request """ - class NatIpAllocateOption(proto.Enum): - r"""Specify the NatIpAllocateOption, which can take one of the following - values: - - - MANUAL_ONLY: Uses only Nat IP addresses provided by customers. - When there are not enough specified Nat IPs, the Nat service - fails for new VMs. - - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; - customers can't specify any Nat IPs. When choosing AUTO_ONLY, - then nat_ip should be empty. - """ - UNDEFINED_NAT_IP_ALLOCATE_OPTION = 0 - AUTO_ONLY = 182333500 - MANUAL_ONLY = 261251205 + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + vpn_gateway_resource = proto.Field( + proto.MESSAGE, number=182688660, message="VpnGateway", + ) - class SourceSubnetworkIpRangesToNat(proto.Enum): - r"""Specify the Nat option, which can take one of the following values: - - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every - Subnetwork are allowed to Nat. - - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP - ranges in every Subnetwork are allowed to Nat. - - LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat - (specified in the field subnetwork below) The default is - SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED. Note that if this - field contains ALL_SUBNETWORKS_ALL_IP_RANGES or - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES, then there should not be - any other Router.Nat section in any Router for this network in - this region. - """ - UNDEFINED_SOURCE_SUBNETWORK_IP_RANGES_TO_NAT = 0 - ALL_SUBNETWORKS_ALL_IP_RANGES = 179964376 - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES = 185573819 - LIST_OF_SUBNETWORKS = 517542270 +class InsertVpnTunnelRequest(proto.Message): + r"""A request message for VpnTunnels.Insert. See the method + description for details. - drain_nat_ips = proto.RepeatedField(proto.STRING, number=504078535,) - enable_endpoint_independent_mapping = proto.Field( - proto.BOOL, number=259441819, optional=True, - ) - icmp_idle_timeout_sec = proto.Field(proto.INT32, number=3647562, optional=True,) - log_config = proto.Field( - proto.MESSAGE, number=351299741, optional=True, message="RouterNatLogConfig", - ) - min_ports_per_vm = proto.Field(proto.INT32, number=186193587, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - nat_ip_allocate_option = proto.Field( - proto.ENUM, number=429726845, optional=True, enum=NatIpAllocateOption, - ) - nat_ips = proto.RepeatedField(proto.STRING, number=117635086,) - source_subnetwork_ip_ranges_to_nat = proto.Field( - proto.ENUM, number=252213211, optional=True, enum=SourceSubnetworkIpRangesToNat, - ) - subnetworks = proto.RepeatedField( - proto.MESSAGE, number=415853125, message="RouterNatSubnetworkToNat", - ) - tcp_established_idle_timeout_sec = proto.Field( - proto.INT32, number=223098349, optional=True, - ) - tcp_transitory_idle_timeout_sec = proto.Field( - proto.INT32, number=205028774, optional=True, + Attributes: + project (str): + Project ID for this request. + region (str): + Name of the region for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + vpn_tunnel_resource (google.cloud.compute_v1.types.VpnTunnel): + The body resource for this request + """ + + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + vpn_tunnel_resource = proto.Field( + proto.MESSAGE, number=86839482, message="VpnTunnel", ) - udp_idle_timeout_sec = proto.Field(proto.INT32, number=64919878, optional=True,) -class Router(proto.Message): - r"""Represents a Cloud Router resource. - For more information about Cloud Router, read the Cloud Router - overview. +class Instance(proto.Message): + r"""Represents an Instance resource. An instance is a virtual + machine that is hosted on Google Cloud Platform. For more + information, read Virtual Machine Instances. Attributes: - bgp (google.cloud.compute_v1.types.RouterBgp): - BGP information specific to this router. - bgp_peers (Sequence[google.cloud.compute_v1.types.RouterBgpPeer]): - BGP information that must be configured into - the routing stack to establish BGP peering. This - information must specify the peer ASN and either - the interface name, IP address, or peer IP - address. Please refer to RFC4273. + advanced_machine_features (google.cloud.compute_v1.types.AdvancedMachineFeatures): + Controls for advanced machine-related + behavior features. + can_ip_forward (bool): + Allows this instance to send and receive + packets with non-matching destination or source + IPs. This is required if you plan to use this + instance to forward routes. For more + information, see Enabling IP Forwarding . + confidential_instance_config (google.cloud.compute_v1.types.ConfidentialInstanceConfig): + + cpu_platform (str): + [Output Only] The CPU platform used by this instance. creation_timestamp (str): [Output Only] Creation timestamp in RFC3339 text format. + deletion_protection (bool): + Whether the resource should be protected + against deletion. description (str): An optional description of this resource. Provide this property when you create the resource. - encrypted_interconnect_router (bool): - Field to indicate if a router is dedicated to - use with encrypted Interconnect Attachment - (IPsec-encrypted Cloud Interconnect feature). - Not currently available in all Interconnect - locations. + disks (Sequence[google.cloud.compute_v1.types.AttachedDisk]): + Array of disks associated with this instance. + Persistent disks must be created before you can + assign them. + display_device (google.cloud.compute_v1.types.DisplayDevice): + Enables display device for the instance. + fingerprint (str): + Specifies a fingerprint for this resource, + which is essentially a hash of the instance's + contents and used for optimistic locking. The + fingerprint is initially generated by Compute + Engine and changes after every request to modify + or update the instance. You must always provide + an up-to-date fingerprint hash in order to + update the instance. To see the latest + fingerprint, make get() request to the instance. + guest_accelerators (Sequence[google.cloud.compute_v1.types.AcceleratorConfig]): + A list of the type and count of accelerator + cards attached to the instance. + hostname (str): + Specifies the hostname of the instance. The specified + hostname must be RFC1035 compliant. If hostname is not + specified, the default hostname is + [INSTANCE_NAME].c.[PROJECT_ID].internal when using the + global DNS, and + [INSTANCE_NAME].[ZONE].c.[PROJECT_ID].internal when using + zonal DNS. id (int): [Output Only] The unique identifier for the resource. This identifier is defined by the server. - interfaces (Sequence[google.cloud.compute_v1.types.RouterInterface]): - Router interfaces. Each interface requires - either one linked resource, (for example, - linkedVpnTunnel), or IP address and IP address - range (for example, ipRange), or both. kind (str): - [Output Only] Type of resource. Always compute#router for - routers. + [Output Only] Type of the resource. Always compute#instance + for instances. + label_fingerprint (str): + A fingerprint for this request, which is + essentially a hash of the label's contents and + used for optimistic locking. The fingerprint is + initially generated by Compute Engine and + changes after every request to modify or update + labels. You must always provide an up-to-date + fingerprint hash in order to update or change + labels. To see the latest fingerprint, make + get() request to the instance. + labels (Sequence[google.cloud.compute_v1.types.Instance.LabelsEntry]): + Labels to apply to this instance. These can + be later modified by the setLabels method. + last_start_timestamp (str): + [Output Only] Last start timestamp in RFC3339 text format. + last_stop_timestamp (str): + [Output Only] Last stop timestamp in RFC3339 text format. + last_suspended_timestamp (str): + [Output Only] Last suspended timestamp in RFC3339 text + format. + machine_type (str): + Full or partial URL of the machine type + resource to use for this instance, in the + format: zones/zone/machineTypes/machine-type. + This is provided by the client when the instance + is created. For example, the following is a + valid partial url to a predefined machine type: + zones/us-central1-f/machineTypes/n1-standard-1 + To create a custom machine type, provide a URL + to a machine type in the following format, where + CPUS is 1 or an even number up to 32 (2, 4, 6, + ... 24, etc), and MEMORY is the total memory for + this instance. Memory must be a multiple of 256 + MB and must be supplied in MB (e.g. 5 GB of + memory is 5120 MB): + zones/zone/machineTypes/custom-CPUS-MEMORY For + example: zones/us- + central1-f/machineTypes/custom-4-5120 For a full + list of restrictions, read the Specifications + for custom machine types. + metadata (google.cloud.compute_v1.types.Metadata): + The metadata key/value pairs assigned to this + instance. This includes custom metadata and + predefined keys. + min_cpu_platform (str): + Specifies a minimum CPU platform for the VM + instance. Applicable values are the friendly + names of CPU platforms, such as minCpuPlatform: + "Intel Haswell" or minCpuPlatform: "Intel Sandy + Bridge". name (str): - Name of the resource. Provided by the client when the - resource is created. The name must be 1-63 characters long, - and comply with RFC1035. Specifically, the name must be 1-63 - characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. - nats (Sequence[google.cloud.compute_v1.types.RouterNat]): - A list of NAT services created in this - router. - network (str): - URI of the network to which this router - belongs. - region (str): - [Output Only] URI of the region where the router resides. + The name of the resource, provided by the client when + initially creating the resource. The resource name must be + 1-63 characters long, and comply with RFC1035. Specifically, + the name must be 1-63 characters long and match the regular + expression ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the + first character must be a lowercase letter, and all + following characters must be a dash, lowercase letter, or + digit, except the last character, which cannot be a dash. + network_interfaces (Sequence[google.cloud.compute_v1.types.NetworkInterface]): + An array of network configurations for this + instance. These specify how interfaces are + configured to interact with other network + services, such as connecting to the internet. + Multiple interfaces are supported per instance. + private_ipv6_google_access (google.cloud.compute_v1.types.Instance.PrivateIpv6GoogleAccess): + The private IPv6 google access type for the VM. If not + specified, use INHERIT_FROM_SUBNETWORK as default. + reservation_affinity (google.cloud.compute_v1.types.ReservationAffinity): + Specifies the reservations that this instance + can consume from. + resource_policies (Sequence[str]): + Resource policies applied to this instance. + satisfies_pzs (bool): + [Output Only] Reserved for future use. + scheduling (google.cloud.compute_v1.types.Scheduling): + Sets the scheduling options for this + instance. + self_link (str): + [Output Only] Server-defined URL for this resource. + service_accounts (Sequence[google.cloud.compute_v1.types.ServiceAccount]): + A list of service accounts, with their + specified scopes, authorized for this instance. + Only one service account per VM instance is + supported. Service accounts generate access + tokens that can be accessed through the metadata + server and used to authenticate applications on + the instance. See Service Accounts for more + information. + shielded_instance_config (google.cloud.compute_v1.types.ShieldedInstanceConfig): + + shielded_instance_integrity_policy (google.cloud.compute_v1.types.ShieldedInstanceIntegrityPolicy): + + start_restricted (bool): + [Output Only] Whether a VM has been restricted for start + because Compute Engine has detected suspicious activity. + status (google.cloud.compute_v1.types.Instance.Status): + [Output Only] The status of the instance. One of the + following values: PROVISIONING, STAGING, RUNNING, STOPPING, + SUSPENDING, SUSPENDED, REPAIRING, and TERMINATED. For more + information about the status of the instance, see Instance + life cycle. + status_message (str): + [Output Only] An optional, human-readable explanation of the + status. + tags (google.cloud.compute_v1.types.Tags): + Tags to apply to this instance. Tags are used + to identify valid sources or targets for network + firewalls and are specified by the client during + instance creation. The tags can be later + modified by the setTags method. Each tag within + the list must comply with RFC1035. Multiple tags + can be specified via the 'tags.items' field. + zone (str): + [Output Only] URL of the zone where the instance resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. - self_link (str): - [Output Only] Server-defined URL for the resource. """ - bgp = proto.Field(proto.MESSAGE, number=97483, optional=True, message="RouterBgp",) - bgp_peers = proto.RepeatedField( - proto.MESSAGE, number=452695773, message="RouterBgpPeer", + class PrivateIpv6GoogleAccess(proto.Enum): + r"""The private IPv6 google access type for the VM. If not specified, + use INHERIT_FROM_SUBNETWORK as default. + """ + UNDEFINED_PRIVATE_IPV6_GOOGLE_ACCESS = 0 + ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE = 427975994 + ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE = 288210263 + INHERIT_FROM_SUBNETWORK = 530256959 + + class Status(proto.Enum): + r"""[Output Only] The status of the instance. One of the following + values: PROVISIONING, STAGING, RUNNING, STOPPING, SUSPENDING, + SUSPENDED, REPAIRING, and TERMINATED. For more information about the + status of the instance, see Instance life cycle. + """ + UNDEFINED_STATUS = 0 + DEPROVISIONING = 428935662 + PROVISIONING = 290896621 + REPAIRING = 413483285 + RUNNING = 121282975 + STAGING = 431072283 + STOPPED = 444276141 + STOPPING = 350791796 + SUSPENDED = 51223995 + SUSPENDING = 514206246 + TERMINATED = 250018339 + + advanced_machine_features = proto.Field( + proto.MESSAGE, + number=409646002, + optional=True, + message="AdvancedMachineFeatures", + ) + can_ip_forward = proto.Field(proto.BOOL, number=467731324, optional=True,) + confidential_instance_config = proto.Field( + proto.MESSAGE, + number=490637685, + optional=True, + message="ConfidentialInstanceConfig", ) + cpu_platform = proto.Field(proto.STRING, number=410285354, optional=True,) creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + deletion_protection = proto.Field(proto.BOOL, number=458014698, optional=True,) description = proto.Field(proto.STRING, number=422937596, optional=True,) - encrypted_interconnect_router = proto.Field( - proto.BOOL, number=297996575, optional=True, + disks = proto.RepeatedField(proto.MESSAGE, number=95594102, message="AttachedDisk",) + display_device = proto.Field( + proto.MESSAGE, number=258933875, optional=True, message="DisplayDevice", ) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - interfaces = proto.RepeatedField( - proto.MESSAGE, number=12073562, message="RouterInterface", + fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) + guest_accelerators = proto.RepeatedField( + proto.MESSAGE, number=463595119, message="AcceleratorConfig", ) + hostname = proto.Field(proto.STRING, number=237067315, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) kind = proto.Field(proto.STRING, number=3292052, optional=True,) + label_fingerprint = proto.Field(proto.STRING, number=178124825, optional=True,) + labels = proto.MapField(proto.STRING, proto.STRING, number=500195327,) + last_start_timestamp = proto.Field(proto.STRING, number=443830736, optional=True,) + last_stop_timestamp = proto.Field(proto.STRING, number=412823010, optional=True,) + last_suspended_timestamp = proto.Field( + proto.STRING, number=356275337, optional=True, + ) + machine_type = proto.Field(proto.STRING, number=227711026, optional=True,) + metadata = proto.Field( + proto.MESSAGE, number=86866735, optional=True, message="Metadata", + ) + min_cpu_platform = proto.Field(proto.STRING, number=242912759, optional=True,) name = proto.Field(proto.STRING, number=3373707, optional=True,) - nats = proto.RepeatedField(proto.MESSAGE, number=3373938, message="RouterNat",) - network = proto.Field(proto.STRING, number=232872494, optional=True,) - region = proto.Field(proto.STRING, number=138946292, optional=True,) + network_interfaces = proto.RepeatedField( + proto.MESSAGE, number=52735243, message="NetworkInterface", + ) + private_ipv6_google_access = proto.Field( + proto.ENUM, number=48277006, optional=True, enum=PrivateIpv6GoogleAccess, + ) + reservation_affinity = proto.Field( + proto.MESSAGE, number=157850683, optional=True, message="ReservationAffinity", + ) + resource_policies = proto.RepeatedField(proto.STRING, number=22220385,) + satisfies_pzs = proto.Field(proto.BOOL, number=480964267, optional=True,) + scheduling = proto.Field( + proto.MESSAGE, number=386688404, optional=True, message="Scheduling", + ) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - - -class RouterAdvertisedIpRange(proto.Message): - r"""Description-tagged IP ranges for the router to advertise. - Attributes: - description (str): - User-specified description for the IP range. - range_ (str): - The IP range to advertise. The value must be - a CIDR-formatted string. - """ - - description = proto.Field(proto.STRING, number=422937596, optional=True,) - range_ = proto.Field(proto.STRING, number=108280125, optional=True,) - - -class RoutersScopedList(proto.Message): - r""" - Attributes: - routers (Sequence[google.cloud.compute_v1.types.Router]): - A list of routers contained in this scope. - warning (google.cloud.compute_v1.types.Warning): - Informational warning which replaces the list - of routers when the list is empty. - """ - - routers = proto.RepeatedField(proto.MESSAGE, number=311906890, message="Router",) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + service_accounts = proto.RepeatedField( + proto.MESSAGE, number=277537328, message="ServiceAccount", + ) + shielded_instance_config = proto.Field( + proto.MESSAGE, number=12862901, optional=True, message="ShieldedInstanceConfig", + ) + shielded_instance_integrity_policy = proto.Field( + proto.MESSAGE, + number=163696919, + optional=True, + message="ShieldedInstanceIntegrityPolicy", ) + start_restricted = proto.Field(proto.BOOL, number=123693144, optional=True,) + status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) + status_message = proto.Field(proto.STRING, number=297428154, optional=True,) + tags = proto.Field(proto.MESSAGE, number=3552281, optional=True, message="Tags",) + zone = proto.Field(proto.STRING, number=3744684, optional=True,) -class RouterAggregatedList(proto.Message): - r"""Contains a list of routers. +class InstanceAggregatedList(proto.Message): + r""" Attributes: id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.RouterAggregatedList.ItemsEntry]): - A list of Router resources. + items (Sequence[google.cloud.compute_v1.types.InstanceAggregatedList.ItemsEntry]): + An object that contains a list of instances + scoped by zone. kind (str): - Type of resource. + [Output Only] Type of resource. Always + compute#instanceAggregatedList for aggregated lists of + Instance resources. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -20812,7 +20509,7 @@ def raw_page(self): id = proto.Field(proto.STRING, number=3355, optional=True,) items = proto.MapField( - proto.STRING, proto.MESSAGE, number=100526016, message="RoutersScopedList", + proto.STRING, proto.MESSAGE, number=100526016, message="InstancesScopedList", ) kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) @@ -20823,438 +20520,70 @@ def raw_page(self): ) -class RouterList(proto.Message): - r"""Contains a list of Router resources. - Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.Router]): - A list of Router resources. - kind (str): - [Output Only] Type of resource. Always compute#router for - routers. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. - """ - - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Router",) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) - - -class RouterNatLogConfig(proto.Message): - r"""Configuration of logging on a NAT. - Attributes: - enable (bool): - Indicates whether or not to export logs. This - is false by default. - filter (google.cloud.compute_v1.types.RouterNatLogConfig.Filter): - Specify the desired filtering of logs on this NAT. If - unspecified, logs are exported for all connections handled - by this NAT. This option can take one of the following - values: - - - ERRORS_ONLY: Export logs only for connection failures. - - TRANSLATIONS_ONLY: Export logs only for successful - connections. - - ALL: Export logs for all connections, successful and - unsuccessful. - """ - - class Filter(proto.Enum): - r"""Specify the desired filtering of logs on this NAT. If unspecified, - logs are exported for all connections handled by this NAT. This - option can take one of the following values: - - - ERRORS_ONLY: Export logs only for connection failures. - - TRANSLATIONS_ONLY: Export logs only for successful connections. - - ALL: Export logs for all connections, successful and - unsuccessful. - """ - UNDEFINED_FILTER = 0 - ALL = 64897 - ERRORS_ONLY = 307484672 - TRANSLATIONS_ONLY = 357212649 - - enable = proto.Field(proto.BOOL, number=311764355, optional=True,) - filter = proto.Field(proto.ENUM, number=336120696, optional=True, enum=Filter,) - - -class RouterNatSubnetworkToNat(proto.Message): - r"""Defines the IP ranges that want to use NAT for a subnetwork. - Attributes: - name (str): - URL for the subnetwork resource that will use - NAT. - secondary_ip_range_names (Sequence[str]): - A list of the secondary ranges of the Subnetwork that are - allowed to use NAT. This can be populated only if - "LIST_OF_SECONDARY_IP_RANGES" is one of the values in - source_ip_ranges_to_nat. - source_ip_ranges_to_nat (Sequence[google.cloud.compute_v1.types.RouterNatSubnetworkToNat.SourceIpRangesToNat]): - Specify the options for NAT ranges in the Subnetwork. All - options of a single value are valid except - NAT_IP_RANGE_OPTION_UNSPECIFIED. The only valid option with - multiple values is: ["PRIMARY_IP_RANGE", - "LIST_OF_SECONDARY_IP_RANGES"] Default: [ALL_IP_RANGES] - """ - - class SourceIpRangesToNat(proto.Enum): - r"""""" - UNDEFINED_SOURCE_IP_RANGES_TO_NAT = 0 - ALL_IP_RANGES = 35608496 - LIST_OF_SECONDARY_IP_RANGES = 192289308 - PRIMARY_IP_RANGE = 297109954 - - name = proto.Field(proto.STRING, number=3373707, optional=True,) - secondary_ip_range_names = proto.RepeatedField(proto.STRING, number=264315097,) - source_ip_ranges_to_nat = proto.RepeatedField( - proto.ENUM, number=388310386, enum=SourceIpRangesToNat, - ) - - -class RouterStatusBgpPeerStatus(proto.Message): - r""" - Attributes: - advertised_routes (Sequence[google.cloud.compute_v1.types.Route]): - Routes that were advertised to the remote BGP - peer - ip_address (str): - IP address of the local BGP interface. - linked_vpn_tunnel (str): - URL of the VPN tunnel that this BGP peer - controls. - name (str): - Name of this BGP peer. Unique within the - Routers resource. - num_learned_routes (int): - Number of routes learned from the remote BGP - Peer. - peer_ip_address (str): - IP address of the remote BGP interface. - state (str): - BGP state as specified in RFC1771. - status (google.cloud.compute_v1.types.RouterStatusBgpPeerStatus.Status): - Status of the BGP peer: {UP, DOWN} - uptime (str): - Time this session has been up. Format: 14 - years, 51 weeks, 6 days, 23 hours, 59 minutes, - 59 seconds - uptime_seconds (str): - Time this session has been up, in seconds. - Format: 145 - """ - - class Status(proto.Enum): - r"""Status of the BGP peer: {UP, DOWN}""" - UNDEFINED_STATUS = 0 - DOWN = 2104482 - UNKNOWN = 433141802 - UP = 2715 - - advertised_routes = proto.RepeatedField( - proto.MESSAGE, number=333393068, message="Route", - ) - ip_address = proto.Field(proto.STRING, number=406272220, optional=True,) - linked_vpn_tunnel = proto.Field(proto.STRING, number=352296953, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - num_learned_routes = proto.Field(proto.UINT32, number=135457535, optional=True,) - peer_ip_address = proto.Field(proto.STRING, number=207735769, optional=True,) - state = proto.Field(proto.STRING, number=109757585, optional=True,) - status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) - uptime = proto.Field(proto.STRING, number=235379688, optional=True,) - uptime_seconds = proto.Field(proto.STRING, number=104736040, optional=True,) - - -class RouterStatusNatStatus(proto.Message): - r"""Status of a NAT contained in this router. - Attributes: - auto_allocated_nat_ips (Sequence[str]): - A list of IPs auto-allocated for NAT. Example: ["1.1.1.1", - "129.2.16.89"] - drain_auto_allocated_nat_ips (Sequence[str]): - A list of IPs auto-allocated for NAT that are in drain mode. - Example: ["1.1.1.1", "179.12.26.133"]. - drain_user_allocated_nat_ips (Sequence[str]): - A list of IPs user-allocated for NAT that are in drain mode. - Example: ["1.1.1.1", "179.12.26.133"]. - min_extra_nat_ips_needed (int): - The number of extra IPs to allocate. This will be greater - than 0 only if user-specified IPs are NOT enough to allow - all configured VMs to use NAT. This value is meaningful only - when auto-allocation of NAT IPs is *not* used. - name (str): - Unique name of this NAT. - num_vm_endpoints_with_nat_mappings (int): - Number of VM endpoints (i.e., Nics) that can - use NAT. - user_allocated_nat_ip_resources (Sequence[str]): - A list of fully qualified URLs of reserved IP - address resources. - user_allocated_nat_ips (Sequence[str]): - A list of IPs user-allocated for NAT. They - will be raw IP strings like "179.12.26.133". - """ - - auto_allocated_nat_ips = proto.RepeatedField(proto.STRING, number=510794246,) - drain_auto_allocated_nat_ips = proto.RepeatedField(proto.STRING, number=309184557,) - drain_user_allocated_nat_ips = proto.RepeatedField(proto.STRING, number=305268553,) - min_extra_nat_ips_needed = proto.Field( - proto.INT32, number=365786338, optional=True, - ) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - num_vm_endpoints_with_nat_mappings = proto.Field( - proto.INT32, number=512367468, optional=True, - ) - user_allocated_nat_ip_resources = proto.RepeatedField( - proto.STRING, number=212776151, - ) - user_allocated_nat_ips = proto.RepeatedField(proto.STRING, number=506878242,) - - -class RouterStatus(proto.Message): - r""" - Attributes: - best_routes (Sequence[google.cloud.compute_v1.types.Route]): - Best routes for this router's network. - best_routes_for_router (Sequence[google.cloud.compute_v1.types.Route]): - Best routes learned by this router. - bgp_peer_status (Sequence[google.cloud.compute_v1.types.RouterStatusBgpPeerStatus]): - - nat_status (Sequence[google.cloud.compute_v1.types.RouterStatusNatStatus]): - - network (str): - URI of the network to which this router - belongs. - """ - - best_routes = proto.RepeatedField(proto.MESSAGE, number=395826693, message="Route",) - best_routes_for_router = proto.RepeatedField( - proto.MESSAGE, number=119389689, message="Route", - ) - bgp_peer_status = proto.RepeatedField( - proto.MESSAGE, number=218459131, message="RouterStatusBgpPeerStatus", - ) - nat_status = proto.RepeatedField( - proto.MESSAGE, number=63098064, message="RouterStatusNatStatus", - ) - network = proto.Field(proto.STRING, number=232872494, optional=True,) - - -class RouterStatusResponse(proto.Message): - r""" - Attributes: - kind (str): - Type of resource. - result (google.cloud.compute_v1.types.RouterStatus): - - """ - - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - result = proto.Field( - proto.MESSAGE, number=139315229, optional=True, message="RouterStatus", - ) - - -class RoutersPreviewResponse(proto.Message): - r""" - Attributes: - resource (google.cloud.compute_v1.types.Router): - Preview of given router. - """ - - resource = proto.Field( - proto.MESSAGE, number=195806222, optional=True, message="Router", - ) - - -class SchedulingNodeAffinity(proto.Message): - r"""Node Affinity: the configuration of desired nodes onto which - this Instance could be scheduled. - - Attributes: - key (str): - Corresponds to the label key of Node - resource. - operator (google.cloud.compute_v1.types.SchedulingNodeAffinity.Operator): - Defines the operation of node selection. Valid operators are - IN for affinity and NOT_IN for anti-affinity. - values (Sequence[str]): - Corresponds to the label values of Node - resource. - """ - - class Operator(proto.Enum): - r"""Defines the operation of node selection. Valid operators are IN for - affinity and NOT_IN for anti-affinity. - """ - UNDEFINED_OPERATOR = 0 - IN = 2341 - NOT_IN = 161144369 - OPERATOR_UNSPECIFIED = 128892924 - - key = proto.Field(proto.STRING, number=106079, optional=True,) - operator = proto.Field(proto.ENUM, number=36317348, optional=True, enum=Operator,) - values = proto.RepeatedField(proto.STRING, number=249928994,) - - -class Screenshot(proto.Message): - r"""An instance's screenshot. - Attributes: - contents (str): - [Output Only] The Base64-encoded screenshot data. - kind (str): - [Output Only] Type of the resource. Always - compute#screenshot for the screenshots. - """ - - contents = proto.Field(proto.STRING, number=506419994, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - - -class SecurityPoliciesWafConfig(proto.Message): - r""" - Attributes: - waf_rules (google.cloud.compute_v1.types.PreconfiguredWafSet): - - """ - - waf_rules = proto.Field( - proto.MESSAGE, number=74899924, optional=True, message="PreconfiguredWafSet", - ) - - -class SecurityPoliciesListPreconfiguredExpressionSetsResponse(proto.Message): - r""" - Attributes: - preconfigured_expression_sets (google.cloud.compute_v1.types.SecurityPoliciesWafConfig): - - """ - - preconfigured_expression_sets = proto.Field( - proto.MESSAGE, - number=536200826, - optional=True, - message="SecurityPoliciesWafConfig", - ) - - -class SecurityPolicyRule(proto.Message): - r"""Represents a rule that describes one or more match conditions - along with the action to be taken when traffic matches this - condition (allow or deny). - - Attributes: - action (str): - The Action to perform when the client - connection triggers the rule. Can currently be - either "allow" or "deny()" where valid values - for status are 403, 404, and 502. - description (str): - An optional description of this resource. - Provide this property when you create the - resource. - kind (str): - [Output only] Type of the resource. Always - compute#securityPolicyRule for security policy rules - match (google.cloud.compute_v1.types.SecurityPolicyRuleMatcher): - A match condition that incoming traffic is - evaluated against. If it evaluates to true, the - corresponding 'action' is enforced. - preview (bool): - If set to true, the specified action is not - enforced. - priority (int): - An integer indicating the priority of a rule - in the list. The priority must be a positive - value between 0 and 2147483647. Rules are - evaluated from highest to lowest priority where - 0 is the highest priority and 2147483647 is the - lowest priority. - """ - - action = proto.Field(proto.STRING, number=187661878, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - match = proto.Field( - proto.MESSAGE, - number=103668165, - optional=True, - message="SecurityPolicyRuleMatcher", - ) - preview = proto.Field(proto.BOOL, number=218686408, optional=True,) - priority = proto.Field(proto.INT32, number=445151652, optional=True,) - - -class SecurityPolicy(proto.Message): - r"""Represents a Google Cloud Armor security policy resource. - - Only external backend services that use load balancers can reference - a security policy. For more information, see Google Cloud Armor - security policy overview. (== resource_for - {$api_version}.securityPolicies ==) +class InstanceGroup(proto.Message): + r"""Represents an Instance Group resource. Instance Groups can be + used to configure a target for load balancing. Instance groups + can either be managed or unmanaged. To create managed instance + groups, use the instanceGroupManager or + regionInstanceGroupManager resource instead. Use zonal unmanaged + instance groups if you need to apply load balancing to groups of + heterogeneous instances or if you need to manage the instances + yourself. You cannot create regional unmanaged instance groups. + For more information, read Instance groups. Attributes: creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. + [Output Only] The creation timestamp for this instance group + in RFC3339 text format. description (str): An optional description of this resource. Provide this property when you create the resource. fingerprint (str): - Specifies a fingerprint for this resource, - which is essentially a hash of the metadata's - contents and used for optimistic locking. The - fingerprint is initially generated by Compute - Engine and changes after every request to modify - or update metadata. You must always provide an - up-to-date fingerprint hash in order to update - or change metadata, otherwise the request will - fail with error 412 conditionNotMet. To see the - latest fingerprint, make get() request to the - security policy. + [Output Only] The fingerprint of the named ports. The system + uses this fingerprint to detect conflicts when multiple + users change the named ports concurrently. id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. + [Output Only] A unique identifier for this instance group, + generated by the server. kind (str): - [Output only] Type of the resource. Always - compute#securityPolicyfor security policies + [Output Only] The resource type, which is always + compute#instanceGroup for instance groups. name (str): - Name of the resource. Provided by the client when the - resource is created. The name must be 1-63 characters long, - and comply with RFC1035. Specifically, the name must be 1-63 - characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. - rules (Sequence[google.cloud.compute_v1.types.SecurityPolicyRule]): - A list of rules that belong to this policy. There must - always be a default rule (rule with priority 2147483647 and - match "*"). If no rules are provided when creating a - security policy, a default rule with action "allow" will be - added. + The name of the instance group. The name must + be 1-63 characters long, and comply with + RFC1035. + named_ports (Sequence[google.cloud.compute_v1.types.NamedPort]): + Assigns a name to a port number. For example: {name: "http", + port: 80} This allows the system to reference ports by the + assigned name instead of a port number. Named ports can also + contain multiple ports. For example: [{name: "http", port: + 80},{name: "http", port: 8080}] Named ports apply to all + instances in this instance group. + network (str): + [Output Only] The URL of the network to which all instances + in the instance group belong. If your instance has multiple + network interfaces, then the network and subnetwork fields + only refer to the network and subnet used by your primary + interface (nic0). + region (str): + [Output Only] The URL of the region where the instance group + is located (for regional resources). self_link (str): - [Output Only] Server-defined URL for the resource. + [Output Only] The URL for this instance group. The server + generates this URL. + size (int): + [Output Only] The total number of instances in the instance + group. + subnetwork (str): + [Output Only] The URL of the subnetwork to which all + instances in the instance group belong. If your instance has + multiple network interfaces, then the network and subnetwork + fields only refer to the network and subnet used by your + primary interface (nic0). + zone (str): + [Output Only] The URL of the zone where the instance group + is located (for zonal resources). """ creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) @@ -21263,23 +20592,29 @@ class SecurityPolicy(proto.Message): id = proto.Field(proto.UINT64, number=3355, optional=True,) kind = proto.Field(proto.STRING, number=3292052, optional=True,) name = proto.Field(proto.STRING, number=3373707, optional=True,) - rules = proto.RepeatedField( - proto.MESSAGE, number=108873975, message="SecurityPolicyRule", + named_ports = proto.RepeatedField( + proto.MESSAGE, number=427598732, message="NamedPort", ) + network = proto.Field(proto.STRING, number=232872494, optional=True,) + region = proto.Field(proto.STRING, number=138946292, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + size = proto.Field(proto.INT32, number=3530753, optional=True,) + subnetwork = proto.Field(proto.STRING, number=307827694, optional=True,) + zone = proto.Field(proto.STRING, number=3744684, optional=True,) -class SecurityPolicyList(proto.Message): +class InstanceGroupAggregatedList(proto.Message): r""" Attributes: id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.SecurityPolicy]): - A list of SecurityPolicy resources. + items (Sequence[google.cloud.compute_v1.types.InstanceGroupAggregatedList.ItemsEntry]): + A list of InstanceGroupsScopedList resources. kind (str): - [Output Only] Type of resource. Always - compute#securityPolicyList for listsof securityPolicies + [Output Only] The resource type, which is always + compute#instanceGroupAggregatedList for aggregated lists of + instance groups. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -21287,6 +20622,10 @@ class SecurityPolicyList(proto.Message): the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. warning (google.cloud.compute_v1.types.Warning): [Output Only] Informational warning message. """ @@ -21296,369 +20635,369 @@ def raw_page(self): return self id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="SecurityPolicy", + items = proto.MapField( + proto.STRING, + proto.MESSAGE, + number=100526016, + message="InstanceGroupsScopedList", ) kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) warning = proto.Field( proto.MESSAGE, number=50704284, optional=True, message="Warning", ) -class SecurityPolicyReference(proto.Message): - r""" - Attributes: - security_policy (str): - - """ - - security_policy = proto.Field(proto.STRING, number=171082513, optional=True,) - - -class SecurityPolicyRuleMatcher(proto.Message): - r"""Represents a match condition that incoming traffic is - evaluated against. Exactly one field must be specified. - - Attributes: - config (google.cloud.compute_v1.types.SecurityPolicyRuleMatcherConfig): - The configuration options available when specifying - versioned_expr. This field must be specified if - versioned_expr is specified and cannot be specified if - versioned_expr is not specified. - expr (google.cloud.compute_v1.types.Expr): - User defined CEVAL expression. A CEVAL expression is used to - specify match criteria such as origin.ip, source.region_code - and contents in the request header. - versioned_expr (google.cloud.compute_v1.types.SecurityPolicyRuleMatcher.VersionedExpr): - Preconfigured versioned expression. If this field is - specified, config must also be specified. Available - preconfigured expressions along with their requirements are: - SRC_IPS_V1 - must specify the corresponding src_ip_range - field in config. - """ - - class VersionedExpr(proto.Enum): - r"""Preconfigured versioned expression. If this field is specified, - config must also be specified. Available preconfigured expressions - along with their requirements are: SRC_IPS_V1 - must specify the - corresponding src_ip_range field in config. - """ - UNDEFINED_VERSIONED_EXPR = 0 - SRC_IPS_V1 = 70925961 - - config = proto.Field( - proto.MESSAGE, - number=255820610, - optional=True, - message="SecurityPolicyRuleMatcherConfig", - ) - expr = proto.Field(proto.MESSAGE, number=3127797, optional=True, message="Expr",) - versioned_expr = proto.Field( - proto.ENUM, number=322286013, optional=True, enum=VersionedExpr, - ) - - -class SecurityPolicyRuleMatcherConfig(proto.Message): - r""" - Attributes: - src_ip_ranges (Sequence[str]): - CIDR IP address range. Maximum number of src_ip_ranges - allowed is 10. - """ - - src_ip_ranges = proto.RepeatedField(proto.STRING, number=432128083,) - - -class SerialPortOutput(proto.Message): - r"""An instance's serial console output. +class InstanceGroupList(proto.Message): + r"""A list of InstanceGroup resources. Attributes: - contents (str): - [Output Only] The contents of the console output. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.InstanceGroup]): + A list of InstanceGroup resources. kind (str): - [Output Only] Type of the resource. Always - compute#serialPortOutput for serial port output. - next_ (int): - [Output Only] The position of the next byte of content, - regardless of whether the content exists, following the - output returned in the ``contents`` property. Use this value - in the next request as the start parameter. + [Output Only] The resource type, which is always + compute#instanceGroupList for instance group lists. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. self_link (str): [Output Only] Server-defined URL for this resource. - start (int): - The starting byte position of the output that was returned. - This should match the start parameter sent with the request. - If the serial console output exceeds the size of the buffer - (1 MB), older output is overwritten by newer content. The - output start value will indicate the byte position of the - output that was returned, which might be different than the - ``start`` value that was specified in the request. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - contents = proto.Field(proto.STRING, number=506419994, optional=True,) + @property + def raw_page(self): + return self + + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="InstanceGroup", + ) kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_ = proto.Field(proto.INT64, number=3377907, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - start = proto.Field(proto.INT64, number=109757538, optional=True,) - - -class ShieldedInstanceIdentityEntry(proto.Message): - r"""A Shielded Instance Identity Entry. - Attributes: - ek_cert (str): - A PEM-encoded X.509 certificate. This field - can be empty. - ek_pub (str): - A PEM-encoded public key. - """ + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) - ek_cert = proto.Field(proto.STRING, number=450178589, optional=True,) - ek_pub = proto.Field(proto.STRING, number=308947940, optional=True,) +class InstanceGroupManager(proto.Message): + r"""Represents a Managed Instance Group resource. An instance + group is a collection of VM instances that you can manage as a + single entity. For more information, read Instance groups. For + zonal Managed Instance Group, use the instanceGroupManagers + resource. For regional Managed Instance Group, use the + regionInstanceGroupManagers resource. -class ShieldedInstanceIdentity(proto.Message): - r"""A shielded Instance identity entry. Attributes: - encryption_key (google.cloud.compute_v1.types.ShieldedInstanceIdentityEntry): - An Endorsement Key (EK) made by the RSA 2048 - algorithm issued to the Shielded Instance's - vTPM. + auto_healing_policies (Sequence[google.cloud.compute_v1.types.InstanceGroupManagerAutoHealingPolicy]): + The autohealing policy for this managed + instance group. You can specify only one value. + base_instance_name (str): + The base instance name to use for instances + in this group. The value must be 1-58 characters + long. Instances are named by appending a hyphen + and a random four-character string to the base + instance name. The base instance name must + comply with RFC1035. + creation_timestamp (str): + [Output Only] The creation timestamp for this managed + instance group in RFC3339 text format. + current_actions (google.cloud.compute_v1.types.InstanceGroupManagerActionsSummary): + [Output Only] The list of instance actions and the number of + instances in this managed instance group that are scheduled + for each of those actions. + description (str): + An optional description of this resource. + distribution_policy (google.cloud.compute_v1.types.DistributionPolicy): + Policy specifying the intended distribution + of managed instances across zones in a regional + managed instance group. + fingerprint (str): + Fingerprint of this resource. This field may + be used in optimistic locking. It will be + ignored when inserting an InstanceGroupManager. + An up-to-date fingerprint must be provided in + order to update the InstanceGroupManager, + otherwise the request will fail with error 412 + conditionNotMet. To see the latest fingerprint, + make a get() request to retrieve an + InstanceGroupManager. + id (int): + [Output Only] A unique identifier for this resource type. + The server generates this identifier. + instance_group (str): + [Output Only] The URL of the Instance Group resource. + instance_template (str): + The URL of the instance template that is + specified for this managed instance group. The + group uses this template to create all new + instances in the managed instance group. The + templates for existing instances in the group do + not change unless you run recreateInstances, run + applyUpdatesToInstances, or set the group's + updatePolicy.type to PROACTIVE. kind (str): - [Output Only] Type of the resource. Always - compute#shieldedInstanceIdentity for shielded Instance - identity entry. - signing_key (google.cloud.compute_v1.types.ShieldedInstanceIdentityEntry): - An Attestation Key (AK) made by the RSA 2048 - algorithm issued to the Shielded Instance's - vTPM. + [Output Only] The resource type, which is always + compute#instanceGroupManager for managed instance groups. + name (str): + The name of the managed instance group. The + name must be 1-63 characters long, and comply + with RFC1035. + named_ports (Sequence[google.cloud.compute_v1.types.NamedPort]): + Named ports configured for the Instance + Groups complementary to this Instance Group + Manager. + region (str): + [Output Only] The URL of the region where the managed + instance group resides (for regional resources). + self_link (str): + [Output Only] The URL for this managed instance group. The + server defines this URL. + stateful_policy (google.cloud.compute_v1.types.StatefulPolicy): + Stateful configuration for this Instanced + Group Manager + status (google.cloud.compute_v1.types.InstanceGroupManagerStatus): + [Output Only] The status of this managed instance group. + target_pools (Sequence[str]): + The URLs for all TargetPool resources to + which instances in the instanceGroup field are + added. The target pools automatically apply to + all of the instances in the managed instance + group. + target_size (int): + The target number of running instances for + this managed instance group. You can reduce this + number by using the instanceGroupManager + deleteInstances or abandonInstances methods. + Resizing the group also changes this number. + update_policy (google.cloud.compute_v1.types.InstanceGroupManagerUpdatePolicy): + The update policy for this managed instance + group. + versions (Sequence[google.cloud.compute_v1.types.InstanceGroupManagerVersion]): + Specifies the instance templates used by this + managed instance group to create instances. Each + version is defined by an instanceTemplate and a + name. Every version can appear at most once per + instance group. This field overrides the top- + level instanceTemplate field. Read more about + the relationships between these fields. Exactly + one version must leave the targetSize field + unset. That version will be applied to all + remaining instances. For more information, read + about canary updates. + zone (str): + [Output Only] The URL of a zone where the managed instance + group is located (for zonal resources). """ - encryption_key = proto.Field( + auto_healing_policies = proto.RepeatedField( proto.MESSAGE, - number=488268707, + number=456799109, + message="InstanceGroupManagerAutoHealingPolicy", + ) + base_instance_name = proto.Field(proto.STRING, number=389106439, optional=True,) + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + current_actions = proto.Field( + proto.MESSAGE, + number=164045879, optional=True, - message="ShieldedInstanceIdentityEntry", + message="InstanceGroupManagerActionsSummary", + ) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + distribution_policy = proto.Field( + proto.MESSAGE, number=534558541, optional=True, message="DistributionPolicy", ) + fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + instance_group = proto.Field(proto.STRING, number=81095253, optional=True,) + instance_template = proto.Field(proto.STRING, number=309248228, optional=True,) kind = proto.Field(proto.STRING, number=3292052, optional=True,) - signing_key = proto.Field( + name = proto.Field(proto.STRING, number=3373707, optional=True,) + named_ports = proto.RepeatedField( + proto.MESSAGE, number=427598732, message="NamedPort", + ) + region = proto.Field(proto.STRING, number=138946292, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + stateful_policy = proto.Field( + proto.MESSAGE, number=47538565, optional=True, message="StatefulPolicy", + ) + status = proto.Field( proto.MESSAGE, - number=320948261, + number=181260274, optional=True, - message="ShieldedInstanceIdentityEntry", + message="InstanceGroupManagerStatus", ) + target_pools = proto.RepeatedField(proto.STRING, number=336072617,) + target_size = proto.Field(proto.INT32, number=62880239, optional=True,) + update_policy = proto.Field( + proto.MESSAGE, + number=175809896, + optional=True, + message="InstanceGroupManagerUpdatePolicy", + ) + versions = proto.RepeatedField( + proto.MESSAGE, number=162430619, message="InstanceGroupManagerVersion", + ) + zone = proto.Field(proto.STRING, number=3744684, optional=True,) -class SignedUrlKey(proto.Message): - r"""Represents a customer-supplied Signing Key used by Cloud CDN - Signed URLs - - Attributes: - key_name (str): - Name of the key. The name must be 1-63 characters long, and - comply with RFC1035. Specifically, the name must be 1-63 - characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. - key_value (str): - 128-bit key value used for signing the URL. - The key value must be a valid RFC 4648 Section 5 - base64url encoded string. - """ - - key_name = proto.Field(proto.STRING, number=500938859, optional=True,) - key_value = proto.Field(proto.STRING, number=504106897, optional=True,) - - -class Snapshot(proto.Message): - r"""Represents a Persistent Disk Snapshot resource. - - You can use snapshots to back up data on a regular interval. For - more information, read Creating persistent disk snapshots. (== - resource_for {$api_version}.snapshots ==) - +class InstanceGroupManagerActionsSummary(proto.Message): + r""" Attributes: - auto_created (bool): - [Output Only] Set to true if snapshots are automatically - created by applying resource policy on the target disk. - chain_name (str): - Creates the new snapshot in the snapshot - chain labeled with the specified name. The chain - name must be 1-63 characters long and comply - with RFC1035. This is an uncommon option only - for advanced service owners who needs to create - separate snapshot chains, for example, for - chargeback tracking. When you describe your - snapshot resource, this field is visible only if - it has a non-empty value. - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - description (str): - An optional description of this resource. - Provide this property when you create the - resource. - disk_size_gb (int): - [Output Only] Size of the source disk, specified in GB. - download_bytes (int): - [Output Only] Number of bytes downloaded to restore a - snapshot to a disk. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - kind (str): - [Output Only] Type of the resource. Always compute#snapshot - for Snapshot resources. - label_fingerprint (str): - A fingerprint for the labels being applied to - this snapshot, which is essentially a hash of - the labels set used for optimistic locking. The - fingerprint is initially generated by Compute - Engine and changes after every request to modify - or update labels. You must always provide an up- - to-date fingerprint hash in order to update or - change labels, otherwise the request will fail - with error 412 conditionNotMet. To see the - latest fingerprint, make a get() request to - retrieve a snapshot. - labels (Sequence[google.cloud.compute_v1.types.Snapshot.LabelsEntry]): - Labels to apply to this snapshot. These can - be later modified by the setLabels method. Label - values may be empty. - license_codes (Sequence[int]): - [Output Only] Integer license codes indicating which - licenses are attached to this snapshot. - licenses (Sequence[str]): - [Output Only] A list of public visible licenses that apply - to this snapshot. This can be because the original image had - licenses attached (such as a Windows image). - location_hint (str): - An opaque location hint used to place the - snapshot close to other resources. This field is - for use by internal tools that use the public - API. - name (str): - Name of the resource; provided by the client when the - resource is created. The name must be 1-63 characters long, - and comply with RFC1035. Specifically, the name must be 1-63 - characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. - satisfies_pzs (bool): - [Output Only] Reserved for future use. - self_link (str): - [Output Only] Server-defined URL for the resource. - snapshot_encryption_key (google.cloud.compute_v1.types.CustomerEncryptionKey): - Encrypts the snapshot using a customer- - upplied encryption key. - After you encrypt a snapshot using a customer- - supplied key, you must provide the same key if - you use the snapshot later. For example, you - must provide the encryption key when you create - a disk from the encrypted snapshot in a future - request. - Customer-supplied encryption keys do not protect - access to metadata of the snapshot. - If you do not provide an encryption key when - creating the snapshot, then the snapshot will be - encrypted using an automatically generated key - and you do not need to provide a key to use the - snapshot later. - source_disk (str): - The source disk used to create this snapshot. - source_disk_encryption_key (google.cloud.compute_v1.types.CustomerEncryptionKey): - The customer-supplied encryption key of the - source disk. Required if the source disk is - protected by a customer-supplied encryption key. - source_disk_id (str): - [Output Only] The ID value of the disk used to create this - snapshot. This value may be used to determine whether the - snapshot was taken from the current or a previous instance - of a given disk name. - status (google.cloud.compute_v1.types.Snapshot.Status): - [Output Only] The status of the snapshot. This can be - CREATING, DELETING, FAILED, READY, or UPLOADING. - storage_bytes (int): - [Output Only] A size of the storage used by the snapshot. As - snapshots share storage, this number is expected to change - with snapshot creation/deletion. - storage_bytes_status (google.cloud.compute_v1.types.Snapshot.StorageBytesStatus): - [Output Only] An indicator whether storageBytes is in a - stable state or it is being adjusted as a result of shared - storage reallocation. This status can either be UPDATING, - meaning the size of the snapshot is being updated, or - UP_TO_DATE, meaning the size of the snapshot is up-to-date. - storage_locations (Sequence[str]): - Cloud Storage bucket storage location of the - snapshot (regional or multi-regional). + abandoning (int): + [Output Only] The total number of instances in the managed + instance group that are scheduled to be abandoned. + Abandoning an instance removes it from the managed instance + group without deleting it. + creating (int): + [Output Only] The number of instances in the managed + instance group that are scheduled to be created or are + currently being created. If the group fails to create any of + these instances, it tries again until it creates the + instance successfully. If you have disabled creation + retries, this field will not be populated; instead, the + creatingWithoutRetries field will be populated. + creating_without_retries (int): + [Output Only] The number of instances that the managed + instance group will attempt to create. The group attempts to + create each instance only once. If the group fails to create + any of these instances, it decreases the group's targetSize + value accordingly. + deleting (int): + [Output Only] The number of instances in the managed + instance group that are scheduled to be deleted or are + currently being deleted. + none (int): + [Output Only] The number of instances in the managed + instance group that are running and have no scheduled + actions. + recreating (int): + [Output Only] The number of instances in the managed + instance group that are scheduled to be recreated or are + currently being being recreated. Recreating an instance + deletes the existing root persistent disk and creates a new + disk from the image that is defined in the instance + template. + refreshing (int): + [Output Only] The number of instances in the managed + instance group that are being reconfigured with properties + that do not require a restart or a recreate action. For + example, setting or removing target pools for the instance. + restarting (int): + [Output Only] The number of instances in the managed + instance group that are scheduled to be restarted or are + currently being restarted. + verifying (int): + [Output Only] The number of instances in the managed + instance group that are being verified. See the + managedInstances[].currentAction property in the + listManagedInstances method documentation. """ - class Status(proto.Enum): - r"""[Output Only] The status of the snapshot. This can be CREATING, - DELETING, FAILED, READY, or UPLOADING. - """ - UNDEFINED_STATUS = 0 - CREATING = 455564985 - DELETING = 528602024 - FAILED = 455706685 - READY = 77848963 - UPLOADING = 267603489 + abandoning = proto.Field(proto.INT32, number=440023373, optional=True,) + creating = proto.Field(proto.INT32, number=209809081, optional=True,) + creating_without_retries = proto.Field( + proto.INT32, number=369916745, optional=True, + ) + deleting = proto.Field(proto.INT32, number=282846120, optional=True,) + none = proto.Field(proto.INT32, number=3387192, optional=True,) + recreating = proto.Field(proto.INT32, number=339057132, optional=True,) + refreshing = proto.Field(proto.INT32, number=215044903, optional=True,) + restarting = proto.Field(proto.INT32, number=372312947, optional=True,) + verifying = proto.Field(proto.INT32, number=451612873, optional=True,) - class StorageBytesStatus(proto.Enum): - r"""[Output Only] An indicator whether storageBytes is in a stable state - or it is being adjusted as a result of shared storage reallocation. - This status can either be UPDATING, meaning the size of the snapshot - is being updated, or UP_TO_DATE, meaning the size of the snapshot is - up-to-date. - """ - UNDEFINED_STORAGE_BYTES_STATUS = 0 - UPDATING = 494614342 - UP_TO_DATE = 101306702 - auto_created = proto.Field(proto.BOOL, number=463922264, optional=True,) - chain_name = proto.Field(proto.STRING, number=68644169, optional=True,) - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - disk_size_gb = proto.Field(proto.INT64, number=316263735, optional=True,) - download_bytes = proto.Field(proto.INT64, number=435054068, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) +class InstanceGroupManagerAggregatedList(proto.Message): + r""" + Attributes: + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.InstanceGroupManagerAggregatedList.ItemsEntry]): + A list of InstanceGroupManagersScopedList + resources. + kind (str): + [Output Only] The resource type, which is always + compute#instanceGroupManagerAggregatedList for an aggregated + list of managed instance groups. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. + """ + + @property + def raw_page(self): + return self + + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.MapField( + proto.STRING, + proto.MESSAGE, + number=100526016, + message="InstanceGroupManagersScopedList", + ) kind = proto.Field(proto.STRING, number=3292052, optional=True,) - label_fingerprint = proto.Field(proto.STRING, number=178124825, optional=True,) - labels = proto.MapField(proto.STRING, proto.STRING, number=500195327,) - license_codes = proto.RepeatedField(proto.INT64, number=45482664,) - licenses = proto.RepeatedField(proto.STRING, number=337642578,) - location_hint = proto.Field(proto.STRING, number=350519505, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - satisfies_pzs = proto.Field(proto.BOOL, number=480964267, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - snapshot_encryption_key = proto.Field( - proto.MESSAGE, number=43334526, optional=True, message="CustomerEncryptionKey", - ) - source_disk = proto.Field(proto.STRING, number=451753793, optional=True,) - source_disk_encryption_key = proto.Field( - proto.MESSAGE, number=531501153, optional=True, message="CustomerEncryptionKey", - ) - source_disk_id = proto.Field(proto.STRING, number=454190809, optional=True,) - status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) - storage_bytes = proto.Field(proto.INT64, number=424631719, optional=True,) - storage_bytes_status = proto.Field( - proto.ENUM, number=490739082, optional=True, enum=StorageBytesStatus, + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", ) - storage_locations = proto.RepeatedField(proto.STRING, number=328005274,) -class SnapshotList(proto.Message): - r"""Contains a list of Snapshot resources. +class InstanceGroupManagerAutoHealingPolicy(proto.Message): + r""" + Attributes: + health_check (str): + The URL for the health check that signals + autohealing. + initial_delay_sec (int): + The number of seconds that the managed instance group waits + before it applies autohealing policies to new instances or + recently recreated instances. This initial delay allows + instances to initialize and run their startup scripts before + the instance group determines that they are UNHEALTHY. This + prevents the managed instance group from recreating its + instances prematurely. This value must be from range [0, + 3600]. + """ + + health_check = proto.Field(proto.STRING, number=308876645, optional=True,) + initial_delay_sec = proto.Field(proto.INT32, number=263207002, optional=True,) + + +class InstanceGroupManagerList(proto.Message): + r"""[Output Only] A list of managed instance groups. Attributes: id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.Snapshot]): - A list of Snapshot resources. + items (Sequence[google.cloud.compute_v1.types.InstanceGroupManager]): + A list of InstanceGroupManager resources. kind (str): - Type of resource. + [Output Only] The resource type, which is always + compute#instanceGroupManagerList for a list of managed + instance groups. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -21677,7 +21016,9 @@ def raw_page(self): return self id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Snapshot",) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="InstanceGroupManager", + ) kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) @@ -21686,203 +21027,327 @@ def raw_page(self): ) -class SslCertificateManagedSslCertificate(proto.Message): - r"""Configuration and status of a managed SSL certificate. +class InstanceGroupManagerStatus(proto.Message): + r""" Attributes: - domain_status (Sequence[google.cloud.compute_v1.types.SslCertificateManagedSslCertificate.DomainStatusEntry]): - [Output only] Detailed statuses of the domains specified for - managed certificate resource. - domains (Sequence[str]): - The domains for which a managed SSL certificate will be - generated. Each Google-managed SSL certificate supports up - to the `maximum number of domains per Google-managed SSL - certificate `__. - status (google.cloud.compute_v1.types.SslCertificateManagedSslCertificate.Status): - [Output only] Status of the managed certificate resource. + autoscaler (str): + [Output Only] The URL of the Autoscaler that targets this + instance group manager. + is_stable (bool): + [Output Only] A bit indicating whether the managed instance + group is in a stable state. A stable state means that: none + of the instances in the managed instance group is currently + undergoing any type of change (for example, creation, + restart, or deletion); no future changes are scheduled for + instances in the managed instance group; and the managed + instance group itself is not being modified. + stateful (google.cloud.compute_v1.types.InstanceGroupManagerStatusStateful): + [Output Only] Stateful status of the given Instance Group + Manager. + version_target (google.cloud.compute_v1.types.InstanceGroupManagerStatusVersionTarget): + [Output Only] A status of consistency of Instances' versions + with their target version specified by version field on + Instance Group Manager. """ - class Status(proto.Enum): - r"""[Output only] Status of the managed certificate resource.""" - UNDEFINED_STATUS = 0 - ACTIVE = 314733318 - MANAGED_CERTIFICATE_STATUS_UNSPECIFIED = 474800850 - PROVISIONING = 290896621 - PROVISIONING_FAILED = 76813775 - PROVISIONING_FAILED_PERMANENTLY = 275036203 - RENEWAL_FAILED = 434659076 - - domain_status = proto.MapField(proto.STRING, proto.STRING, number=360305613,) - domains = proto.RepeatedField(proto.STRING, number=226935855,) - status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) + autoscaler = proto.Field(proto.STRING, number=517258967, optional=True,) + is_stable = proto.Field(proto.BOOL, number=108410864, optional=True,) + stateful = proto.Field( + proto.MESSAGE, + number=244462412, + optional=True, + message="InstanceGroupManagerStatusStateful", + ) + version_target = proto.Field( + proto.MESSAGE, + number=289386200, + optional=True, + message="InstanceGroupManagerStatusVersionTarget", + ) -class SslCertificateSelfManagedSslCertificate(proto.Message): - r"""Configuration and status of a self-managed SSL certificate. +class InstanceGroupManagerStatusStateful(proto.Message): + r""" Attributes: - certificate (str): - A local certificate file. The certificate - must be in PEM format. The certificate chain - must be no greater than 5 certs long. The chain - must include at least one intermediate cert. - private_key (str): - A write-only private key in PEM format. Only - insert requests will include this field. + has_stateful_config (bool): + [Output Only] A bit indicating whether the managed instance + group has stateful configuration, that is, if you have + configured any items in a stateful policy or in per-instance + configs. The group might report that it has no stateful + config even when there is still some preserved state on a + managed instance, for example, if you have deleted all PICs + but not yet applied those deletions. + per_instance_configs (google.cloud.compute_v1.types.InstanceGroupManagerStatusStatefulPerInstanceConfigs): + [Output Only] Status of per-instance configs on the + instance. """ - certificate = proto.Field(proto.STRING, number=341787031, optional=True,) - private_key = proto.Field(proto.STRING, number=361331107, optional=True,) + has_stateful_config = proto.Field(proto.BOOL, number=110474224, optional=True,) + per_instance_configs = proto.Field( + proto.MESSAGE, + number=526265001, + optional=True, + message="InstanceGroupManagerStatusStatefulPerInstanceConfigs", + ) -class SslCertificate(proto.Message): - r"""Represents an SSL Certificate resource. +class InstanceGroupManagerStatusStatefulPerInstanceConfigs(proto.Message): + r""" + Attributes: + all_effective (bool): + A bit indicating if all of the group's per- + nstance configs (listed in the output of a + listPerInstanceConfigs API call) have status + EFFECTIVE or there are no per-instance-configs. + """ - Google Compute Engine has two SSL Certificate resources: + all_effective = proto.Field(proto.BOOL, number=516540553, optional=True,) + + +class InstanceGroupManagerStatusVersionTarget(proto.Message): + r""" + Attributes: + is_reached (bool): + [Output Only] A bit indicating whether version target has + been reached in this managed instance group, i.e. all + instances are in their target version. Instances' target + version are specified by version field on Instance Group + Manager. + """ - - `Global `__ - \* - `Regional `__ + is_reached = proto.Field(proto.BOOL, number=433209149, optional=True,) - The sslCertificates are used by: - - external HTTPS load balancers - - SSL proxy load balancers +class InstanceGroupManagerUpdatePolicy(proto.Message): + r""" + Attributes: + instance_redistribution_type (str): + The instance redistribution policy for + regional managed instance groups. Valid values + are: - PROACTIVE (default): The group attempts + to maintain an even distribution of VM instances + across zones in the region. - NONE: For non- + autoscaled groups, proactive redistribution is + disabled. + max_surge (google.cloud.compute_v1.types.FixedOrPercent): + The maximum number of instances that can be + created above the specified targetSize during + the update process. This value can be either a + fixed number or, if the group has 10 or more + instances, a percentage. If you set a + percentage, the number of instances is rounded + if necessary. The default value for maxSurge is + a fixed value equal to the number of zones in + which the managed instance group operates. At + least one of either maxSurge or maxUnavailable + must be greater than 0. Learn more about + maxSurge. + max_unavailable (google.cloud.compute_v1.types.FixedOrPercent): + The maximum number of instances that can be + unavailable during the update process. An + instance is considered available if all of the + following conditions are satisfied: - The + instance's status is RUNNING. - If there is a + health check on the instance group, the + instance's health check status must be HEALTHY + at least once. If there is no health check on + the group, then the instance only needs to have + a status of RUNNING to be considered available. + This value can be either a fixed number or, if + the group has 10 or more instances, a + percentage. If you set a percentage, the number + of instances is rounded if necessary. The + default value for maxUnavailable is a fixed + value equal to the number of zones in which the + managed instance group operates. At least one of + either maxSurge or maxUnavailable must be + greater than 0. Learn more about maxUnavailable. + minimal_action (str): + Minimal action to be taken on an instance. + You can specify either RESTART to restart + existing instances or REPLACE to delete and + create new instances from the target template. + If you specify a RESTART, the Updater will + attempt to perform that action only. However, if + the Updater determines that the minimal action + you specify is not enough to perform the update, + it might perform a more disruptive action. + replacement_method (str): + What action should be used to replace instances. See + minimal_action.REPLACE + type_ (str): + The type of update process. You can specify + either PROACTIVE so that the instance group + manager proactively executes actions in order to + bring instances to their target versions or + OPPORTUNISTIC so that no action is proactively + executed but the update will be performed as + part of other actions (for example, resizes or + recreateInstances calls). + """ - The regionSslCertificates are used by internal HTTPS load balancers. + instance_redistribution_type = proto.Field( + proto.STRING, number=292630424, optional=True, + ) + max_surge = proto.Field( + proto.MESSAGE, number=302572691, optional=True, message="FixedOrPercent", + ) + max_unavailable = proto.Field( + proto.MESSAGE, number=404940277, optional=True, message="FixedOrPercent", + ) + minimal_action = proto.Field(proto.STRING, number=270567060, optional=True,) + replacement_method = proto.Field(proto.STRING, number=505931694, optional=True,) + type_ = proto.Field(proto.STRING, number=3575610, optional=True,) - Optionally, certificate file contents that you upload can contain a - set of up to five PEM-encoded certificates. The API call creates an - object (sslCertificate) that holds this data. You can use SSL keys - and certificates to secure connections to a load balancer. For more - information, read Creating and using SSL certificates, SSL - certificates quotas and limits, and Troubleshooting SSL - certificates. (== resource_for {$api_version}.sslCertificates ==) - (== resource_for {$api_version}.regionSslCertificates ==) +class InstanceGroupManagerVersion(proto.Message): + r""" Attributes: - certificate (str): - A value read into memory from a certificate - file. The certificate file must be in PEM - format. The certificate chain must be no greater - than 5 certs long. The chain must include at - least one intermediate cert. - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - description (str): - An optional description of this resource. - Provide this property when you create the - resource. - expire_time (str): - [Output Only] Expire time of the certificate. RFC3339 - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - kind (str): - [Output Only] Type of the resource. Always - compute#sslCertificate for SSL certificates. - managed (google.cloud.compute_v1.types.SslCertificateManagedSslCertificate): - Configuration and status of a managed SSL - certificate. + instance_template (str): + The URL of the instance template that is specified for this + managed instance group. The group uses this template to + create new instances in the managed instance group until the + ``targetSize`` for this version is reached. The templates + for existing instances in the group do not change unless you + run recreateInstances, run applyUpdatesToInstances, or set + the group's updatePolicy.type to PROACTIVE; in those cases, + existing instances are updated until the ``targetSize`` for + this version is reached. name (str): - Name of the resource. Provided by the client when the - resource is created. The name must be 1-63 characters long, - and comply with RFC1035. Specifically, the name must be 1-63 - characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. - private_key (str): - A value read into memory from a write-only - private key file. The private key file must be - in PEM format. For security, only insert - requests include this field. - region (str): - [Output Only] URL of the region where the regional SSL - Certificate resides. This field is not applicable to global - SSL Certificate. - self_link (str): - [Output only] Server-defined URL for the resource. - self_managed (google.cloud.compute_v1.types.SslCertificateSelfManagedSslCertificate): - Configuration and status of a self-managed - SSL certificate. - subject_alternative_names (Sequence[str]): - [Output Only] Domains associated with the certificate via - Subject Alternative Name. - type_ (google.cloud.compute_v1.types.SslCertificate.Type): - (Optional) Specifies the type of SSL certificate, either - "SELF_MANAGED" or "MANAGED". If not specified, the - certificate is self-managed and the fields certificate and - private_key are used. + Name of the version. Unique among all + versions in the scope of this managed instance + group. + target_size (google.cloud.compute_v1.types.FixedOrPercent): + Specifies the intended number of instances to be created + from the instanceTemplate. The final number of instances + created from the template will be equal to: - If expressed + as a fixed number, the minimum of either targetSize.fixed or + instanceGroupManager.targetSize is used. - if expressed as a + percent, the targetSize would be (targetSize.percent/100 \* + InstanceGroupManager.targetSize) If there is a remainder, + the number is rounded. If unset, this version will update + any remaining instances not updated by another version. Read + Starting a canary update for more information. """ - class Type(proto.Enum): - r"""(Optional) Specifies the type of SSL certificate, either - "SELF_MANAGED" or "MANAGED". If not specified, the certificate is - self-managed and the fields certificate and private_key are used. - """ - UNDEFINED_TYPE = 0 - MANAGED = 479501183 - SELF_MANAGED = 434437516 - TYPE_UNSPECIFIED = 437714322 + instance_template = proto.Field(proto.STRING, number=309248228, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + target_size = proto.Field( + proto.MESSAGE, number=62880239, optional=True, message="FixedOrPercent", + ) - certificate = proto.Field(proto.STRING, number=341787031, optional=True,) - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - expire_time = proto.Field(proto.STRING, number=440691181, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - managed = proto.Field( - proto.MESSAGE, - number=298389407, - optional=True, - message="SslCertificateManagedSslCertificate", + +class InstanceGroupManagersAbandonInstancesRequest(proto.Message): + r""" + Attributes: + instances (Sequence[str]): + The URLs of one or more instances to abandon. This can be a + full URL or a partial URL, such as + zones/[ZONE]/instances/[INSTANCE_NAME]. + """ + + instances = proto.RepeatedField(proto.STRING, number=29097598,) + + +class InstanceGroupManagersApplyUpdatesRequest(proto.Message): + r"""InstanceGroupManagers.applyUpdatesToInstances + Attributes: + all_instances (bool): + Flag to update all instances instead of + specified list of ���instances���. If the flag + is set to true then the instances may not be + specified in the request. + instances (Sequence[str]): + The list of URLs of one or more instances for which you want + to apply updates. Each URL can be a full URL or a partial + URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + minimal_action (str): + The minimal action that you want to perform + on each instance during the update: - REPLACE: + At minimum, delete the instance and create it + again. - RESTART: Stop the instance and start it + again. - REFRESH: Do not stop the instance. - + NONE: Do not disrupt the instance at all. By + default, the minimum action is NONE. If your + update requires a more disruptive action than + you set with this flag, the necessary action is + performed to execute the update. + most_disruptive_allowed_action (str): + The most disruptive action that you want to + perform on each instance during the update: - + REPLACE: Delete the instance and create it + again. - RESTART: Stop the instance and start it + again. - REFRESH: Do not stop the instance. - + NONE: Do not disrupt the instance at all. By + default, the most disruptive allowed action is + REPLACE. If your update requires a more + disruptive action than you set with this flag, + the update request will fail. + """ + + all_instances = proto.Field(proto.BOOL, number=403676512, optional=True,) + instances = proto.RepeatedField(proto.STRING, number=29097598,) + minimal_action = proto.Field(proto.STRING, number=270567060, optional=True,) + most_disruptive_allowed_action = proto.Field( + proto.STRING, number=66103053, optional=True, ) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - private_key = proto.Field(proto.STRING, number=361331107, optional=True,) - region = proto.Field(proto.STRING, number=138946292, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - self_managed = proto.Field( - proto.MESSAGE, - number=329284012, - optional=True, - message="SslCertificateSelfManagedSslCertificate", + + +class InstanceGroupManagersCreateInstancesRequest(proto.Message): + r"""InstanceGroupManagers.createInstances + Attributes: + instances (Sequence[google.cloud.compute_v1.types.PerInstanceConfig]): + [Required] List of specifications of per-instance configs. + """ + + instances = proto.RepeatedField( + proto.MESSAGE, number=29097598, message="PerInstanceConfig", ) - subject_alternative_names = proto.RepeatedField(proto.STRING, number=528807907,) - type_ = proto.Field(proto.ENUM, number=3575610, optional=True, enum=Type,) -class SslCertificatesScopedList(proto.Message): +class InstanceGroupManagersDeleteInstancesRequest(proto.Message): r""" Attributes: - ssl_certificates (Sequence[google.cloud.compute_v1.types.SslCertificate]): - List of SslCertificates contained in this - scope. - warning (google.cloud.compute_v1.types.Warning): - Informational warning which replaces the list - of backend services when the list is empty. + instances (Sequence[str]): + The URLs of one or more instances to delete. This can be a + full URL or a partial URL, such as + zones/[ZONE]/instances/[INSTANCE_NAME]. + skip_instances_on_validation_error (bool): + Specifies whether the request should proceed despite the + inclusion of instances that are not members of the group or + that are already in the process of being deleted or + abandoned. If this field is set to ``false`` and such an + instance is specified in the request, the operation fails. + The operation always fails if the request contains a + malformed instance URL or a reference to an instance that + exists in a zone or region other than the group's zone or + region. """ - ssl_certificates = proto.RepeatedField( - proto.MESSAGE, number=366006543, message="SslCertificate", - ) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + instances = proto.RepeatedField(proto.STRING, number=29097598,) + skip_instances_on_validation_error = proto.Field( + proto.BOOL, number=40631073, optional=True, ) -class SslCertificateAggregatedList(proto.Message): +class InstanceGroupManagersDeletePerInstanceConfigsReq(proto.Message): + r"""InstanceGroupManagers.deletePerInstanceConfigs + Attributes: + names (Sequence[str]): + The list of instance names for which we want + to delete per-instance configs on this managed + instance group. + """ + + names = proto.RepeatedField(proto.STRING, number=104585032,) + + +class InstanceGroupManagersListErrorsResponse(proto.Message): r""" Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.SslCertificateAggregatedList.ItemsEntry]): - A list of SslCertificatesScopedList - resources. - kind (str): - [Output Only] Type of resource. Always - compute#sslCertificateAggregatedList for lists of SSL - Certificates. + items (Sequence[google.cloud.compute_v1.types.InstanceManagedByIgmError]): + [Output Only] The list of errors of the managed instance + group. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -21890,44 +21355,24 @@ class SslCertificateAggregatedList(proto.Message): the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - unreachables (Sequence[str]): - [Output Only] Unreachable resources. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. """ @property def raw_page(self): return self - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.MapField( - proto.STRING, - proto.MESSAGE, - number=100526016, - message="SslCertificatesScopedList", + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="InstanceManagedByIgmError", ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - unreachables = proto.RepeatedField(proto.STRING, number=243372063,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) -class SslCertificateList(proto.Message): - r"""Contains a list of SslCertificate resources. +class InstanceGroupManagersListManagedInstancesResponse(proto.Message): + r""" Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.SslCertificate]): - A list of SslCertificate resources. - kind (str): - Type of resource. + managed_instances (Sequence[google.cloud.compute_v1.types.ManagedInstance]): + [Output Only] The list of instances in the managed instance + group. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -21935,145 +21380,23 @@ class SslCertificateList(proto.Message): the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. """ @property def raw_page(self): return self - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="SslCertificate", + managed_instances = proto.RepeatedField( + proto.MESSAGE, number=336219614, message="ManagedInstance", ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) - - -class SslPolicy(proto.Message): - r"""Represents an SSL Policy resource. - - Use SSL policies to control the SSL features, such as versions and - cipher suites, offered by an HTTPS or SSL Proxy load balancer. For - more information, read SSL Policy Concepts. (== resource_for - {$api_version}.sslPolicies ==) - - Attributes: - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - custom_features (Sequence[str]): - A list of features enabled when the selected - profile is CUSTOM. The - method returns the set - of features that can be specified in this list. - This field must be empty if the profile is not - CUSTOM. - description (str): - An optional description of this resource. - Provide this property when you create the - resource. - enabled_features (Sequence[str]): - [Output Only] The list of features enabled in the SSL - policy. - fingerprint (str): - Fingerprint of this resource. A hash of the - contents stored in this object. This field is - used in optimistic locking. This field will be - ignored when inserting a SslPolicy. An up-to- - date fingerprint must be provided in order to - update the SslPolicy, otherwise the request will - fail with error 412 conditionNotMet. To see the - latest fingerprint, make a get() request to - retrieve an SslPolicy. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - kind (str): - [Output only] Type of the resource. Always - compute#sslPolicyfor SSL policies. - min_tls_version (google.cloud.compute_v1.types.SslPolicy.MinTlsVersion): - The minimum version of SSL protocol that can be used by the - clients to establish a connection with the load balancer. - This can be one of TLS_1_0, TLS_1_1, TLS_1_2. - name (str): - Name of the resource. The name must be 1-63 characters long, - and comply with RFC1035. Specifically, the name must be 1-63 - characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. - profile (google.cloud.compute_v1.types.SslPolicy.Profile): - Profile specifies the set of SSL features - that can be used by the load balancer when - negotiating SSL with clients. This can be one of - COMPATIBLE, MODERN, RESTRICTED, or CUSTOM. If - using CUSTOM, the set of SSL features to enable - must be specified in the customFeatures field. - self_link (str): - [Output Only] Server-defined URL for the resource. - warnings (Sequence[google.cloud.compute_v1.types.Warnings]): - [Output Only] If potential misconfigurations are detected - for this SSL policy, this field will be populated with - warning messages. - """ - - class MinTlsVersion(proto.Enum): - r"""The minimum version of SSL protocol that can be used by the clients - to establish a connection with the load balancer. This can be one of - TLS_1_0, TLS_1_1, TLS_1_2. - """ - UNDEFINED_MIN_TLS_VERSION = 0 - TLS_1_0 = 33116734 - TLS_1_1 = 33116735 - TLS_1_2 = 33116736 - - class Profile(proto.Enum): - r"""Profile specifies the set of SSL features that can be used by - the load balancer when negotiating SSL with clients. This can be - one of COMPATIBLE, MODERN, RESTRICTED, or CUSTOM. If using - CUSTOM, the set of SSL features to enable must be specified in - the customFeatures field. - """ - UNDEFINED_PROFILE = 0 - COMPATIBLE = 179357396 - CUSTOM = 388595569 - MODERN = 132013855 - RESTRICTED = 261551195 - - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - custom_features = proto.RepeatedField(proto.STRING, number=34789707,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - enabled_features = proto.RepeatedField(proto.STRING, number=469017467,) - fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - min_tls_version = proto.Field( - proto.ENUM, number=8155943, optional=True, enum=MinTlsVersion, - ) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - profile = proto.Field(proto.ENUM, number=227445161, optional=True, enum=Profile,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warnings = proto.RepeatedField(proto.MESSAGE, number=498091095, message="Warnings",) -class SslPoliciesList(proto.Message): +class InstanceGroupManagersListPerInstanceConfigsResp(proto.Message): r""" Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.SslPolicy]): - A list of SslPolicy resources. - kind (str): - [Output Only] Type of the resource. Always - compute#sslPoliciesList for lists of sslPolicies. + items (Sequence[google.cloud.compute_v1.types.PerInstanceConfig]): + [Output Only] The list of PerInstanceConfig. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -22081,8 +21404,6 @@ class SslPoliciesList(proto.Message): the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. warning (google.cloud.compute_v1.types.Warning): [Output Only] Informational warning message. """ @@ -22091,418 +21412,264 @@ class SslPoliciesList(proto.Message): def raw_page(self): return self - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="SslPolicy",) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="PerInstanceConfig", + ) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) warning = proto.Field( proto.MESSAGE, number=50704284, optional=True, message="Warning", ) -class SslPoliciesListAvailableFeaturesResponse(proto.Message): - r""" +class InstanceGroupManagersPatchPerInstanceConfigsReq(proto.Message): + r"""InstanceGroupManagers.patchPerInstanceConfigs Attributes: - features (Sequence[str]): - + per_instance_configs (Sequence[google.cloud.compute_v1.types.PerInstanceConfig]): + The list of per-instance configs to insert or + patch on this managed instance group. """ - features = proto.RepeatedField(proto.STRING, number=246211645,) + per_instance_configs = proto.RepeatedField( + proto.MESSAGE, number=526265001, message="PerInstanceConfig", + ) -class SslPolicyReference(proto.Message): +class InstanceGroupManagersRecreateInstancesRequest(proto.Message): r""" Attributes: - ssl_policy (str): - URL of the SSL policy resource. Set this to - empty string to clear any existing SSL policy - associated with the target proxy resource. + instances (Sequence[str]): + The URLs of one or more instances to recreate. This can be a + full URL or a partial URL, such as + zones/[ZONE]/instances/[INSTANCE_NAME]. """ - ssl_policy = proto.Field(proto.STRING, number=295190213, optional=True,) + instances = proto.RepeatedField(proto.STRING, number=29097598,) -class StatefulPolicyPreservedState(proto.Message): - r"""Configuration of preserved resources. +class InstanceGroupManagersScopedList(proto.Message): + r""" Attributes: - disks (Sequence[google.cloud.compute_v1.types.StatefulPolicyPreservedState.DisksEntry]): - Disks created on the instances that will be - preserved on instance delete, update, etc. This - map is keyed with the device names of the disks. + instance_group_managers (Sequence[google.cloud.compute_v1.types.InstanceGroupManager]): + [Output Only] The list of managed instance groups that are + contained in the specified project and zone. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] The warning that replaces the list of managed + instance groups when the list is empty. """ - disks = proto.MapField( - proto.STRING, - proto.MESSAGE, - number=95594102, - message="StatefulPolicyPreservedStateDiskDevice", + instance_group_managers = proto.RepeatedField( + proto.MESSAGE, number=214072592, message="InstanceGroupManager", + ) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", ) -class StatefulPolicyPreservedStateDiskDevice(proto.Message): +class InstanceGroupManagersSetInstanceTemplateRequest(proto.Message): r""" Attributes: - auto_delete (google.cloud.compute_v1.types.StatefulPolicyPreservedStateDiskDevice.AutoDelete): - These stateful disks will never be deleted during - autohealing, update or VM instance recreate operations. This - flag is used to configure if the disk should be deleted - after it is no longer used by the group, e.g. when the given - instance or the whole group is deleted. Note: disks attached - in READ_ONLY mode cannot be auto-deleted. + instance_template (str): + The URL of the instance template that is + specified for this managed instance group. The + group uses this template to create all new + instances in the managed instance group. The + templates for existing instances in the group do + not change unless you run recreateInstances, run + applyUpdatesToInstances, or set the group's + updatePolicy.type to PROACTIVE. """ - class AutoDelete(proto.Enum): - r"""These stateful disks will never be deleted during autohealing, - update or VM instance recreate operations. This flag is used to - configure if the disk should be deleted after it is no longer used - by the group, e.g. when the given instance or the whole group is - deleted. Note: disks attached in READ_ONLY mode cannot be - auto-deleted. - """ - UNDEFINED_AUTO_DELETE = 0 - NEVER = 74175084 - ON_PERMANENT_INSTANCE_DELETION = 95727719 - - auto_delete = proto.Field( - proto.ENUM, number=464761403, optional=True, enum=AutoDelete, - ) + instance_template = proto.Field(proto.STRING, number=309248228, optional=True,) -class SubnetworkLogConfig(proto.Message): - r"""The available logging options for this subnetwork. +class InstanceGroupManagersSetTargetPoolsRequest(proto.Message): + r""" Attributes: - aggregation_interval (google.cloud.compute_v1.types.SubnetworkLogConfig.AggregationInterval): - Can only be specified if VPC flow logging for - this subnetwork is enabled. Toggles the - aggregation interval for collecting flow logs. - Increasing the interval time will reduce the - amount of generated flow logs for long lasting - connections. Default is an interval of 5 seconds - per connection. - enable (bool): - Whether to enable flow logging for this - subnetwork. If this field is not explicitly set, - it will not appear in get listings. If not set - the default behavior is to disable flow logging. - filter_expr (str): - Can only be specified if VPC flow logs for - this subnetwork is enabled. Export filter used - to define which VPC flow logs should be logged. - flow_sampling (float): - Can only be specified if VPC flow logging for this - subnetwork is enabled. The value of the field must be in [0, - 1]. Set the sampling rate of VPC flow logs within the - subnetwork where 1.0 means all collected logs are reported - and 0.0 means no logs are reported. Default is 0.5, which - means half of all collected logs are reported. - metadata (google.cloud.compute_v1.types.SubnetworkLogConfig.Metadata): - Can only be specified if VPC flow logs for this subnetwork - is enabled. Configures whether all, none or a subset of - metadata fields should be added to the reported VPC flow - logs. Default is EXCLUDE_ALL_METADATA. - metadata_fields (Sequence[str]): - Can only be specified if VPC flow logs for this subnetwork - is enabled and "metadata" was set to CUSTOM_METADATA. + fingerprint (str): + The fingerprint of the target pools + information. Use this optional property to + prevent conflicts when multiple users change the + target pools settings concurrently. Obtain the + fingerprint with the instanceGroupManagers.get + method. Then, include the fingerprint in your + request to ensure that you do not overwrite + changes that were applied from another + concurrent request. + target_pools (Sequence[str]): + The list of target pool URLs that instances + in this managed instance group belong to. The + managed instance group applies these target + pools to all of the instances in the group. + Existing instances and new instances in the + group all receive these target pool settings. """ - class AggregationInterval(proto.Enum): - r"""Can only be specified if VPC flow logging for this subnetwork - is enabled. Toggles the aggregation interval for collecting flow - logs. Increasing the interval time will reduce the amount of - generated flow logs for long lasting connections. Default is an - interval of 5 seconds per connection. - """ - UNDEFINED_AGGREGATION_INTERVAL = 0 - INTERVAL_10_MIN = 487155916 - INTERVAL_15_MIN = 491773521 - INTERVAL_1_MIN = 69052714 - INTERVAL_30_SEC = 7548937 - INTERVAL_5_MIN = 72746798 - INTERVAL_5_SEC = 72752429 + fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) + target_pools = proto.RepeatedField(proto.STRING, number=336072617,) - class Metadata(proto.Enum): - r"""Can only be specified if VPC flow logs for this subnetwork is - enabled. Configures whether all, none or a subset of metadata fields - should be added to the reported VPC flow logs. Default is - EXCLUDE_ALL_METADATA. - """ - UNDEFINED_METADATA = 0 - CUSTOM_METADATA = 62450749 - EXCLUDE_ALL_METADATA = 334519954 - INCLUDE_ALL_METADATA = 164619908 - aggregation_interval = proto.Field( - proto.ENUM, number=174919042, optional=True, enum=AggregationInterval, +class InstanceGroupManagersUpdatePerInstanceConfigsReq(proto.Message): + r"""InstanceGroupManagers.updatePerInstanceConfigs + Attributes: + per_instance_configs (Sequence[google.cloud.compute_v1.types.PerInstanceConfig]): + The list of per-instance configs to insert or + patch on this managed instance group. + """ + + per_instance_configs = proto.RepeatedField( + proto.MESSAGE, number=526265001, message="PerInstanceConfig", ) - enable = proto.Field(proto.BOOL, number=311764355, optional=True,) - filter_expr = proto.Field(proto.STRING, number=183374428, optional=True,) - flow_sampling = proto.Field(proto.FLOAT, number=530150360, optional=True,) - metadata = proto.Field(proto.ENUM, number=86866735, optional=True, enum=Metadata,) - metadata_fields = proto.RepeatedField(proto.STRING, number=378461641,) -class SubnetworkSecondaryRange(proto.Message): - r"""Represents a secondary IP range of a subnetwork. +class InstanceGroupsAddInstancesRequest(proto.Message): + r""" Attributes: - ip_cidr_range (str): - The range of IP addresses belonging to this - subnetwork secondary range. Provide this - property when you create the subnetwork. Ranges - must be unique and non-overlapping with all - primary and secondary IP ranges within a - network. Only IPv4 is supported. The range can - be any range listed in the Valid ranges list. - range_name (str): - The name associated with this subnetwork - secondary range, used when adding an alias IP - range to a VM instance. The name must be 1-63 - characters long, and comply with RFC1035. The - name must be unique within the subnetwork. + instances (Sequence[google.cloud.compute_v1.types.InstanceReference]): + The list of instances to add to the instance + group. """ - ip_cidr_range = proto.Field(proto.STRING, number=98117322, optional=True,) - range_name = proto.Field(proto.STRING, number=332216397, optional=True,) - - -class Subnetwork(proto.Message): - r"""Represents a Subnetwork resource. + instances = proto.RepeatedField( + proto.MESSAGE, number=29097598, message="InstanceReference", + ) - A subnetwork (also known as a subnet) is a logical partition of a - Virtual Private Cloud network with one primary IP range and zero or - more secondary IP ranges. For more information, read Virtual Private - Cloud (VPC) Network. (== resource_for {$api_version}.subnetworks ==) +class InstanceGroupsListInstances(proto.Message): + r""" Attributes: - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - description (str): - An optional description of this resource. - Provide this property when you create the - resource. This field can be set only at resource - creation time. - enable_flow_logs (bool): - Whether to enable flow logging for this subnetwork. If this - field is not explicitly set, it will not appear in get - listings. If not set the default behavior is to disable flow - logging. This field isn't supported with the purpose field - set to INTERNAL_HTTPS_LOAD_BALANCER. - fingerprint (str): - Fingerprint of this resource. A hash of the - contents stored in this object. This field is - used in optimistic locking. This field will be - ignored when inserting a Subnetwork. An up-to- - date fingerprint must be provided in order to - update the Subnetwork, otherwise the request - will fail with error 412 conditionNotMet. To - see the latest fingerprint, make a get() request - to retrieve a Subnetwork. - gateway_address (str): - [Output Only] The gateway address for default routes to - reach destination addresses outside this subnetwork. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - ip_cidr_range (str): - The range of internal addresses that are - owned by this subnetwork. Provide this property - when you create the subnetwork. For example, - 10.0.0.0/8 or 100.64.0.0/10. Ranges must be - unique and non-overlapping within a network. - Only IPv4 is supported. This field is set at - resource creation time. The range can be any - range listed in the Valid ranges list. The range - can be expanded after creation using - expandIpCidrRange. - ipv6_cidr_range (str): - [Output Only] The range of internal IPv6 addresses that are - owned by this subnetwork. - kind (str): - [Output Only] Type of the resource. Always - compute#subnetwork for Subnetwork resources. - log_config (google.cloud.compute_v1.types.SubnetworkLogConfig): - This field denotes the VPC flow logging - options for this subnetwork. If logging is - enabled, logs are exported to Cloud Logging. - name (str): - The name of the resource, provided by the client when - initially creating the resource. The name must be 1-63 - characters long, and comply with RFC1035. Specifically, the - name must be 1-63 characters long and match the regular - expression ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the - first character must be a lowercase letter, and all - following characters must be a dash, lowercase letter, or - digit, except the last character, which cannot be a dash. - network (str): - The URL of the network to which this - subnetwork belongs, provided by the client when - initially creating the subnetwork. Only networks - that are in the distributed mode can have - subnetworks. This field can be set only at - resource creation time. - private_ip_google_access (bool): - Whether the VMs in this subnet can access - Google services without assigned external IP - addresses. This field can be both set at - resource creation time and updated using - setPrivateIpGoogleAccess. - private_ipv6_google_access (google.cloud.compute_v1.types.Subnetwork.PrivateIpv6GoogleAccess): - The private IPv6 google access type for the - VMs in this subnet. This is an expanded field of - enablePrivateV6Access. If both fields are set, - privateIpv6GoogleAccess will take priority. - This field can be both set at resource creation - time and updated using patch. - purpose (google.cloud.compute_v1.types.Subnetwork.Purpose): - The purpose of the resource. This field can be either - PRIVATE_RFC_1918 or INTERNAL_HTTPS_LOAD_BALANCER. A - subnetwork with purpose set to INTERNAL_HTTPS_LOAD_BALANCER - is a user-created subnetwork that is reserved for Internal - HTTP(S) Load Balancing. If unspecified, the purpose defaults - to PRIVATE_RFC_1918. The enableFlowLogs field isn't - supported with the purpose field set to - INTERNAL_HTTPS_LOAD_BALANCER. - region (str): - URL of the region where the Subnetwork - resides. This field can be set only at resource - creation time. - role (google.cloud.compute_v1.types.Subnetwork.Role): - The role of subnetwork. Currently, this field is only used - when purpose = INTERNAL_HTTPS_LOAD_BALANCER. The value can - be set to ACTIVE or BACKUP. An ACTIVE subnetwork is one that - is currently being used for Internal HTTP(S) Load Balancing. - A BACKUP subnetwork is one that is ready to be promoted to - ACTIVE or is currently draining. This field can be updated - with a patch request. - secondary_ip_ranges (Sequence[google.cloud.compute_v1.types.SubnetworkSecondaryRange]): - An array of configurations for secondary IP - ranges for VM instances contained in this - subnetwork. The primary IP of such VM must - belong to the primary ipCidrRange of the - subnetwork. The alias IPs may belong to either - primary or secondary ranges. This field can be - updated with a patch request. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.InstanceWithNamedPorts]): + A list of InstanceWithNamedPorts resources. + kind (str): + [Output Only] The resource type, which is always + compute#instanceGroupsListInstances for the list of + instances in the specified instance group. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. self_link (str): - [Output Only] Server-defined URL for the resource. - state (google.cloud.compute_v1.types.Subnetwork.State): - [Output Only] The state of the subnetwork, which can be one - of the following values: READY: Subnetwork is created and - ready to use DRAINING: only applicable to subnetworks that - have the purpose set to INTERNAL_HTTPS_LOAD_BALANCER and - indicates that connections to the load balancer are being - drained. A subnetwork that is draining cannot be used or - modified until it reaches a status of READY + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - class PrivateIpv6GoogleAccess(proto.Enum): - r"""The private IPv6 google access type for the VMs in this - subnet. This is an expanded field of enablePrivateV6Access. If - both fields are set, privateIpv6GoogleAccess will take priority. - This field can be both set at resource creation time and updated - using patch. - """ - UNDEFINED_PRIVATE_IPV6_GOOGLE_ACCESS = 0 - DISABLE_GOOGLE_ACCESS = 450958579 - ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE = 427975994 - ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE = 288210263 + @property + def raw_page(self): + return self - class Purpose(proto.Enum): - r"""The purpose of the resource. This field can be either - PRIVATE_RFC_1918 or INTERNAL_HTTPS_LOAD_BALANCER. A subnetwork with - purpose set to INTERNAL_HTTPS_LOAD_BALANCER is a user-created - subnetwork that is reserved for Internal HTTP(S) Load Balancing. If - unspecified, the purpose defaults to PRIVATE_RFC_1918. The - enableFlowLogs field isn't supported with the purpose field set to - INTERNAL_HTTPS_LOAD_BALANCER. - """ - UNDEFINED_PURPOSE = 0 - INTERNAL_HTTPS_LOAD_BALANCER = 248748889 - PRIVATE = 403485027 - PRIVATE_RFC_1918 = 254902107 + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="InstanceWithNamedPorts", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) - class Role(proto.Enum): - r"""The role of subnetwork. Currently, this field is only used when - purpose = INTERNAL_HTTPS_LOAD_BALANCER. The value can be set to - ACTIVE or BACKUP. An ACTIVE subnetwork is one that is currently - being used for Internal HTTP(S) Load Balancing. A BACKUP subnetwork - is one that is ready to be promoted to ACTIVE or is currently - draining. This field can be updated with a patch request. - """ - UNDEFINED_ROLE = 0 - ACTIVE = 314733318 - BACKUP = 341010882 - class State(proto.Enum): - r"""[Output Only] The state of the subnetwork, which can be one of the - following values: READY: Subnetwork is created and ready to use - DRAINING: only applicable to subnetworks that have the purpose set - to INTERNAL_HTTPS_LOAD_BALANCER and indicates that connections to - the load balancer are being drained. A subnetwork that is draining - cannot be used or modified until it reaches a status of READY +class InstanceGroupsListInstancesRequest(proto.Message): + r""" + Attributes: + instance_state (google.cloud.compute_v1.types.InstanceGroupsListInstancesRequest.InstanceState): + A filter for the state of the instances in + the instance group. Valid options are ALL or + RUNNING. If you do not specify this parameter + the list includes all instances regardless of + their state. + """ + + class InstanceState(proto.Enum): + r"""A filter for the state of the instances in the instance + group. Valid options are ALL or RUNNING. If you do not specify + this parameter the list includes all instances regardless of + their state. """ - UNDEFINED_STATE = 0 - DRAINING = 480455402 - READY = 77848963 + UNDEFINED_INSTANCE_STATE = 0 + ALL = 64897 + RUNNING = 121282975 - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - enable_flow_logs = proto.Field(proto.BOOL, number=151544420, optional=True,) - fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) - gateway_address = proto.Field(proto.STRING, number=459867385, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - ip_cidr_range = proto.Field(proto.STRING, number=98117322, optional=True,) - ipv6_cidr_range = proto.Field(proto.STRING, number=273141258, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - log_config = proto.Field( - proto.MESSAGE, number=351299741, optional=True, message="SubnetworkLogConfig", - ) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - network = proto.Field(proto.STRING, number=232872494, optional=True,) - private_ip_google_access = proto.Field(proto.BOOL, number=421491790, optional=True,) - private_ipv6_google_access = proto.Field( - proto.ENUM, number=48277006, optional=True, enum=PrivateIpv6GoogleAccess, + instance_state = proto.Field( + proto.ENUM, number=92223591, optional=True, enum=InstanceState, ) - purpose = proto.Field(proto.ENUM, number=316407070, optional=True, enum=Purpose,) - region = proto.Field(proto.STRING, number=138946292, optional=True,) - role = proto.Field(proto.ENUM, number=3506294, optional=True, enum=Role,) - secondary_ip_ranges = proto.RepeatedField( - proto.MESSAGE, number=136658915, message="SubnetworkSecondaryRange", + + +class InstanceGroupsRemoveInstancesRequest(proto.Message): + r""" + Attributes: + instances (Sequence[google.cloud.compute_v1.types.InstanceReference]): + The list of instances to remove from the + instance group. + """ + + instances = proto.RepeatedField( + proto.MESSAGE, number=29097598, message="InstanceReference", ) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - state = proto.Field(proto.ENUM, number=109757585, optional=True, enum=State,) -class SubnetworksScopedList(proto.Message): +class InstanceGroupsScopedList(proto.Message): r""" Attributes: - subnetworks (Sequence[google.cloud.compute_v1.types.Subnetwork]): - A list of subnetworks contained in this - scope. + instance_groups (Sequence[google.cloud.compute_v1.types.InstanceGroup]): + [Output Only] The list of instance groups that are contained + in this scope. warning (google.cloud.compute_v1.types.Warning): - An informational warning that appears when - the list of addresses is empty. + [Output Only] An informational warning that replaces the + list of instance groups when the list is empty. """ - subnetworks = proto.RepeatedField( - proto.MESSAGE, number=415853125, message="Subnetwork", + instance_groups = proto.RepeatedField( + proto.MESSAGE, number=366469310, message="InstanceGroup", ) warning = proto.Field( proto.MESSAGE, number=50704284, optional=True, message="Warning", ) -class SubnetworkAggregatedList(proto.Message): +class InstanceGroupsSetNamedPortsRequest(proto.Message): r""" + Attributes: + fingerprint (str): + The fingerprint of the named ports + information for this instance group. Use this + optional property to prevent conflicts when + multiple users change the named ports settings + concurrently. Obtain the fingerprint with the + instanceGroups.get method. Then, include the + fingerprint in your request to ensure that you + do not overwrite changes that were applied from + another concurrent request. A request with an + incorrect fingerprint will fail with error 412 + conditionNotMet. + named_ports (Sequence[google.cloud.compute_v1.types.NamedPort]): + The list of named ports to set for this + instance group. + """ + + fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) + named_ports = proto.RepeatedField( + proto.MESSAGE, number=427598732, message="NamedPort", + ) + + +class InstanceList(proto.Message): + r"""Contains a list of instances. Attributes: id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.SubnetworkAggregatedList.ItemsEntry]): - A list of SubnetworksScopedList resources. + items (Sequence[google.cloud.compute_v1.types.Instance]): + A list of Instance resources. kind (str): - [Output Only] Type of resource. Always - compute#subnetworkAggregatedList for aggregated lists of - subnetworks. + [Output Only] Type of resource. Always compute#instanceList + for lists of Instance resources. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -22512,8 +21679,6 @@ class SubnetworkAggregatedList(proto.Message): to continue paging through the results. self_link (str): [Output Only] Server-defined URL for this resource. - unreachables (Sequence[str]): - [Output Only] Unreachable resources. warning (google.cloud.compute_v1.types.Warning): [Output Only] Informational warning message. """ @@ -22523,29 +21688,27 @@ def raw_page(self): return self id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.MapField( - proto.STRING, proto.MESSAGE, number=100526016, message="SubnetworksScopedList", - ) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Instance",) kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - unreachables = proto.RepeatedField(proto.STRING, number=243372063,) warning = proto.Field( proto.MESSAGE, number=50704284, optional=True, message="Warning", ) -class SubnetworkList(proto.Message): - r"""Contains a list of Subnetwork resources. +class InstanceListReferrers(proto.Message): + r"""Contains a list of instance referrers. Attributes: id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.Subnetwork]): - A list of Subnetwork resources. + items (Sequence[google.cloud.compute_v1.types.Reference]): + A list of Reference resources. kind (str): [Output Only] Type of resource. Always - compute#subnetworkList for lists of subnetworks. + compute#instanceListReferrers for lists of Instance + referrers. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -22564,7 +21727,7 @@ def raw_page(self): return self id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Subnetwork",) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Reference",) kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) @@ -22573,199 +21736,286 @@ def raw_page(self): ) -class SubnetworksExpandIpCidrRangeRequest(proto.Message): +class InstanceManagedByIgmError(proto.Message): r""" Attributes: - ip_cidr_range (str): - The IP (in CIDR format or netmask) of - internal addresses that are legal on this - Subnetwork. This range should be disjoint from - other subnetworks within this network. This - range can only be larger than (i.e. a superset - of) the range previously defined before the - update. + error (google.cloud.compute_v1.types.InstanceManagedByIgmErrorManagedInstanceError): + [Output Only] Contents of the error. + instance_action_details (google.cloud.compute_v1.types.InstanceManagedByIgmErrorInstanceActionDetails): + [Output Only] Details of the instance action that triggered + this error. May be null, if the error was not caused by an + action on an instance. This field is optional. + timestamp (str): + [Output Only] The time that this error occurred. This value + is in RFC3339 text format. """ - ip_cidr_range = proto.Field(proto.STRING, number=98117322, optional=True,) + error = proto.Field( + proto.MESSAGE, + number=96784904, + optional=True, + message="InstanceManagedByIgmErrorManagedInstanceError", + ) + instance_action_details = proto.Field( + proto.MESSAGE, + number=292224547, + optional=True, + message="InstanceManagedByIgmErrorInstanceActionDetails", + ) + timestamp = proto.Field(proto.STRING, number=55126294, optional=True,) -class SubnetworksSetPrivateIpGoogleAccessRequest(proto.Message): +class InstanceManagedByIgmErrorInstanceActionDetails(proto.Message): r""" Attributes: - private_ip_google_access (bool): - + action (google.cloud.compute_v1.types.InstanceManagedByIgmErrorInstanceActionDetails.Action): + [Output Only] Action that managed instance group was + executing on the instance when the error occurred. Possible + values: + instance (str): + [Output Only] The URL of the instance. The URL can be set + even if the instance has not yet been created. + version (google.cloud.compute_v1.types.ManagedInstanceVersion): + [Output Only] Version this instance was created from, or was + being created from, but the creation failed. Corresponds to + one of the versions that were set on the Instance Group + Manager resource at the time this instance was being + created. """ - private_ip_google_access = proto.Field(proto.BOOL, number=421491790, optional=True,) + class Action(proto.Enum): + r"""[Output Only] Action that managed instance group was executing on + the instance when the error occurred. Possible values: + """ + UNDEFINED_ACTION = 0 + ABANDONING = 388244813 + CREATING = 455564985 + CREATING_WITHOUT_RETRIES = 428843785 + DELETING = 528602024 + NONE = 2402104 + RECREATING = 287278572 + REFRESHING = 163266343 + RESTARTING = 320534387 + VERIFYING = 16982185 + + action = proto.Field(proto.ENUM, number=187661878, optional=True, enum=Action,) + instance = proto.Field(proto.STRING, number=18257045, optional=True,) + version = proto.Field( + proto.MESSAGE, + number=351608024, + optional=True, + message="ManagedInstanceVersion", + ) -class TargetGrpcProxy(proto.Message): - r"""Represents a Target gRPC Proxy resource. +class InstanceManagedByIgmErrorManagedInstanceError(proto.Message): + r""" + Attributes: + code (str): + [Output Only] Error code. + message (str): + [Output Only] Error message. + """ - A target gRPC proxy is a component of load balancers intended for - load balancing gRPC traffic. Only global forwarding rules with load - balancing scheme INTERNAL_SELF_MANAGED can reference a target gRPC - proxy. The target gRPC Proxy references a URL map that specifies how - traffic is routed to gRPC backend services. (== resource_for - {$api_version}.targetGrpcProxies ==) + code = proto.Field(proto.STRING, number=3059181, optional=True,) + message = proto.Field(proto.STRING, number=418054151, optional=True,) + +class InstanceMoveRequest(proto.Message): + r""" Attributes: - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - description (str): - An optional description of this resource. - Provide this property when you create the - resource. - fingerprint (str): - Fingerprint of this resource. A hash of the - contents stored in this object. This field is - used in optimistic locking. This field will be - ignored when inserting a TargetGrpcProxy. An up- - to-date fingerprint must be provided in order to - patch/update the TargetGrpcProxy; otherwise, the - request will fail with error 412 - conditionNotMet. To see the latest fingerprint, - make a get() request to retrieve the - TargetGrpcProxy. - id (int): - [Output Only] The unique identifier for the resource type. - The server generates this identifier. - kind (str): - [Output Only] Type of the resource. Always - compute#targetGrpcProxy for target grpc proxies. - name (str): - Name of the resource. Provided by the client when the - resource is created. The name must be 1-63 characters long, - and comply with RFC1035. Specifically, the name must be 1-63 - characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. - self_link (str): - [Output Only] Server-defined URL for the resource. - self_link_with_id (str): - [Output Only] Server-defined URL with id for the resource. - url_map (str): - URL to the UrlMap resource that defines the - mapping from URL to the BackendService. The - protocol field in the BackendService must be set - to GRPC. - validate_for_proxyless (bool): - If true, indicates that the BackendServices - referenced by the urlMap may be accessed by gRPC - applications without using a sidecar proxy. This - will enable configuration checks on urlMap and - its referenced BackendServices to not allow - unsupported features. A gRPC application must - use "xds:///" scheme in the target URI of the - service it is connecting to. If false, indicates - that the BackendServices referenced by the - urlMap will be accessed by gRPC applications via - a sidecar proxy. In this case, a gRPC - application must not use "xds:///" scheme in the - target URI of the service it is connecting to + destination_zone (str): + The URL of the destination zone to move the + instance. This can be a full or partial URL. For + example, the following are all valid URLs to a + zone: - + https://www.googleapis.com/compute/v1/projects/project/zones/zone + - projects/project/zones/zone - zones/zone + target_instance (str): + The URL of the target instance to move. This + can be a full or partial URL. For example, the + following are all valid URLs to an instance: - + https://www.googleapis.com/compute/v1/projects/project/zones/zone + /instances/instance - + projects/project/zones/zone/instances/instance - + zones/zone/instances/instance """ - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - self_link_with_id = proto.Field(proto.STRING, number=44520962, optional=True,) - url_map = proto.Field(proto.STRING, number=367020684, optional=True,) - validate_for_proxyless = proto.Field(proto.BOOL, number=101822888, optional=True,) + destination_zone = proto.Field(proto.STRING, number=131854653, optional=True,) + target_instance = proto.Field(proto.STRING, number=289769347, optional=True,) -class TargetGrpcProxyList(proto.Message): +class InstanceProperties(proto.Message): r""" Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.TargetGrpcProxy]): - A list of TargetGrpcProxy resources. - kind (str): - [Output Only] Type of the resource. Always - compute#targetGrpcProxy for target grpc proxies. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + advanced_machine_features (google.cloud.compute_v1.types.AdvancedMachineFeatures): + Controls for advanced machine-related + behavior features. + can_ip_forward (bool): + Enables instances created based on these + properties to send packets with source IP + addresses other than their own and receive + packets with destination IP addresses other than + their own. If these instances will be used as an + IP gateway or it will be set as the next-hop in + a Route resource, specify true. If unsure, leave + this set to false. See the Enable IP forwarding + documentation for more information. + confidential_instance_config (google.cloud.compute_v1.types.ConfidentialInstanceConfig): + Specifies the Confidential Instance options. + description (str): + An optional text description for the + instances that are created from these + properties. + disks (Sequence[google.cloud.compute_v1.types.AttachedDisk]): + An array of disks that are associated with + the instances that are created from these + properties. + guest_accelerators (Sequence[google.cloud.compute_v1.types.AcceleratorConfig]): + A list of guest accelerator cards' type and + count to use for instances created from these + properties. + labels (Sequence[google.cloud.compute_v1.types.InstanceProperties.LabelsEntry]): + Labels to apply to instances that are created + from these properties. + machine_type (str): + The machine type to use for instances that + are created from these properties. + metadata (google.cloud.compute_v1.types.Metadata): + The metadata key/value pairs to assign to + instances that are created from these + properties. These pairs can consist of custom + metadata or predefined keys. See Project and + instance metadata for more information. + min_cpu_platform (str): + Minimum cpu/platform to be used by instances. + The instance may be scheduled on the specified + or newer cpu/platform. Applicable values are the + friendly names of CPU platforms, such as + minCpuPlatform: "Intel Haswell" or + minCpuPlatform: "Intel Sandy Bridge". For more + information, read Specifying a Minimum CPU + Platform. + network_interfaces (Sequence[google.cloud.compute_v1.types.NetworkInterface]): + An array of network access configurations for + this interface. + private_ipv6_google_access (google.cloud.compute_v1.types.InstanceProperties.PrivateIpv6GoogleAccess): + The private IPv6 google access type for VMs. If not + specified, use INHERIT_FROM_SUBNETWORK as default. + reservation_affinity (google.cloud.compute_v1.types.ReservationAffinity): + Specifies the reservations that instances can + consume from. + resource_policies (Sequence[str]): + Resource policies (names, not ULRs) applied + to instances created from these properties. + scheduling (google.cloud.compute_v1.types.Scheduling): + Specifies the scheduling options for the + instances that are created from these + properties. + service_accounts (Sequence[google.cloud.compute_v1.types.ServiceAccount]): + A list of service accounts with specified + scopes. Access tokens for these service accounts + are available to the instances that are created + from these properties. Use metadata queries to + obtain the access tokens for these instances. + shielded_instance_config (google.cloud.compute_v1.types.ShieldedInstanceConfig): + + tags (google.cloud.compute_v1.types.Tags): + A list of tags to apply to the instances that + are created from these properties. The tags + identify valid sources or targets for network + firewalls. The setTags method can modify this + list of tags. Each tag within the list must + comply with RFC1035. """ - @property - def raw_page(self): - return self + class PrivateIpv6GoogleAccess(proto.Enum): + r"""The private IPv6 google access type for VMs. If not specified, use + INHERIT_FROM_SUBNETWORK as default. + """ + UNDEFINED_PRIVATE_IPV6_GOOGLE_ACCESS = 0 + ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE = 427975994 + ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE = 288210263 + INHERIT_FROM_SUBNETWORK = 530256959 - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="TargetGrpcProxy", + advanced_machine_features = proto.Field( + proto.MESSAGE, + number=409646002, + optional=True, + message="AdvancedMachineFeatures", + ) + can_ip_forward = proto.Field(proto.BOOL, number=467731324, optional=True,) + confidential_instance_config = proto.Field( + proto.MESSAGE, + number=490637685, + optional=True, + message="ConfidentialInstanceConfig", + ) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + disks = proto.RepeatedField(proto.MESSAGE, number=95594102, message="AttachedDisk",) + guest_accelerators = proto.RepeatedField( + proto.MESSAGE, number=463595119, message="AcceleratorConfig", + ) + labels = proto.MapField(proto.STRING, proto.STRING, number=500195327,) + machine_type = proto.Field(proto.STRING, number=227711026, optional=True,) + metadata = proto.Field( + proto.MESSAGE, number=86866735, optional=True, message="Metadata", ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + min_cpu_platform = proto.Field(proto.STRING, number=242912759, optional=True,) + network_interfaces = proto.RepeatedField( + proto.MESSAGE, number=52735243, message="NetworkInterface", ) + private_ipv6_google_access = proto.Field( + proto.ENUM, number=48277006, optional=True, enum=PrivateIpv6GoogleAccess, + ) + reservation_affinity = proto.Field( + proto.MESSAGE, number=157850683, optional=True, message="ReservationAffinity", + ) + resource_policies = proto.RepeatedField(proto.STRING, number=22220385,) + scheduling = proto.Field( + proto.MESSAGE, number=386688404, optional=True, message="Scheduling", + ) + service_accounts = proto.RepeatedField( + proto.MESSAGE, number=277537328, message="ServiceAccount", + ) + shielded_instance_config = proto.Field( + proto.MESSAGE, number=12862901, optional=True, message="ShieldedInstanceConfig", + ) + tags = proto.Field(proto.MESSAGE, number=3552281, optional=True, message="Tags",) -class TargetHttpProxy(proto.Message): - r"""Represents a Target HTTP Proxy resource. - - Google Compute Engine has two Target HTTP Proxy resources: - - - `Global `__ - \* - `Regional `__ +class InstanceReference(proto.Message): + r""" + Attributes: + instance (str): + The URL for a specific instance. @required + compute.instancegroups.addInstances/removeInstances + """ - A target HTTP proxy is a component of GCP HTTP load balancers. + instance = proto.Field(proto.STRING, number=18257045, optional=True,) - - targetHttpProxies are used by external HTTP load balancers and - Traffic Director. \* regionTargetHttpProxies are used by internal - HTTP load balancers. - Forwarding rules reference a target HTTP proxy, and the target proxy - then references a URL map. For more information, read Using Target - Proxies and Forwarding rule concepts. (== resource_for - {$api_version}.targetHttpProxies ==) (== resource_for - {$api_version}.regionTargetHttpProxies ==) +class InstanceTemplate(proto.Message): + r"""Represents an Instance Template resource. You can use + instance templates to create VM instances and managed instance + groups. For more information, read Instance Templates. Attributes: creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. + [Output Only] The creation timestamp for this instance + template in RFC3339 text format. description (str): An optional description of this resource. Provide this property when you create the resource. - fingerprint (str): - Fingerprint of this resource. A hash of the - contents stored in this object. This field is - used in optimistic locking. This field will be - ignored when inserting a TargetHttpProxy. An up- - to-date fingerprint must be provided in order to - patch/update the TargetHttpProxy; otherwise, the - request will fail with error 412 - conditionNotMet. To see the latest fingerprint, - make a get() request to retrieve the - TargetHttpProxy. id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. + [Output Only] A unique identifier for this instance + template. The server defines this identifier. kind (str): - [Output Only] Type of resource. Always - compute#targetHttpProxy for target HTTP proxies. + [Output Only] The resource type, which is always + compute#instanceTemplate for instance templates. name (str): - Name of the resource. Provided by the client when the + Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression @@ -22773,117 +22023,52 @@ class TargetHttpProxy(proto.Message): character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. - proxy_bind (bool): - This field only applies when the forwarding rule that - references this target proxy has a loadBalancingScheme set - to INTERNAL_SELF_MANAGED. - - When this field is set to true, Envoy proxies set up inbound - traffic interception and bind to the IP address and port - specified in the forwarding rule. This is generally useful - when using Traffic Director to configure Envoy as a gateway - or middle proxy (in other words, not a sidecar proxy). The - Envoy proxy listens for inbound requests and handles - requests when it receives them. - - The default is false. - region (str): - [Output Only] URL of the region where the regional Target - HTTP Proxy resides. This field is not applicable to global - Target HTTP Proxies. + properties (google.cloud.compute_v1.types.InstanceProperties): + The instance properties for this instance + template. self_link (str): - [Output Only] Server-defined URL for the resource. - url_map (str): - URL to the UrlMap resource that defines the - mapping from URL to the BackendService. + [Output Only] The URL for this instance template. The server + defines this URL. + source_instance (str): + The source instance used to create the + template. You can provide this as a partial or + full URL to the resource. For example, the + following are valid values: - + https://www.googleapis.com/compute/v1/projects/project/zones/zone + /instances/instance - + projects/project/zones/zone/instances/instance + source_instance_params (google.cloud.compute_v1.types.SourceInstanceParams): + The source instance params to use to create + this instance template. """ creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) description = proto.Field(proto.STRING, number=422937596, optional=True,) - fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) id = proto.Field(proto.UINT64, number=3355, optional=True,) kind = proto.Field(proto.STRING, number=3292052, optional=True,) name = proto.Field(proto.STRING, number=3373707, optional=True,) - proxy_bind = proto.Field(proto.BOOL, number=286025582, optional=True,) - region = proto.Field(proto.STRING, number=138946292, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - url_map = proto.Field(proto.STRING, number=367020684, optional=True,) - - -class TargetHttpProxiesScopedList(proto.Message): - r""" - Attributes: - target_http_proxies (Sequence[google.cloud.compute_v1.types.TargetHttpProxy]): - A list of TargetHttpProxies contained in this - scope. - warning (google.cloud.compute_v1.types.Warning): - Informational warning which replaces the list - of backend services when the list is empty. - """ - - target_http_proxies = proto.RepeatedField( - proto.MESSAGE, number=162147011, message="TargetHttpProxy", - ) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) - - -class TargetHttpProxyAggregatedList(proto.Message): - r""" - Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.TargetHttpProxyAggregatedList.ItemsEntry]): - A list of TargetHttpProxiesScopedList - resources. - kind (str): - [Output Only] Type of resource. Always - compute#targetHttpProxyAggregatedList for lists of Target - HTTP Proxies. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - unreachables (Sequence[str]): - [Output Only] Unreachable resources. - """ - - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.MapField( - proto.STRING, - proto.MESSAGE, - number=100526016, - message="TargetHttpProxiesScopedList", + properties = proto.Field( + proto.MESSAGE, number=147688755, optional=True, message="InstanceProperties", ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - unreachables = proto.RepeatedField(proto.STRING, number=243372063,) + source_instance = proto.Field(proto.STRING, number=396315705, optional=True,) + source_instance_params = proto.Field( + proto.MESSAGE, number=135342156, optional=True, message="SourceInstanceParams", + ) -class TargetHttpProxyList(proto.Message): - r"""A list of TargetHttpProxy resources. +class InstanceTemplateList(proto.Message): + r"""A list of instance templates. Attributes: id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.TargetHttpProxy]): - A list of TargetHttpProxy resources. + items (Sequence[google.cloud.compute_v1.types.InstanceTemplate]): + A list of InstanceTemplate resources. kind (str): - Type of resource. Always - compute#targetHttpProxyList for lists of target - HTTP proxies. + [Output Only] The resource type, which is always + compute#instanceTemplatesListResponse for instance template + lists. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -22903,7 +22088,7 @@ def raw_page(self): id = proto.Field(proto.STRING, number=3355, optional=True,) items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="TargetHttpProxy", + proto.MESSAGE, number=100526016, message="InstanceTemplate", ) kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) @@ -22913,340 +22098,291 @@ def raw_page(self): ) -class TargetHttpsProxy(proto.Message): - r"""Represents a Target HTTPS Proxy resource. +class InstanceWithNamedPorts(proto.Message): + r""" + Attributes: + instance (str): + [Output Only] The URL of the instance. + named_ports (Sequence[google.cloud.compute_v1.types.NamedPort]): + [Output Only] The named ports that belong to this instance + group. + status (google.cloud.compute_v1.types.InstanceWithNamedPorts.Status): + [Output Only] The status of the instance. + """ + + class Status(proto.Enum): + r"""[Output Only] The status of the instance.""" + UNDEFINED_STATUS = 0 + DEPROVISIONING = 428935662 + PROVISIONING = 290896621 + REPAIRING = 413483285 + RUNNING = 121282975 + STAGING = 431072283 + STOPPED = 444276141 + STOPPING = 350791796 + SUSPENDED = 51223995 + SUSPENDING = 514206246 + TERMINATED = 250018339 - Google Compute Engine has two Target HTTPS Proxy resources: + instance = proto.Field(proto.STRING, number=18257045, optional=True,) + named_ports = proto.RepeatedField( + proto.MESSAGE, number=427598732, message="NamedPort", + ) + status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) - - `Global `__ - \* - `Regional `__ - A target HTTPS proxy is a component of GCP HTTPS load balancers. +class InstancesAddResourcePoliciesRequest(proto.Message): + r""" + Attributes: + resource_policies (Sequence[str]): + Resource policies to be added to this + instance. + """ - - targetHttpsProxies are used by external HTTPS load balancers. \* - regionTargetHttpsProxies are used by internal HTTPS load - balancers. + resource_policies = proto.RepeatedField(proto.STRING, number=22220385,) - Forwarding rules reference a target HTTPS proxy, and the target - proxy then references a URL map. For more information, read Using - Target Proxies and Forwarding rule concepts. (== resource_for - {$api_version}.targetHttpsProxies ==) (== resource_for - {$api_version}.regionTargetHttpsProxies ==) +class InstancesGetEffectiveFirewallsResponse(proto.Message): + r""" Attributes: - authorization_policy (str): - Optional. A URL referring to a - networksecurity.AuthorizationPolicy resource that describes - how the proxy should authorize inbound traffic. If left - blank, access will not be restricted by an authorization - policy. Refer to the AuthorizationPolicy resource for - additional details. authorizationPolicy only applies to a - global TargetHttpsProxy attached to globalForwardingRules - with the loadBalancingScheme set to INTERNAL_SELF_MANAGED. - Note: This field currently has no impact. - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - description (str): - An optional description of this resource. - Provide this property when you create the - resource. - fingerprint (str): - Fingerprint of this resource. A hash of the - contents stored in this object. This field is - used in optimistic locking. This field will be - ignored when inserting a TargetHttpsProxy. An - up-to-date fingerprint must be provided in order - to patch the TargetHttpsProxy; otherwise, the - request will fail with error 412 - conditionNotMet. To see the latest fingerprint, - make a get() request to retrieve the - TargetHttpsProxy. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - kind (str): - [Output Only] Type of resource. Always - compute#targetHttpsProxy for target HTTPS proxies. - name (str): - Name of the resource. Provided by the client when the - resource is created. The name must be 1-63 characters long, - and comply with RFC1035. Specifically, the name must be 1-63 - characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. - proxy_bind (bool): - This field only applies when the forwarding rule that - references this target proxy has a loadBalancingScheme set - to INTERNAL_SELF_MANAGED. + firewall_policys (Sequence[google.cloud.compute_v1.types.InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy]): + Effective firewalls from firewall policies. + firewalls (Sequence[google.cloud.compute_v1.types.Firewall]): + Effective firewalls on the instance. + """ - When this field is set to true, Envoy proxies set up inbound - traffic interception and bind to the IP address and port - specified in the forwarding rule. This is generally useful - when using Traffic Director to configure Envoy as a gateway - or middle proxy (in other words, not a sidecar proxy). The - Envoy proxy listens for inbound requests and handles - requests when it receives them. + firewall_policys = proto.RepeatedField( + proto.MESSAGE, + number=410985794, + message="InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy", + ) + firewalls = proto.RepeatedField( + proto.MESSAGE, number=272245619, message="Firewall", + ) - The default is false. - quic_override (google.cloud.compute_v1.types.TargetHttpsProxy.QuicOverride): - Specifies the QUIC override policy for this - TargetHttpsProxy resource. This setting - determines whether the load balancer attempts to - negotiate QUIC with clients. You can specify - NONE, ENABLE, or DISABLE. - When quic-override - is set to NONE, Google manages whether QUIC is - used. - When quic-override is set to ENABLE, the - load balancer uses QUIC when possible. - When - quic-override is set to DISABLE, the load - balancer doesn't use QUIC. - If the quic- - override flag is not specified, NONE is implied. - region (str): - [Output Only] URL of the region where the regional - TargetHttpsProxy resides. This field is not applicable to - global TargetHttpsProxies. - self_link (str): - [Output Only] Server-defined URL for the resource. - server_tls_policy (str): - Optional. A URL referring to a - networksecurity.ServerTlsPolicy resource that describes how - the proxy should authenticate inbound traffic. - serverTlsPolicy only applies to a global TargetHttpsProxy - attached to globalForwardingRules with the - loadBalancingScheme set to INTERNAL_SELF_MANAGED. If left - blank, communications are not encrypted. Note: This field - currently has no impact. - ssl_certificates (Sequence[str]): - URLs to SslCertificate resources that are - used to authenticate connections between users - and the load balancer. At least one SSL - certificate must be specified. Currently, you - may specify up to 15 SSL certificates. - ssl_policy (str): - URL of SslPolicy resource that will be - associated with the TargetHttpsProxy resource. - If not set, the TargetHttpsProxy resource has no - SSL policy configured. - url_map (str): - A fully-qualified or valid partial URL to the - UrlMap resource that defines the mapping from - URL to the BackendService. For example, the - following are all valid URLs for specifying a - URL map: - - https://www.googleapis.compute/v1/projects/project/global/urlMaps/url- - map - projects/project/global/urlMaps/url-map - - global/urlMaps/url-map + +class InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy(proto.Message): + r""" + Attributes: + display_name (str): + [Output Only] Deprecated, please use short name instead. The + display name of the firewall policy. + name (str): + [Output Only] The name of the firewall policy. + rules (Sequence[google.cloud.compute_v1.types.FirewallPolicyRule]): + The rules that apply to the network. + short_name (str): + [Output Only] The short name of the firewall policy. + type_ (google.cloud.compute_v1.types.InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy.Type): + [Output Only] The type of the firewall policy. """ - class QuicOverride(proto.Enum): - r"""Specifies the QUIC override policy for this TargetHttpsProxy - resource. This setting determines whether the load balancer - attempts to negotiate QUIC with clients. You can specify NONE, - ENABLE, or DISABLE. - When quic-override is set to NONE, Google - manages whether QUIC is used. - When quic-override is set to - ENABLE, the load balancer uses QUIC when possible. - When quic- - override is set to DISABLE, the load balancer doesn't use QUIC. - - If the quic-override flag is not specified, NONE is implied. - """ - UNDEFINED_QUIC_OVERRIDE = 0 - DISABLE = 241807048 - ENABLE = 438835587 - NONE = 2402104 + class Type(proto.Enum): + r"""[Output Only] The type of the firewall policy.""" + UNDEFINED_TYPE = 0 + HIERARCHY = 69902869 + UNSPECIFIED = 526786327 - authorization_policy = proto.Field(proto.STRING, number=33945528, optional=True,) - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) + display_name = proto.Field(proto.STRING, number=4473832, optional=True,) name = proto.Field(proto.STRING, number=3373707, optional=True,) - proxy_bind = proto.Field(proto.BOOL, number=286025582, optional=True,) - quic_override = proto.Field( - proto.ENUM, number=456577197, optional=True, enum=QuicOverride, + rules = proto.RepeatedField( + proto.MESSAGE, number=108873975, message="FirewallPolicyRule", ) - region = proto.Field(proto.STRING, number=138946292, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - server_tls_policy = proto.Field(proto.STRING, number=295825266, optional=True,) - ssl_certificates = proto.RepeatedField(proto.STRING, number=366006543,) - ssl_policy = proto.Field(proto.STRING, number=295190213, optional=True,) - url_map = proto.Field(proto.STRING, number=367020684, optional=True,) + short_name = proto.Field(proto.STRING, number=492051566, optional=True,) + type_ = proto.Field(proto.ENUM, number=3575610, optional=True, enum=Type,) -class TargetHttpsProxiesScopedList(proto.Message): +class InstancesRemoveResourcePoliciesRequest(proto.Message): r""" Attributes: - target_https_proxies (Sequence[google.cloud.compute_v1.types.TargetHttpsProxy]): - A list of TargetHttpsProxies contained in - this scope. + resource_policies (Sequence[str]): + Resource policies to be removed from this + instance. + """ + + resource_policies = proto.RepeatedField(proto.STRING, number=22220385,) + + +class InstancesScopedList(proto.Message): + r""" + Attributes: + instances (Sequence[google.cloud.compute_v1.types.Instance]): + [Output Only] A list of instances contained in this scope. warning (google.cloud.compute_v1.types.Warning): - Informational warning which replaces the list - of backend services when the list is empty. + [Output Only] Informational warning which replaces the list + of instances when the list is empty. """ - target_https_proxies = proto.RepeatedField( - proto.MESSAGE, number=366607882, message="TargetHttpsProxy", - ) + instances = proto.RepeatedField(proto.MESSAGE, number=29097598, message="Instance",) warning = proto.Field( proto.MESSAGE, number=50704284, optional=True, message="Warning", ) -class TargetHttpsProxiesSetQuicOverrideRequest(proto.Message): +class InstancesSetLabelsRequest(proto.Message): r""" Attributes: - quic_override (google.cloud.compute_v1.types.TargetHttpsProxiesSetQuicOverrideRequest.QuicOverride): - QUIC policy for the TargetHttpsProxy - resource. + label_fingerprint (str): + Fingerprint of the previous set of labels for + this resource, used to prevent conflicts. + Provide the latest fingerprint value when making + a request to add or change labels. + labels (Sequence[google.cloud.compute_v1.types.InstancesSetLabelsRequest.LabelsEntry]): + """ - class QuicOverride(proto.Enum): - r"""QUIC policy for the TargetHttpsProxy resource.""" - UNDEFINED_QUIC_OVERRIDE = 0 - DISABLE = 241807048 - ENABLE = 438835587 - NONE = 2402104 + label_fingerprint = proto.Field(proto.STRING, number=178124825, optional=True,) + labels = proto.MapField(proto.STRING, proto.STRING, number=500195327,) - quic_override = proto.Field( - proto.ENUM, number=456577197, optional=True, enum=QuicOverride, + +class InstancesSetMachineResourcesRequest(proto.Message): + r""" + Attributes: + guest_accelerators (Sequence[google.cloud.compute_v1.types.AcceleratorConfig]): + A list of the type and count of accelerator + cards attached to the instance. + """ + + guest_accelerators = proto.RepeatedField( + proto.MESSAGE, number=463595119, message="AcceleratorConfig", ) -class TargetHttpsProxiesSetSslCertificatesRequest(proto.Message): +class InstancesSetMachineTypeRequest(proto.Message): r""" Attributes: - ssl_certificates (Sequence[str]): - New set of SslCertificate resources to - associate with this TargetHttpsProxy resource. - Currently exactly one SslCertificate resource - must be specified. + machine_type (str): + Full or partial URL of the machine type + resource. See Machine Types for a full list of + machine types. For example: zones/us- + central1-f/machineTypes/n1-standard-1 """ - ssl_certificates = proto.RepeatedField(proto.STRING, number=366006543,) + machine_type = proto.Field(proto.STRING, number=227711026, optional=True,) -class TargetHttpsProxyAggregatedList(proto.Message): +class InstancesSetMinCpuPlatformRequest(proto.Message): r""" Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.TargetHttpsProxyAggregatedList.ItemsEntry]): - A list of TargetHttpsProxiesScopedList - resources. - kind (str): - [Output Only] Type of resource. Always - compute#targetHttpsProxyAggregatedList for lists of Target - HTTP Proxies. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - unreachables (Sequence[str]): - [Output Only] Unreachable resources. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + min_cpu_platform (str): + Minimum cpu/platform this instance should be + started at. """ - @property - def raw_page(self): - return self + min_cpu_platform = proto.Field(proto.STRING, number=242912759, optional=True,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.MapField( - proto.STRING, - proto.MESSAGE, - number=100526016, - message="TargetHttpsProxiesScopedList", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - unreachables = proto.RepeatedField(proto.STRING, number=243372063,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + +class InstancesSetServiceAccountRequest(proto.Message): + r""" + Attributes: + email (str): + Email address of the service account. + scopes (Sequence[str]): + The list of scopes to be made available for + this service account. + """ + + email = proto.Field(proto.STRING, number=96619420, optional=True,) + scopes = proto.RepeatedField(proto.STRING, number=165973151,) + + +class InstancesStartWithEncryptionKeyRequest(proto.Message): + r""" + Attributes: + disks (Sequence[google.cloud.compute_v1.types.CustomerEncryptionKeyProtectedDisk]): + Array of disks associated with this instance + that are protected with a customer-supplied + encryption key. In order to start the instance, + the disk url and its corresponding key must be + provided. If the disk is not protected with a + customer-supplied encryption key it should not + be specified. + """ + + disks = proto.RepeatedField( + proto.MESSAGE, number=95594102, message="CustomerEncryptionKeyProtectedDisk", ) -class TargetHttpsProxyList(proto.Message): - r"""Contains a list of TargetHttpsProxy resources. +class Int64RangeMatch(proto.Message): + r"""HttpRouteRuleMatch criteria for field values that must stay + within the specified integer range. + Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.TargetHttpsProxy]): - A list of TargetHttpsProxy resources. - kind (str): - Type of resource. Always - compute#targetHttpsProxyList for lists of target - HTTPS proxies. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + range_end (int): + The end of the range (exclusive) in signed + long integer format. + range_start (int): + The start of the range (inclusive) in signed + long integer format. """ - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="TargetHttpsProxy", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) - + range_end = proto.Field(proto.INT64, number=322439897, optional=True,) + range_start = proto.Field(proto.INT64, number=103333600, optional=True,) -class TargetInstance(proto.Message): - r"""Represents a Target Instance resource. - You can use a target instance to handle traffic for one or more - forwarding rules, which is ideal for forwarding protocol traffic - that is managed by a single source. For example, ESP, AH, TCP, or - UDP. For more information, read Target instances. (== resource_for - {$api_version}.targetInstances ==) +class Interconnect(proto.Message): + r"""Represents an Interconnect resource. An Interconnect resource + is a dedicated connection between the GCP network and your on- + premises network. For more information, read the Dedicated + Interconnect Overview. Attributes: + admin_enabled (bool): + Administrative status of the interconnect. + When this is set to true, the Interconnect is + functional and can carry traffic. When set to + false, no packets can be carried over the + interconnect and no BGP routes are exchanged + over it. By default, the status is set to true. + circuit_infos (Sequence[google.cloud.compute_v1.types.InterconnectCircuitInfo]): + [Output Only] A list of CircuitInfo objects, that describe + the individual circuits in this LAG. creation_timestamp (str): [Output Only] Creation timestamp in RFC3339 text format. + customer_name (str): + Customer name, to put in the Letter of + Authorization as the party authorized to request + a crossconnect. description (str): An optional description of this resource. Provide this property when you create the resource. + expected_outages (Sequence[google.cloud.compute_v1.types.InterconnectOutageNotification]): + [Output Only] A list of outages expected for this + Interconnect. + google_ip_address (str): + [Output Only] IP address configured on the Google side of + the Interconnect link. This can be used only for ping tests. + google_reference_id (str): + [Output Only] Google reference ID to be used when raising + support tickets with Google or otherwise to debug backend + connectivity issues. id (int): [Output Only] The unique identifier for the resource. This identifier is defined by the server. - instance (str): - A URL to the virtual machine instance that - handles traffic for this target instance. When - creating a target instance, you can provide the - fully-qualified URL or a valid partial URL to - the desired virtual machine. For example, the - following are all valid URLs: - - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance - - projects/project/zones/zone/instances/instance - - zones/zone/instances/instance + interconnect_attachments (Sequence[str]): + [Output Only] A list of the URLs of all + InterconnectAttachments configured to use this Interconnect. + interconnect_type (google.cloud.compute_v1.types.Interconnect.InterconnectType): + Type of interconnect, which can take one of the following + values: - PARTNER: A partner-managed interconnection shared + between customers though a partner. - DEDICATED: A dedicated + physical interconnection with the customer. Note that a + value IT_PRIVATE has been deprecated in favor of DEDICATED. kind (str): - [Output Only] The type of the resource. Always - compute#targetInstance for target instances. + [Output Only] Type of the resource. Always + compute#interconnect for interconnects. + link_type (google.cloud.compute_v1.types.Interconnect.LinkType): + Type of link requested, which can take one of the following + values: - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR + optics - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR + optics. Note that this field indicates the speed of each of + the links in the bundle, not the speed of the entire bundle. + location (str): + URL of the InterconnectLocation object that + represents where this connection is to be + provisioned. name (str): Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, @@ -23256,210 +22392,252 @@ class TargetInstance(proto.Message): character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. - nat_policy (google.cloud.compute_v1.types.TargetInstance.NatPolicy): - NAT option controlling how IPs are NAT'ed to the instance. - Currently only NO_NAT (default value) is supported. + noc_contact_email (str): + Email address to contact the customer NOC for + operations and maintenance notifications + regarding this Interconnect. If specified, this + will be used for notifications in addition to + all other forms described, such as Stackdriver + logs alerting and Cloud Notifications. + operational_status (google.cloud.compute_v1.types.Interconnect.OperationalStatus): + [Output Only] The current status of this Interconnect's + functionality, which can take one of the following values: - + OS_ACTIVE: A valid Interconnect, which is turned up and is + ready to use. Attachments may be provisioned on this + Interconnect. - OS_UNPROVISIONED: An Interconnect that has + not completed turnup. No attachments may be provisioned on + this Interconnect. - OS_UNDER_MAINTENANCE: An Interconnect + that is undergoing internal maintenance. No attachments may + be provisioned or updated on this Interconnect. + peer_ip_address (str): + [Output Only] IP address configured on the customer side of + the Interconnect link. The customer should configure this IP + address during turnup when prompted by Google NOC. This can + be used only for ping tests. + provisioned_link_count (int): + [Output Only] Number of links actually provisioned in this + interconnect. + requested_link_count (int): + Target number of physical links in the link + bundle, as requested by the customer. + satisfies_pzs (bool): + [Output Only] Set to true if the resource satisfies the zone + separation organization policy constraints and false + otherwise. Defaults to false if the field is not present. self_link (str): [Output Only] Server-defined URL for the resource. - zone (str): - [Output Only] URL of the zone where the target instance - resides. You must specify this field as part of the HTTP - request URL. It is not settable as a field in the request - body. + state (google.cloud.compute_v1.types.Interconnect.State): + [Output Only] The current state of Interconnect + functionality, which can take one of the following values: - + ACTIVE: The Interconnect is valid, turned up and ready to + use. Attachments may be provisioned on this Interconnect. - + UNPROVISIONED: The Interconnect has not completed turnup. No + attachments may be provisioned on this Interconnect. - + UNDER_MAINTENANCE: The Interconnect is undergoing internal + maintenance. No attachments may be provisioned or updated on + this Interconnect. """ - class NatPolicy(proto.Enum): - r"""NAT option controlling how IPs are NAT'ed to the instance. Currently - only NO_NAT (default value) is supported. + class InterconnectType(proto.Enum): + r"""Type of interconnect, which can take one of the following values: - + PARTNER: A partner-managed interconnection shared between customers + though a partner. - DEDICATED: A dedicated physical interconnection + with the customer. Note that a value IT_PRIVATE has been deprecated + in favor of DEDICATED. """ - UNDEFINED_NAT_POLICY = 0 - NO_NAT = 161455491 + UNDEFINED_INTERCONNECT_TYPE = 0 + DEDICATED = 258411983 + IT_PRIVATE = 335677007 + PARTNER = 461924520 - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - instance = proto.Field(proto.STRING, number=18257045, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - nat_policy = proto.Field( - proto.ENUM, number=509780496, optional=True, enum=NatPolicy, - ) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - zone = proto.Field(proto.STRING, number=3744684, optional=True,) + class LinkType(proto.Enum): + r"""Type of link requested, which can take one of the following values: + - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics - + LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics. Note + that this field indicates the speed of each of the links in the + bundle, not the speed of the entire bundle. + """ + UNDEFINED_LINK_TYPE = 0 + LINK_TYPE_ETHERNET_100G_LR = 337672551 + LINK_TYPE_ETHERNET_10G_LR = 236739749 + class OperationalStatus(proto.Enum): + r"""[Output Only] The current status of this Interconnect's + functionality, which can take one of the following values: - + OS_ACTIVE: A valid Interconnect, which is turned up and is ready to + use. Attachments may be provisioned on this Interconnect. - + OS_UNPROVISIONED: An Interconnect that has not completed turnup. No + attachments may be provisioned on this Interconnect. - + OS_UNDER_MAINTENANCE: An Interconnect that is undergoing internal + maintenance. No attachments may be provisioned or updated on this + Interconnect. + """ + UNDEFINED_OPERATIONAL_STATUS = 0 + OS_ACTIVE = 55721409 + OS_UNPROVISIONED = 239771840 -class TargetInstancesScopedList(proto.Message): - r""" - Attributes: - target_instances (Sequence[google.cloud.compute_v1.types.TargetInstance]): - A list of target instances contained in this - scope. - warning (google.cloud.compute_v1.types.Warning): - Informational warning which replaces the list - of addresses when the list is empty. - """ + class State(proto.Enum): + r"""[Output Only] The current state of Interconnect functionality, which + can take one of the following values: - ACTIVE: The Interconnect is + valid, turned up and ready to use. Attachments may be provisioned on + this Interconnect. - UNPROVISIONED: The Interconnect has not + completed turnup. No attachments may be provisioned on this + Interconnect. - UNDER_MAINTENANCE: The Interconnect is undergoing + internal maintenance. No attachments may be provisioned or updated + on this Interconnect. + """ + UNDEFINED_STATE = 0 + ACTIVE = 314733318 + UNPROVISIONED = 517333979 - target_instances = proto.RepeatedField( - proto.MESSAGE, number=392915280, message="TargetInstance", + admin_enabled = proto.Field(proto.BOOL, number=445675089, optional=True,) + circuit_infos = proto.RepeatedField( + proto.MESSAGE, number=164839855, message="InterconnectCircuitInfo", ) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + customer_name = proto.Field(proto.STRING, number=3665484, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + expected_outages = proto.RepeatedField( + proto.MESSAGE, number=264484123, message="InterconnectOutageNotification", ) - - -class TargetInstanceAggregatedList(proto.Message): - r""" - Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.TargetInstanceAggregatedList.ItemsEntry]): - A list of TargetInstance resources. - kind (str): - Type of resource. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - unreachables (Sequence[str]): - [Output Only] Unreachable resources. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. - """ - - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.MapField( - proto.STRING, - proto.MESSAGE, - number=100526016, - message="TargetInstancesScopedList", + google_ip_address = proto.Field(proto.STRING, number=443105954, optional=True,) + google_reference_id = proto.Field(proto.STRING, number=534944469, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + interconnect_attachments = proto.RepeatedField(proto.STRING, number=425388415,) + interconnect_type = proto.Field( + proto.ENUM, number=515165259, optional=True, enum=InterconnectType, ) kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - unreachables = proto.RepeatedField(proto.STRING, number=243372063,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) - - -class TargetInstanceList(proto.Message): - r"""Contains a list of TargetInstance resources. - Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.TargetInstance]): - A list of TargetInstance resources. - kind (str): - Type of resource. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. - """ - - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="TargetInstance", + link_type = proto.Field(proto.ENUM, number=523207775, optional=True, enum=LinkType,) + location = proto.Field(proto.STRING, number=290430901, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + noc_contact_email = proto.Field(proto.STRING, number=14072832, optional=True,) + operational_status = proto.Field( + proto.ENUM, number=201070847, optional=True, enum=OperationalStatus, ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + peer_ip_address = proto.Field(proto.STRING, number=207735769, optional=True,) + provisioned_link_count = proto.Field(proto.INT32, number=410888565, optional=True,) + requested_link_count = proto.Field(proto.INT32, number=45051387, optional=True,) + satisfies_pzs = proto.Field(proto.BOOL, number=480964267, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) - + state = proto.Field(proto.ENUM, number=109757585, optional=True, enum=State,) -class TargetPool(proto.Message): - r"""Represents a Target Pool resource. - Target pools are used for network TCP/UDP load balancing. A target - pool references member instances, an associated legacy - HttpHealthCheck resource, and, optionally, a backup target pool. For - more information, read Using target pools. (== resource_for - {$api_version}.targetPools ==) +class InterconnectAttachment(proto.Message): + r"""Represents an Interconnect Attachment (VLAN) resource. You + can use Interconnect attachments (VLANS) to connect your Virtual + Private Cloud networks to your on-premises networks through an + Interconnect. For more information, read Creating VLAN + Attachments. Attributes: - backup_pool (str): - The server-defined URL for the resource. This field is - applicable only when the containing target pool is serving a - forwarding rule as the primary pool, and its failoverRatio - field is properly set to a value between [0, 1]. - - backupPool and failoverRatio together define the fallback - behavior of the primary target pool: if the ratio of the - healthy instances in the primary pool is at or below - failoverRatio, traffic arriving at the load-balanced IP will - be directed to the backup pool. - - In case where failoverRatio and backupPool are not set, or - all the instances in the backup pool are unhealthy, the - traffic will be directed back to the primary pool in the - "force" mode, where traffic will be spread to the healthy - instances with the best effort, or to all instances when no - instance is healthy. + admin_enabled (bool): + Determines whether this Attachment will carry packets. Not + present for PARTNER_PROVIDER. + bandwidth (google.cloud.compute_v1.types.InterconnectAttachment.Bandwidth): + Provisioned bandwidth capacity for the interconnect + attachment. For attachments of type DEDICATED, the user can + set the bandwidth. For attachments of type PARTNER, the + Google Partner that is operating the interconnect must set + the bandwidth. Output only for PARTNER type, mutable for + PARTNER_PROVIDER and DEDICATED, and can take one of the + following values: - BPS_50M: 50 Mbit/s - BPS_100M: 100 + Mbit/s - BPS_200M: 200 Mbit/s - BPS_300M: 300 Mbit/s - + BPS_400M: 400 Mbit/s - BPS_500M: 500 Mbit/s - BPS_1G: 1 + Gbit/s - BPS_2G: 2 Gbit/s - BPS_5G: 5 Gbit/s - BPS_10G: 10 + Gbit/s - BPS_20G: 20 Gbit/s - BPS_50G: 50 Gbit/s + candidate_subnets (Sequence[str]): + Up to 16 candidate prefixes that can be used + to restrict the allocation of + cloudRouterIpAddress and customerRouterIpAddress + for this attachment. All prefixes must be within + link-local address space (169.254.0.0/16) and + must be /29 or shorter (/28, /27, etc). Google + will attempt to select an unused /29 from the + supplied candidate prefix(es). The request will + fail if all possible /29s are in use on Google's + edge. If not supplied, Google will randomly + select an unused /29 from all of link-local + space. + cloud_router_ip_address (str): + [Output Only] IPv4 address + prefix length to be configured + on Cloud Router Interface for this interconnect attachment. creation_timestamp (str): [Output Only] Creation timestamp in RFC3339 text format. + customer_router_ip_address (str): + [Output Only] IPv4 address + prefix length to be configured + on the customer router subinterface for this interconnect + attachment. + dataplane_version (int): + [Output Only] Dataplane version for this + InterconnectAttachment. description (str): An optional description of this resource. - Provide this property when you create the - resource. - failover_ratio (float): - This field is applicable only when the containing target - pool is serving a forwarding rule as the primary pool (i.e., - not as a backup pool to some other target pool). The value - of the field must be in [0, 1]. - - If set, backupPool must also be set. They together define - the fallback behavior of the primary target pool: if the - ratio of the healthy instances in the primary pool is at or - below this number, traffic arriving at the load-balanced IP - will be directed to the backup pool. - - In case where failoverRatio is not set or all the instances - in the backup pool are unhealthy, the traffic will be - directed back to the primary pool in the "force" mode, where - traffic will be spread to the healthy instances with the - best effort, or to all instances when no instance is - healthy. - health_checks (Sequence[str]): - The URL of the HttpHealthCheck resource. A - member instance in this pool is considered - healthy if and only if the health checks pass. - Only legacy HttpHealthChecks are supported. Only - one health check may be specified. + edge_availability_domain (google.cloud.compute_v1.types.InterconnectAttachment.EdgeAvailabilityDomain): + Desired availability domain for the attachment. Only + available for type PARTNER, at creation time, and can take + one of the following values: - AVAILABILITY_DOMAIN_ANY - + AVAILABILITY_DOMAIN_1 - AVAILABILITY_DOMAIN_2 For improved + reliability, customers should configure a pair of + attachments, one per availability domain. The selected + availability domain will be provided to the Partner via the + pairing key, so that the provisioned circuit will lie in the + specified domain. If not specified, the value will default + to AVAILABILITY_DOMAIN_ANY. + encryption (google.cloud.compute_v1.types.InterconnectAttachment.Encryption): + Indicates the user-supplied encryption option of this VLAN + attachment (interconnectAttachment). Can only be specified + at attachment creation for PARTNER or DEDICATED attachments. + Possible values are: - NONE - This is the default value, + which means that the VLAN attachment carries unencrypted + traffic. VMs are able to send traffic to, or receive traffic + from, such a VLAN attachment. - IPSEC - The VLAN attachment + carries only encrypted traffic that is encrypted by an IPsec + device, such as an HA VPN gateway or third-party IPsec VPN. + VMs cannot directly send traffic to, or receive traffic + from, such a VLAN attachment. To use *IPsec-encrypted Cloud + Interconnect*, the VLAN attachment must be created with this + option. Not currently available publicly. + google_reference_id (str): + [Output Only] Google reference ID, to be used when raising + support tickets with Google or otherwise to debug backend + connectivity issues. [Deprecated] This field is not used. id (int): [Output Only] The unique identifier for the resource. This identifier is defined by the server. - instances (Sequence[str]): - A list of resource URLs to the virtual - machine instances serving this pool. They must - live in zones contained in the same region as - this pool. + interconnect (str): + URL of the underlying Interconnect object + that this attachment's traffic will traverse + through. + ipsec_internal_addresses (Sequence[str]): + A list of URLs of addresses that have been + reserved for the VLAN attachment. Used only for + the VLAN attachment that has the encryption + option as IPSEC. The addresses must be regional + internal IP address ranges. When creating an HA + VPN gateway over the VLAN attachment, if the + attachment is configured to use a regional + internal IP address, then the VPN gateway's IP + address is allocated from the IP address range + specified here. For example, if the HA VPN + gateway's interface 0 is paired to this VLAN + attachment, then a regional internal IP address + for the VPN gateway interface 0 will be + allocated from the IP address specified for this + VLAN attachment. If this field is not specified + when creating the VLAN attachment, then later on + when creating an HA VPN gateway on this VLAN + attachment, the HA VPN gateway's IP address is + allocated from the regional external IP address + pool. Not currently available publicly. kind (str): [Output Only] Type of the resource. Always - compute#targetPool for target pools. + compute#interconnectAttachment for interconnect attachments. + mtu (int): + Maximum Transmission Unit (MTU), in bytes, of + packets passing through this interconnect + attachment. Only 1440 and 1500 are allowed. If + not specified, the value will default to 1440. name (str): Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, @@ -23469,88 +22647,263 @@ class TargetPool(proto.Message): character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + operational_status (google.cloud.compute_v1.types.InterconnectAttachment.OperationalStatus): + [Output Only] The current status of whether or not this + interconnect attachment is functional, which can take one of + the following values: - OS_ACTIVE: The attachment has been + turned up and is ready to use. - OS_UNPROVISIONED: The + attachment is not ready to use yet, because turnup is not + complete. + pairing_key (str): + [Output only for type PARTNER. Input only for + PARTNER_PROVIDER. Not present for DEDICATED]. The opaque + identifier of an PARTNER attachment used to initiate + provisioning with a selected partner. Of the form + "XXXXX/region/domain". + partner_asn (int): + Optional BGP ASN for the router supplied by a Layer 3 + Partner if they configured BGP on behalf of the customer. + Output only for PARTNER type, input only for + PARTNER_PROVIDER, not available for DEDICATED. + partner_metadata (google.cloud.compute_v1.types.InterconnectAttachmentPartnerMetadata): + Informational metadata about Partner attachments from + Partners to display to customers. Output only for for + PARTNER type, mutable for PARTNER_PROVIDER, not available + for DEDICATED. + private_interconnect_info (google.cloud.compute_v1.types.InterconnectAttachmentPrivateInfo): + [Output Only] Information specific to an + InterconnectAttachment. This property is populated if the + interconnect that this is attached to is of type DEDICATED. region (str): - [Output Only] URL of the region where the target pool - resides. + [Output Only] URL of the region where the regional + interconnect attachment resides. You must specify this field + as part of the HTTP request URL. It is not settable as a + field in the request body. + router (str): + URL of the Cloud Router to be used for + dynamic routing. This router must be in the same + region as this InterconnectAttachment. The + InterconnectAttachment will automatically + connect the Interconnect to the network & region + within which the Cloud Router is configured. + satisfies_pzs (bool): + [Output Only] Set to true if the resource satisfies the zone + separation organization policy constraints and false + otherwise. Defaults to false if the field is not present. self_link (str): [Output Only] Server-defined URL for the resource. - session_affinity (google.cloud.compute_v1.types.TargetPool.SessionAffinity): - Session affinity option, must be one of the following - values: NONE: Connections from the same client IP may go to - any instance in the pool. CLIENT_IP: Connections from the - same client IP will go to the same instance in the pool - while that instance remains healthy. CLIENT_IP_PROTO: - Connections from the same client IP with the same IP - protocol will go to the same instance in the pool while that - instance remains healthy. + state (google.cloud.compute_v1.types.InterconnectAttachment.State): + [Output Only] The current state of this attachment's + functionality. Enum values ACTIVE and UNPROVISIONED are + shared by DEDICATED/PRIVATE, PARTNER, and PARTNER_PROVIDER + interconnect attachments, while enum values PENDING_PARTNER, + PARTNER_REQUEST_RECEIVED, and PENDING_CUSTOMER are used for + only PARTNER and PARTNER_PROVIDER interconnect attachments. + This state can take one of the following values: - ACTIVE: + The attachment has been turned up and is ready to use. - + UNPROVISIONED: The attachment is not ready to use yet, + because turnup is not complete. - PENDING_PARTNER: A + newly-created PARTNER attachment that has not yet been + configured on the Partner side. - PARTNER_REQUEST_RECEIVED: + A PARTNER attachment is in the process of provisioning after + a PARTNER_PROVIDER attachment was created that references + it. - PENDING_CUSTOMER: A PARTNER or PARTNER_PROVIDER + attachment that is waiting for a customer to activate it. - + DEFUNCT: The attachment was deleted externally and is no + longer functional. This could be because the associated + Interconnect was removed, or because the other side of a + Partner attachment was deleted. + type_ (google.cloud.compute_v1.types.InterconnectAttachment.Type): + The type of interconnect attachment this is, which can take + one of the following values: - DEDICATED: an attachment to a + Dedicated Interconnect. - PARTNER: an attachment to a + Partner Interconnect, created by the customer. - + PARTNER_PROVIDER: an attachment to a Partner Interconnect, + created by the partner. + vlan_tag8021q (int): + The IEEE 802.1Q VLAN tag for this attachment, + in the range 2-4094. Only specified at creation + time. """ - class SessionAffinity(proto.Enum): - r"""Session affinity option, must be one of the following values: NONE: - Connections from the same client IP may go to any instance in the - pool. CLIENT_IP: Connections from the same client IP will go to the - same instance in the pool while that instance remains healthy. - CLIENT_IP_PROTO: Connections from the same client IP with the same - IP protocol will go to the same instance in the pool while that - instance remains healthy. + class Bandwidth(proto.Enum): + r"""Provisioned bandwidth capacity for the interconnect attachment. For + attachments of type DEDICATED, the user can set the bandwidth. For + attachments of type PARTNER, the Google Partner that is operating + the interconnect must set the bandwidth. Output only for PARTNER + type, mutable for PARTNER_PROVIDER and DEDICATED, and can take one + of the following values: - BPS_50M: 50 Mbit/s - BPS_100M: 100 Mbit/s + - BPS_200M: 200 Mbit/s - BPS_300M: 300 Mbit/s - BPS_400M: 400 Mbit/s + - BPS_500M: 500 Mbit/s - BPS_1G: 1 Gbit/s - BPS_2G: 2 Gbit/s - + BPS_5G: 5 Gbit/s - BPS_10G: 10 Gbit/s - BPS_20G: 20 Gbit/s - + BPS_50G: 50 Gbit/s """ - UNDEFINED_SESSION_AFFINITY = 0 - CLIENT_IP = 345665051 - CLIENT_IP_NO_DESTINATION = 106122516 - CLIENT_IP_PORT_PROTO = 221722926 - CLIENT_IP_PROTO = 25322148 - GENERATED_COOKIE = 370321204 - HEADER_FIELD = 200737960 - HTTP_COOKIE = 494981627 + UNDEFINED_BANDWIDTH = 0 + BPS_100M = 49547958 + BPS_10G = 278693006 + BPS_1G = 355358448 + BPS_200M = 49577749 + BPS_20G = 278693967 + BPS_2G = 355358479 + BPS_300M = 49607540 + BPS_400M = 49637331 + BPS_500M = 49667122 + BPS_50G = 278696850 + BPS_50M = 278696856 + BPS_5G = 355358572 + + class EdgeAvailabilityDomain(proto.Enum): + r"""Desired availability domain for the attachment. Only available for + type PARTNER, at creation time, and can take one of the following + values: - AVAILABILITY_DOMAIN_ANY - AVAILABILITY_DOMAIN_1 - + AVAILABILITY_DOMAIN_2 For improved reliability, customers should + configure a pair of attachments, one per availability domain. The + selected availability domain will be provided to the Partner via the + pairing key, so that the provisioned circuit will lie in the + specified domain. If not specified, the value will default to + AVAILABILITY_DOMAIN_ANY. + """ + UNDEFINED_EDGE_AVAILABILITY_DOMAIN = 0 + AVAILABILITY_DOMAIN_1 = 349552090 + AVAILABILITY_DOMAIN_2 = 349552091 + AVAILABILITY_DOMAIN_ANY = 375256373 + + class Encryption(proto.Enum): + r"""Indicates the user-supplied encryption option of this VLAN + attachment (interconnectAttachment). Can only be specified at + attachment creation for PARTNER or DEDICATED attachments. Possible + values are: - NONE - This is the default value, which means that the + VLAN attachment carries unencrypted traffic. VMs are able to send + traffic to, or receive traffic from, such a VLAN attachment. - IPSEC + - The VLAN attachment carries only encrypted traffic that is + encrypted by an IPsec device, such as an HA VPN gateway or + third-party IPsec VPN. VMs cannot directly send traffic to, or + receive traffic from, such a VLAN attachment. To use + *IPsec-encrypted Cloud Interconnect*, the VLAN attachment must be + created with this option. Not currently available publicly. + """ + UNDEFINED_ENCRYPTION = 0 + IPSEC = 69882282 NONE = 2402104 - backup_pool = proto.Field(proto.STRING, number=45884537, optional=True,) + class OperationalStatus(proto.Enum): + r"""[Output Only] The current status of whether or not this interconnect + attachment is functional, which can take one of the following + values: - OS_ACTIVE: The attachment has been turned up and is ready + to use. - OS_UNPROVISIONED: The attachment is not ready to use yet, + because turnup is not complete. + """ + UNDEFINED_OPERATIONAL_STATUS = 0 + OS_ACTIVE = 55721409 + OS_UNPROVISIONED = 239771840 + + class State(proto.Enum): + r"""[Output Only] The current state of this attachment's functionality. + Enum values ACTIVE and UNPROVISIONED are shared by + DEDICATED/PRIVATE, PARTNER, and PARTNER_PROVIDER interconnect + attachments, while enum values PENDING_PARTNER, + PARTNER_REQUEST_RECEIVED, and PENDING_CUSTOMER are used for only + PARTNER and PARTNER_PROVIDER interconnect attachments. This state + can take one of the following values: - ACTIVE: The attachment has + been turned up and is ready to use. - UNPROVISIONED: The attachment + is not ready to use yet, because turnup is not complete. - + PENDING_PARTNER: A newly-created PARTNER attachment that has not yet + been configured on the Partner side. - PARTNER_REQUEST_RECEIVED: A + PARTNER attachment is in the process of provisioning after a + PARTNER_PROVIDER attachment was created that references it. - + PENDING_CUSTOMER: A PARTNER or PARTNER_PROVIDER attachment that is + waiting for a customer to activate it. - DEFUNCT: The attachment was + deleted externally and is no longer functional. This could be + because the associated Interconnect was removed, or because the + other side of a Partner attachment was deleted. + """ + UNDEFINED_STATE = 0 + ACTIVE = 314733318 + DEFUNCT = 115891759 + PARTNER_REQUEST_RECEIVED = 513587304 + PENDING_CUSTOMER = 167494054 + PENDING_PARTNER = 387890656 + STATE_UNSPECIFIED = 470755401 + UNPROVISIONED = 517333979 + + class Type(proto.Enum): + r"""The type of interconnect attachment this is, which can take one of + the following values: - DEDICATED: an attachment to a Dedicated + Interconnect. - PARTNER: an attachment to a Partner Interconnect, + created by the customer. - PARTNER_PROVIDER: an attachment to a + Partner Interconnect, created by the partner. + """ + UNDEFINED_TYPE = 0 + DEDICATED = 258411983 + PARTNER = 461924520 + PARTNER_PROVIDER = 483261352 + + admin_enabled = proto.Field(proto.BOOL, number=445675089, optional=True,) + bandwidth = proto.Field( + proto.ENUM, number=181715121, optional=True, enum=Bandwidth, + ) + candidate_subnets = proto.RepeatedField(proto.STRING, number=237842938,) + cloud_router_ip_address = proto.Field( + proto.STRING, number=287392776, optional=True, + ) creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + customer_router_ip_address = proto.Field( + proto.STRING, number=332475761, optional=True, + ) + dataplane_version = proto.Field(proto.INT32, number=34920075, optional=True,) description = proto.Field(proto.STRING, number=422937596, optional=True,) - failover_ratio = proto.Field(proto.FLOAT, number=212667006, optional=True,) - health_checks = proto.RepeatedField(proto.STRING, number=448370606,) + edge_availability_domain = proto.Field( + proto.ENUM, number=71289510, optional=True, enum=EdgeAvailabilityDomain, + ) + encryption = proto.Field( + proto.ENUM, number=97980291, optional=True, enum=Encryption, + ) + google_reference_id = proto.Field(proto.STRING, number=534944469, optional=True,) id = proto.Field(proto.UINT64, number=3355, optional=True,) - instances = proto.RepeatedField(proto.STRING, number=29097598,) + interconnect = proto.Field(proto.STRING, number=224601230, optional=True,) + ipsec_internal_addresses = proto.RepeatedField(proto.STRING, number=407648565,) kind = proto.Field(proto.STRING, number=3292052, optional=True,) + mtu = proto.Field(proto.INT32, number=108462, optional=True,) name = proto.Field(proto.STRING, number=3373707, optional=True,) - region = proto.Field(proto.STRING, number=138946292, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - session_affinity = proto.Field( - proto.ENUM, number=463888561, optional=True, enum=SessionAffinity, + operational_status = proto.Field( + proto.ENUM, number=201070847, optional=True, enum=OperationalStatus, ) - - -class TargetPoolsScopedList(proto.Message): - r""" - Attributes: - target_pools (Sequence[google.cloud.compute_v1.types.TargetPool]): - A list of target pools contained in this - scope. - warning (google.cloud.compute_v1.types.Warning): - Informational warning which replaces the list - of addresses when the list is empty. - """ - - target_pools = proto.RepeatedField( - proto.MESSAGE, number=336072617, message="TargetPool", + pairing_key = proto.Field(proto.STRING, number=439695464, optional=True,) + partner_asn = proto.Field(proto.INT64, number=438166149, optional=True,) + partner_metadata = proto.Field( + proto.MESSAGE, + number=65908934, + optional=True, + message="InterconnectAttachmentPartnerMetadata", ) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + private_interconnect_info = proto.Field( + proto.MESSAGE, + number=237270531, + optional=True, + message="InterconnectAttachmentPrivateInfo", ) + region = proto.Field(proto.STRING, number=138946292, optional=True,) + router = proto.Field(proto.STRING, number=148608841, optional=True,) + satisfies_pzs = proto.Field(proto.BOOL, number=480964267, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + state = proto.Field(proto.ENUM, number=109757585, optional=True, enum=State,) + type_ = proto.Field(proto.ENUM, number=3575610, optional=True, enum=Type,) + vlan_tag8021q = proto.Field(proto.INT32, number=119927836, optional=True,) -class TargetPoolAggregatedList(proto.Message): +class InterconnectAttachmentAggregatedList(proto.Message): r""" Attributes: id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.TargetPoolAggregatedList.ItemsEntry]): - A list of TargetPool resources. + items (Sequence[google.cloud.compute_v1.types.InterconnectAttachmentAggregatedList.ItemsEntry]): + A list of InterconnectAttachmentsScopedList + resources. kind (str): [Output Only] Type of resource. Always - compute#targetPoolAggregatedList for aggregated lists of - target pools. + compute#interconnectAttachmentAggregatedList for aggregated + lists of interconnect attachments. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -23572,7 +22925,10 @@ def raw_page(self): id = proto.Field(proto.STRING, number=3355, optional=True,) items = proto.MapField( - proto.STRING, proto.MESSAGE, number=100526016, message="TargetPoolsScopedList", + proto.STRING, + proto.MESSAGE, + number=100526016, + message="InterconnectAttachmentsScopedList", ) kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) @@ -23583,34 +22939,20 @@ def raw_page(self): ) -class TargetPoolInstanceHealth(proto.Message): - r""" - Attributes: - health_status (Sequence[google.cloud.compute_v1.types.HealthStatus]): - - kind (str): - [Output Only] Type of resource. Always - compute#targetPoolInstanceHealth when checking the health of - an instance. - """ - - health_status = proto.RepeatedField( - proto.MESSAGE, number=380545845, message="HealthStatus", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - +class InterconnectAttachmentList(proto.Message): + r"""Response to the list request, and contains a list of + interconnect attachments. -class TargetPoolList(proto.Message): - r"""Contains a list of TargetPool resources. Attributes: id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.TargetPool]): - A list of TargetPool resources. + items (Sequence[google.cloud.compute_v1.types.InterconnectAttachment]): + A list of InterconnectAttachment resources. kind (str): [Output Only] Type of resource. Always - compute#targetPoolList for lists of target pools. + compute#interconnectAttachmentList for lists of interconnect + attachments. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -23629,7 +22971,9 @@ def raw_page(self): return self id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="TargetPool",) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="InterconnectAttachment", + ) kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) @@ -23638,355 +22982,274 @@ def raw_page(self): ) -class TargetPoolsAddHealthCheckRequest(proto.Message): - r""" - Attributes: - health_checks (Sequence[google.cloud.compute_v1.types.HealthCheckReference]): - The HttpHealthCheck to add to the target - pool. - """ - - health_checks = proto.RepeatedField( - proto.MESSAGE, number=448370606, message="HealthCheckReference", - ) - - -class TargetPoolsAddInstanceRequest(proto.Message): - r""" - Attributes: - instances (Sequence[google.cloud.compute_v1.types.InstanceReference]): - A full or partial URL to an instance to add - to this target pool. This can be a full or - partial URL. For example, the following are - valid URLs: - - https://www.googleapis.com/compute/v1/projects/project- - id/zones/zone/instances/instance-name - - projects/project- - id/zones/zone/instances/instance-name - - zones/zone/instances/instance-name - """ - - instances = proto.RepeatedField( - proto.MESSAGE, number=29097598, message="InstanceReference", - ) - - -class TargetPoolsRemoveHealthCheckRequest(proto.Message): - r""" - Attributes: - health_checks (Sequence[google.cloud.compute_v1.types.HealthCheckReference]): - Health check URL to be removed. This can be a - full or valid partial URL. For example, the - following are valid URLs: - - https://www.googleapis.com/compute/beta/projects/project/global/httpHealthChecks/health- - check - - projects/project/global/httpHealthChecks/health- - check - global/httpHealthChecks/health-check - """ - - health_checks = proto.RepeatedField( - proto.MESSAGE, number=448370606, message="HealthCheckReference", - ) - +class InterconnectAttachmentPartnerMetadata(proto.Message): + r"""Informational metadata about Partner attachments from Partners to + display to customers. These fields are propagated from + PARTNER_PROVIDER attachments to their corresponding PARTNER + attachments. -class TargetPoolsRemoveInstanceRequest(proto.Message): - r""" Attributes: - instances (Sequence[google.cloud.compute_v1.types.InstanceReference]): - URLs of the instances to be removed from - target pool. + interconnect_name (str): + Plain text name of the Interconnect this + attachment is connected to, as displayed in the + Partner's portal. For instance "Chicago 1". This + value may be validated to match approved Partner + values. + partner_name (str): + Plain text name of the Partner providing this + attachment. This value may be validated to match + approved Partner values. + portal_url (str): + URL of the Partner's portal for this + Attachment. Partners may customise this to be a + deep link to the specific resource on the + Partner portal. This value may be validated to + match approved Partner values. """ - instances = proto.RepeatedField( - proto.MESSAGE, number=29097598, message="InstanceReference", - ) - - -class TargetReference(proto.Message): - r""" - Attributes: - target (str): - - """ + interconnect_name = proto.Field(proto.STRING, number=514963356, optional=True,) + partner_name = proto.Field(proto.STRING, number=161747874, optional=True,) + portal_url = proto.Field(proto.STRING, number=269182748, optional=True,) - target = proto.Field(proto.STRING, number=192835985, optional=True,) +class InterconnectAttachmentPrivateInfo(proto.Message): + r"""Information for an interconnect attachment when this belongs + to an interconnect of type DEDICATED. -class TargetSslProxiesSetBackendServiceRequest(proto.Message): - r""" Attributes: - service (str): - The URL of the new BackendService resource - for the targetSslProxy. + tag8021q (int): + [Output Only] 802.1q encapsulation tag to be used for + traffic between Google and the customer, going to and from + this network and region. """ - service = proto.Field(proto.STRING, number=373540533, optional=True,) + tag8021q = proto.Field(proto.UINT32, number=271820992, optional=True,) -class TargetSslProxiesSetProxyHeaderRequest(proto.Message): +class InterconnectAttachmentsScopedList(proto.Message): r""" Attributes: - proxy_header (google.cloud.compute_v1.types.TargetSslProxiesSetProxyHeaderRequest.ProxyHeader): - The new type of proxy header to append before sending data - to the backend. NONE or PROXY_V1 are allowed. + interconnect_attachments (Sequence[google.cloud.compute_v1.types.InterconnectAttachment]): + A list of interconnect attachments contained + in this scope. + warning (google.cloud.compute_v1.types.Warning): + Informational warning which replaces the list + of addresses when the list is empty. """ - class ProxyHeader(proto.Enum): - r"""The new type of proxy header to append before sending data to the - backend. NONE or PROXY_V1 are allowed. - """ - UNDEFINED_PROXY_HEADER = 0 - NONE = 2402104 - PROXY_V1 = 334352940 - - proxy_header = proto.Field( - proto.ENUM, number=160374142, optional=True, enum=ProxyHeader, + interconnect_attachments = proto.RepeatedField( + proto.MESSAGE, number=425388415, message="InterconnectAttachment", + ) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", ) -class TargetSslProxiesSetSslCertificatesRequest(proto.Message): - r""" +class InterconnectCircuitInfo(proto.Message): + r"""Describes a single physical circuit between the Customer and + Google. CircuitInfo objects are created by Google, so all fields + are output only. + Attributes: - ssl_certificates (Sequence[str]): - New set of URLs to SslCertificate resources - to associate with this TargetSslProxy. Currently - exactly one ssl certificate must be specified. + customer_demarc_id (str): + Customer-side demarc ID for this circuit. + google_circuit_id (str): + Google-assigned unique ID for this circuit. + Assigned at circuit turn-up. + google_demarc_id (str): + Google-side demarc ID for this circuit. + Assigned at circuit turn-up and provided by + Google to the customer in the LOA. """ - ssl_certificates = proto.RepeatedField(proto.STRING, number=366006543,) - + customer_demarc_id = proto.Field(proto.STRING, number=28771859, optional=True,) + google_circuit_id = proto.Field(proto.STRING, number=262014711, optional=True,) + google_demarc_id = proto.Field(proto.STRING, number=448196270, optional=True,) -class TargetSslProxy(proto.Message): - r"""Represents a Target SSL Proxy resource. - A target SSL proxy is a component of a SSL Proxy load balancer. - Global forwarding rules reference a target SSL proxy, and the target - proxy then references an external backend service. For more - information, read Using Target Proxies. (== resource_for - {$api_version}.targetSslProxies ==) +class InterconnectDiagnostics(proto.Message): + r"""Diagnostics information about interconnect, contains detailed + and current technical information about Google's side of the + connection. Attributes: - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - description (str): - An optional description of this resource. - Provide this property when you create the - resource. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - kind (str): - [Output Only] Type of the resource. Always - compute#targetSslProxy for target SSL proxies. - name (str): - Name of the resource. Provided by the client when the - resource is created. The name must be 1-63 characters long, - and comply with RFC1035. Specifically, the name must be 1-63 - characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. - proxy_header (google.cloud.compute_v1.types.TargetSslProxy.ProxyHeader): - Specifies the type of proxy header to append before sending - data to the backend, either NONE or PROXY_V1. The default is - NONE. - self_link (str): - [Output Only] Server-defined URL for the resource. - service (str): - URL to the BackendService resource. - ssl_certificates (Sequence[str]): - URLs to SslCertificate resources that are - used to authenticate connections to Backends. At - least one SSL certificate must be specified. - Currently, you may specify up to 15 SSL - certificates. - ssl_policy (str): - URL of SslPolicy resource that will be - associated with the TargetSslProxy resource. If - not set, the TargetSslProxy resource will not - have any SSL policy configured. + arp_caches (Sequence[google.cloud.compute_v1.types.InterconnectDiagnosticsARPEntry]): + A list of InterconnectDiagnostics.ARPEntry + objects, describing individual neighbors + currently seen by the Google router in the ARP + cache for the Interconnect. This will be empty + when the Interconnect is not bundled. + links (Sequence[google.cloud.compute_v1.types.InterconnectDiagnosticsLinkStatus]): + A list of InterconnectDiagnostics.LinkStatus + objects, describing the status for each link on + the Interconnect. + mac_address (str): + The MAC address of the Interconnect's bundle + interface. """ - class ProxyHeader(proto.Enum): - r"""Specifies the type of proxy header to append before sending data to - the backend, either NONE or PROXY_V1. The default is NONE. - """ - UNDEFINED_PROXY_HEADER = 0 - NONE = 2402104 - PROXY_V1 = 334352940 - - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - proxy_header = proto.Field( - proto.ENUM, number=160374142, optional=True, enum=ProxyHeader, + arp_caches = proto.RepeatedField( + proto.MESSAGE, number=414591761, message="InterconnectDiagnosticsARPEntry", ) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - service = proto.Field(proto.STRING, number=373540533, optional=True,) - ssl_certificates = proto.RepeatedField(proto.STRING, number=366006543,) - ssl_policy = proto.Field(proto.STRING, number=295190213, optional=True,) + links = proto.RepeatedField( + proto.MESSAGE, number=102977465, message="InterconnectDiagnosticsLinkStatus", + ) + mac_address = proto.Field(proto.STRING, number=332540164, optional=True,) -class TargetSslProxyList(proto.Message): - r"""Contains a list of TargetSslProxy resources. +class InterconnectDiagnosticsARPEntry(proto.Message): + r"""Describing the ARP neighbor entries seen on this link Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.TargetSslProxy]): - A list of TargetSslProxy resources. - kind (str): - Type of resource. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + ip_address (str): + The IP address of this ARP neighbor. + mac_address (str): + The MAC address of this ARP neighbor. """ - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="TargetSslProxy", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) + ip_address = proto.Field(proto.STRING, number=406272220, optional=True,) + mac_address = proto.Field(proto.STRING, number=332540164, optional=True,) -class TargetTcpProxiesSetBackendServiceRequest(proto.Message): +class InterconnectDiagnosticsLinkLACPStatus(proto.Message): r""" Attributes: - service (str): - The URL of the new BackendService resource - for the targetTcpProxy. + google_system_id (str): + System ID of the port on Google's side of the + LACP exchange. + neighbor_system_id (str): + System ID of the port on the neighbor's side + of the LACP exchange. + state (google.cloud.compute_v1.types.InterconnectDiagnosticsLinkLACPStatus.State): + The state of a LACP link, which can take one + of the following values: - ACTIVE: The link is + configured and active within the bundle. - + DETACHED: The link is not configured within the + bundle. This means that the rest of the object + should be empty. """ - service = proto.Field(proto.STRING, number=373540533, optional=True,) + class State(proto.Enum): + r"""The state of a LACP link, which can take one of the following + values: - ACTIVE: The link is configured and active within the + bundle. - DETACHED: The link is not configured within the + bundle. This means that the rest of the object should be empty. + """ + UNDEFINED_STATE = 0 + ACTIVE = 314733318 + DETACHED = 216562546 + google_system_id = proto.Field(proto.STRING, number=91210405, optional=True,) + neighbor_system_id = proto.Field(proto.STRING, number=343821342, optional=True,) + state = proto.Field(proto.ENUM, number=109757585, optional=True, enum=State,) -class TargetTcpProxiesSetProxyHeaderRequest(proto.Message): + +class InterconnectDiagnosticsLinkOpticalPower(proto.Message): r""" Attributes: - proxy_header (google.cloud.compute_v1.types.TargetTcpProxiesSetProxyHeaderRequest.ProxyHeader): - The new type of proxy header to append before sending data - to the backend. NONE or PROXY_V1 are allowed. + state (google.cloud.compute_v1.types.InterconnectDiagnosticsLinkOpticalPower.State): + The status of the current value when compared to the warning + and alarm levels for the receiving or transmitting + transceiver. Possible states include: - OK: The value has + not crossed a warning threshold. - LOW_WARNING: The value + has crossed below the low warning threshold. - HIGH_WARNING: + The value has crossed above the high warning threshold. - + LOW_ALARM: The value has crossed below the low alarm + threshold. - HIGH_ALARM: The value has crossed above the + high alarm threshold. + value (float): + Value of the current receiving or + transmitting optical power, read in dBm. Take a + known good optical value, give it a 10% margin + and trigger warnings relative to that value. In + general, a -7dBm warning and a -11dBm alarm are + good optical value estimates for most links. """ - class ProxyHeader(proto.Enum): - r"""The new type of proxy header to append before sending data to the - backend. NONE or PROXY_V1 are allowed. + class State(proto.Enum): + r"""The status of the current value when compared to the warning and + alarm levels for the receiving or transmitting transceiver. Possible + states include: - OK: The value has not crossed a warning threshold. + - LOW_WARNING: The value has crossed below the low warning + threshold. - HIGH_WARNING: The value has crossed above the high + warning threshold. - LOW_ALARM: The value has crossed below the low + alarm threshold. - HIGH_ALARM: The value has crossed above the high + alarm threshold. """ - UNDEFINED_PROXY_HEADER = 0 - NONE = 2402104 - PROXY_V1 = 334352940 - - proxy_header = proto.Field( - proto.ENUM, number=160374142, optional=True, enum=ProxyHeader, - ) - + UNDEFINED_STATE = 0 + HIGH_ALARM = 305363284 + HIGH_WARNING = 220984799 + LOW_ALARM = 316659046 + LOW_WARNING = 338793841 + OK = 2524 -class TargetTcpProxy(proto.Message): - r"""Represents a Target TCP Proxy resource. + state = proto.Field(proto.ENUM, number=109757585, optional=True, enum=State,) + value = proto.Field(proto.FLOAT, number=111972721, optional=True,) - A target TCP proxy is a component of a TCP Proxy load balancer. - Global forwarding rules reference target TCP proxy, and the target - proxy then references an external backend service. For more - information, read TCP Proxy Load Balancing overview. (== - resource_for {$api_version}.targetTcpProxies ==) +class InterconnectDiagnosticsLinkStatus(proto.Message): + r""" Attributes: - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - description (str): - An optional description of this resource. - Provide this property when you create the - resource. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - kind (str): - [Output Only] Type of the resource. Always - compute#targetTcpProxy for target TCP proxies. - name (str): - Name of the resource. Provided by the client when the - resource is created. The name must be 1-63 characters long, - and comply with RFC1035. Specifically, the name must be 1-63 - characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. - proxy_bind (bool): - This field only applies when the forwarding rule that - references this target proxy has a loadBalancingScheme set - to INTERNAL_SELF_MANAGED. - - When this field is set to true, Envoy proxies set up inbound - traffic interception and bind to the IP address and port - specified in the forwarding rule. This is generally useful - when using Traffic Director to configure Envoy as a gateway - or middle proxy (in other words, not a sidecar proxy). The - Envoy proxy listens for inbound requests and handles - requests when it receives them. + arp_caches (Sequence[google.cloud.compute_v1.types.InterconnectDiagnosticsARPEntry]): + A list of InterconnectDiagnostics.ARPEntry + objects, describing the ARP neighbor entries + seen on this link. This will be empty if the + link is bundled + circuit_id (str): + The unique ID for this link assigned during + turn up by Google. + google_demarc (str): + The Demarc address assigned by Google and + provided in the LoA. + lacp_status (google.cloud.compute_v1.types.InterconnectDiagnosticsLinkLACPStatus): - The default is false. - proxy_header (google.cloud.compute_v1.types.TargetTcpProxy.ProxyHeader): - Specifies the type of proxy header to append before sending - data to the backend, either NONE or PROXY_V1. The default is - NONE. - self_link (str): - [Output Only] Server-defined URL for the resource. - service (str): - URL to the BackendService resource. + receiving_optical_power (google.cloud.compute_v1.types.InterconnectDiagnosticsLinkOpticalPower): + An InterconnectDiagnostics.LinkOpticalPower + object, describing the current value and status + of the received light level. + transmitting_optical_power (google.cloud.compute_v1.types.InterconnectDiagnosticsLinkOpticalPower): + An InterconnectDiagnostics.LinkOpticalPower + object, describing the current value and status + of the transmitted light level. """ - class ProxyHeader(proto.Enum): - r"""Specifies the type of proxy header to append before sending data to - the backend, either NONE or PROXY_V1. The default is NONE. - """ - UNDEFINED_PROXY_HEADER = 0 - NONE = 2402104 - PROXY_V1 = 334352940 - - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - proxy_bind = proto.Field(proto.BOOL, number=286025582, optional=True,) - proxy_header = proto.Field( - proto.ENUM, number=160374142, optional=True, enum=ProxyHeader, + arp_caches = proto.RepeatedField( + proto.MESSAGE, number=414591761, message="InterconnectDiagnosticsARPEntry", + ) + circuit_id = proto.Field(proto.STRING, number=225180977, optional=True,) + google_demarc = proto.Field(proto.STRING, number=51084, optional=True,) + lacp_status = proto.Field( + proto.MESSAGE, + number=361210415, + optional=True, + message="InterconnectDiagnosticsLinkLACPStatus", + ) + receiving_optical_power = proto.Field( + proto.MESSAGE, + number=244717279, + optional=True, + message="InterconnectDiagnosticsLinkOpticalPower", + ) + transmitting_optical_power = proto.Field( + proto.MESSAGE, + number=459431197, + optional=True, + message="InterconnectDiagnosticsLinkOpticalPower", ) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - service = proto.Field(proto.STRING, number=373540533, optional=True,) -class TargetTcpProxyList(proto.Message): - r"""Contains a list of TargetTcpProxy resources. +class InterconnectList(proto.Message): + r"""Response to the list request, and contains a list of + interconnects. + Attributes: id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.TargetTcpProxy]): - A list of TargetTcpProxy resources. + items (Sequence[google.cloud.compute_v1.types.Interconnect]): + A list of Interconnect resources. kind (str): - Type of resource. + [Output Only] Type of resource. Always + compute#interconnectList for lists of interconnects. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -24006,7 +23269,7 @@ def raw_page(self): id = proto.Field(proto.STRING, number=3355, optional=True,) items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="TargetTcpProxy", + proto.MESSAGE, number=100526016, message="Interconnect", ) kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) @@ -24016,113 +23279,137 @@ def raw_page(self): ) -class TargetVpnGateway(proto.Message): - r"""Represents a Target VPN Gateway resource. - - The target VPN gateway resource represents a Classic Cloud VPN - gateway. For more information, read the the Cloud VPN Overview. (== - resource_for {$api_version}.targetVpnGateways ==) +class InterconnectLocation(proto.Message): + r"""Represents an Interconnect Attachment (VLAN) Location + resource. You can use this resource to find location details + about an Interconnect attachment (VLAN). For more information + about interconnect attachments, read Creating VLAN Attachments. Attributes: + address (str): + [Output Only] The postal address of the Point of Presence, + each line in the address is separated by a newline + character. + availability_zone (str): + [Output Only] Availability zone for this + InterconnectLocation. Within a metropolitan area (metro), + maintenance will not be simultaneously scheduled in more + than one availability zone. Example: "zone1" or "zone2". + city (str): + [Output Only] Metropolitan area designator that indicates + which city an interconnect is located. For example: + "Chicago, IL", "Amsterdam, Netherlands". + continent (google.cloud.compute_v1.types.InterconnectLocation.Continent): + [Output Only] Continent for this location, which can take + one of the following values: - AFRICA - ASIA_PAC - EUROPE - + NORTH_AMERICA - SOUTH_AMERICA creation_timestamp (str): [Output Only] Creation timestamp in RFC3339 text format. description (str): - An optional description of this resource. - Provide this property when you create the - resource. - forwarding_rules (Sequence[str]): - [Output Only] A list of URLs to the ForwardingRule - resources. ForwardingRules are created using - compute.forwardingRules.insert and associated with a VPN - gateway. + [Output Only] An optional description of the resource. + facility_provider (str): + [Output Only] The name of the provider for this facility + (e.g., EQUINIX). + facility_provider_facility_id (str): + [Output Only] A provider-assigned Identifier for this + facility (e.g., Ashburn-DC1). id (int): [Output Only] The unique identifier for the resource. This identifier is defined by the server. kind (str): - [Output Only] Type of resource. Always - compute#targetVpnGateway for target VPN gateways. + [Output Only] Type of the resource. Always + compute#interconnectLocation for interconnect locations. name (str): - Name of the resource. Provided by the client when the - resource is created. The name must be 1-63 characters long, - and comply with RFC1035. Specifically, the name must be 1-63 - characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. - network (str): - URL of the network to which this VPN gateway - is attached. Provided by the client when the VPN - gateway is created. - region (str): - [Output Only] URL of the region where the target VPN gateway - resides. You must specify this field as part of the HTTP - request URL. It is not settable as a field in the request - body. + [Output Only] Name of the resource. + peeringdb_facility_id (str): + [Output Only] The peeringdb identifier for this facility + (corresponding with a netfac type in peeringdb). + region_infos (Sequence[google.cloud.compute_v1.types.InterconnectLocationRegionInfo]): + [Output Only] A list of InterconnectLocation.RegionInfo + objects, that describe parameters pertaining to the relation + between this InterconnectLocation and various Google Cloud + regions. self_link (str): [Output Only] Server-defined URL for the resource. - status (google.cloud.compute_v1.types.TargetVpnGateway.Status): - [Output Only] The status of the VPN gateway, which can be - one of the following: CREATING, READY, FAILED, or DELETING. - tunnels (Sequence[str]): - [Output Only] A list of URLs to VpnTunnel resources. - VpnTunnels are created using the compute.vpntunnels.insert - method and associated with a VPN gateway. + status (google.cloud.compute_v1.types.InterconnectLocation.Status): + [Output Only] The status of this InterconnectLocation, which + can take one of the following values: - CLOSED: The + InterconnectLocation is closed and is unavailable for + provisioning new Interconnects. - AVAILABLE: The + InterconnectLocation is available for provisioning new + Interconnects. + supports_pzs (bool): + [Output Only] Set to true for locations that support + physical zone separation. Defaults to false if the field is + not present. """ + class Continent(proto.Enum): + r"""[Output Only] Continent for this location, which can take one of the + following values: - AFRICA - ASIA_PAC - EUROPE - NORTH_AMERICA - + SOUTH_AMERICA + """ + UNDEFINED_CONTINENT = 0 + AFRICA = 317443706 + ASIA_PAC = 119782269 + C_AFRICA = 71993846 + C_ASIA_PAC = 465668089 + C_EUROPE = 200369438 + C_NORTH_AMERICA = 275697048 + C_SOUTH_AMERICA = 397149792 + EUROPE = 445819298 + NORTH_AMERICA = 448015508 + SOUTH_AMERICA = 32597340 + class Status(proto.Enum): - r"""[Output Only] The status of the VPN gateway, which can be one of the - following: CREATING, READY, FAILED, or DELETING. + r"""[Output Only] The status of this InterconnectLocation, which can + take one of the following values: - CLOSED: The InterconnectLocation + is closed and is unavailable for provisioning new Interconnects. - + AVAILABLE: The InterconnectLocation is available for provisioning + new Interconnects. """ UNDEFINED_STATUS = 0 - CREATING = 455564985 - DELETING = 528602024 - FAILED = 455706685 - READY = 77848963 + AVAILABLE = 442079913 + CLOSED = 380163436 + address = proto.Field(proto.STRING, number=462920692, optional=True,) + availability_zone = proto.Field(proto.STRING, number=158459920, optional=True,) + city = proto.Field(proto.STRING, number=3053931, optional=True,) + continent = proto.Field( + proto.ENUM, number=133442996, optional=True, enum=Continent, + ) creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) description = proto.Field(proto.STRING, number=422937596, optional=True,) - forwarding_rules = proto.RepeatedField(proto.STRING, number=315821365,) + facility_provider = proto.Field(proto.STRING, number=533303309, optional=True,) + facility_provider_facility_id = proto.Field( + proto.STRING, number=87269125, optional=True, + ) id = proto.Field(proto.UINT64, number=3355, optional=True,) kind = proto.Field(proto.STRING, number=3292052, optional=True,) name = proto.Field(proto.STRING, number=3373707, optional=True,) - network = proto.Field(proto.STRING, number=232872494, optional=True,) - region = proto.Field(proto.STRING, number=138946292, optional=True,) + peeringdb_facility_id = proto.Field(proto.STRING, number=536567094, optional=True,) + region_infos = proto.RepeatedField( + proto.MESSAGE, number=312194170, message="InterconnectLocationRegionInfo", + ) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) - tunnels = proto.RepeatedField(proto.STRING, number=104561931,) - - -class TargetVpnGatewaysScopedList(proto.Message): - r""" - Attributes: - target_vpn_gateways (Sequence[google.cloud.compute_v1.types.TargetVpnGateway]): - [Output Only] A list of target VPN gateways contained in - this scope. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning which replaces the list - of addresses when the list is empty. - """ + supports_pzs = proto.Field(proto.BOOL, number=83983214, optional=True,) - target_vpn_gateways = proto.RepeatedField( - proto.MESSAGE, number=401770888, message="TargetVpnGateway", - ) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) +class InterconnectLocationList(proto.Message): + r"""Response to the list request, and contains a list of + interconnect locations. -class TargetVpnGatewayAggregatedList(proto.Message): - r""" Attributes: id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.TargetVpnGatewayAggregatedList.ItemsEntry]): - A list of TargetVpnGateway resources. + items (Sequence[google.cloud.compute_v1.types.InterconnectLocation]): + A list of InterconnectLocation resources. kind (str): [Output Only] Type of resource. Always - compute#targetVpnGateway for target VPN gateways. + compute#interconnectLocationList for lists of interconnect + locations. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -24132,8 +23419,6 @@ class TargetVpnGatewayAggregatedList(proto.Message): to continue paging through the results. self_link (str): [Output Only] Server-defined URL for this resource. - unreachables (Sequence[str]): - [Output Only] Unreachable resources. warning (google.cloud.compute_v1.types.Warning): [Output Only] Informational warning message. """ @@ -24143,214 +23428,388 @@ def raw_page(self): return self id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.MapField( - proto.STRING, - proto.MESSAGE, - number=100526016, - message="TargetVpnGatewaysScopedList", + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="InterconnectLocation", ) kind = proto.Field(proto.STRING, number=3292052, optional=True,) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - unreachables = proto.RepeatedField(proto.STRING, number=243372063,) warning = proto.Field( proto.MESSAGE, number=50704284, optional=True, message="Warning", ) -class TargetVpnGatewayList(proto.Message): - r"""Contains a list of TargetVpnGateway resources. +class InterconnectLocationRegionInfo(proto.Message): + r"""Information about any potential InterconnectAttachments + between an Interconnect at a specific InterconnectLocation, and + a specific Cloud Region. + Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.TargetVpnGateway]): - A list of TargetVpnGateway resources. - kind (str): - [Output Only] Type of resource. Always - compute#targetVpnGateway for target VPN gateways. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + expected_rtt_ms (int): + Expected round-trip time in milliseconds, + from this InterconnectLocation to a VM in this + region. + location_presence (google.cloud.compute_v1.types.InterconnectLocationRegionInfo.LocationPresence): + Identifies the network presence of this + location. + region (str): + URL for the region of this location. """ - @property - def raw_page(self): - return self + class LocationPresence(proto.Enum): + r"""Identifies the network presence of this location.""" + UNDEFINED_LOCATION_PRESENCE = 0 + GLOBAL = 494663587 + LOCAL_REGION = 403535464 + LP_GLOBAL = 429584062 + LP_LOCAL_REGION = 488598851 - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="TargetVpnGateway", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + expected_rtt_ms = proto.Field(proto.INT64, number=422543866, optional=True,) + location_presence = proto.Field( + proto.ENUM, number=101517893, optional=True, enum=LocationPresence, ) + region = proto.Field(proto.STRING, number=138946292, optional=True,) -class UrlMapTestHeader(proto.Message): - r"""HTTP headers used in UrlMapTests. +class InterconnectOutageNotification(proto.Message): + r"""Description of a planned outage on this Interconnect. Attributes: + affected_circuits (Sequence[str]): + If issue_type is IT_PARTIAL_OUTAGE, a list of the + Google-side circuit IDs that will be affected. + description (str): + A description about the purpose of the + outage. + end_time (int): + Scheduled end time for the outage + (milliseconds since Unix epoch). + issue_type (google.cloud.compute_v1.types.InterconnectOutageNotification.IssueType): + Form this outage is expected to take, which can take one of + the following values: - OUTAGE: The Interconnect may be + completely out of service for some or all of the specified + window. - PARTIAL_OUTAGE: Some circuits comprising the + Interconnect as a whole should remain up, but with reduced + bandwidth. Note that the versions of this enum prefixed with + "IT_" have been deprecated in favor of the unprefixed + values. name (str): - Header name. - value (str): - Header value. + Unique identifier for this outage + notification. + source (google.cloud.compute_v1.types.InterconnectOutageNotification.Source): + The party that generated this notification, which can take + the following value: - GOOGLE: this notification as + generated by Google. Note that the value of NSRC_GOOGLE has + been deprecated in favor of GOOGLE. + start_time (int): + Scheduled start time for the outage + (milliseconds since Unix epoch). + state (google.cloud.compute_v1.types.InterconnectOutageNotification.State): + State of this notification, which can take one of the + following values: - ACTIVE: This outage notification is + active. The event could be in the past, present, or future. + See start_time and end_time for scheduling. - CANCELLED: The + outage associated with this notification was cancelled + before the outage was due to start. - COMPLETED: The outage + associated with this notification is complete. Note that the + versions of this enum prefixed with "NS_" have been + deprecated in favor of the unprefixed values. """ + class IssueType(proto.Enum): + r"""Form this outage is expected to take, which can take one of the + following values: - OUTAGE: The Interconnect may be completely out + of service for some or all of the specified window. - + PARTIAL_OUTAGE: Some circuits comprising the Interconnect as a whole + should remain up, but with reduced bandwidth. Note that the versions + of this enum prefixed with "IT_" have been deprecated in favor of + the unprefixed values. + """ + UNDEFINED_ISSUE_TYPE = 0 + IT_OUTAGE = 175779973 + IT_PARTIAL_OUTAGE = 92103971 + OUTAGE = 195285745 + PARTIAL_OUTAGE = 147053455 + + class Source(proto.Enum): + r"""The party that generated this notification, which can take the + following value: - GOOGLE: this notification as generated by Google. + Note that the value of NSRC_GOOGLE has been deprecated in favor of + GOOGLE. + """ + UNDEFINED_SOURCE = 0 + GOOGLE = 497439289 + NSRC_GOOGLE = 510574562 + + class State(proto.Enum): + r"""State of this notification, which can take one of the following + values: - ACTIVE: This outage notification is active. The event + could be in the past, present, or future. See start_time and + end_time for scheduling. - CANCELLED: The outage associated with + this notification was cancelled before the outage was due to start. + - COMPLETED: The outage associated with this notification is + complete. Note that the versions of this enum prefixed with "NS_" + have been deprecated in favor of the unprefixed values. + """ + UNDEFINED_STATE = 0 + ACTIVE = 314733318 + CANCELLED = 41957681 + COMPLETED = 309921323 + NS_ACTIVE = 252563136 + NS_CANCELED = 506579411 + + affected_circuits = proto.RepeatedField(proto.STRING, number=177717013,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + end_time = proto.Field(proto.INT64, number=114938801, optional=True,) + issue_type = proto.Field( + proto.ENUM, number=369639136, optional=True, enum=IssueType, + ) name = proto.Field(proto.STRING, number=3373707, optional=True,) + source = proto.Field(proto.ENUM, number=177235995, optional=True, enum=Source,) + start_time = proto.Field(proto.INT64, number=37467274, optional=True,) + state = proto.Field(proto.ENUM, number=109757585, optional=True, enum=State,) + + +class InterconnectsGetDiagnosticsResponse(proto.Message): + r"""Response for the InterconnectsGetDiagnosticsRequest. + Attributes: + result (google.cloud.compute_v1.types.InterconnectDiagnostics): + + """ + + result = proto.Field( + proto.MESSAGE, + number=139315229, + optional=True, + message="InterconnectDiagnostics", + ) + + +class InvalidateCacheUrlMapRequest(proto.Message): + r"""A request message for UrlMaps.InvalidateCache. See the method + description for details. + + Attributes: + cache_invalidation_rule_resource (google.cloud.compute_v1.types.CacheInvalidationRule): + The body resource for this request + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + url_map (str): + Name of the UrlMap scoping this request. + """ + + cache_invalidation_rule_resource = proto.Field( + proto.MESSAGE, number=312795565, message="CacheInvalidationRule", + ) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + url_map = proto.Field(proto.STRING, number=367020684,) + + +class Items(proto.Message): + r"""Metadata + Attributes: + key (str): + Key for the metadata entry. Keys must conform to the + following regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes + in length. This is reflected as part of a URL in the + metadata server. Additionally, to avoid ambiguity, keys must + not conflict with any other metadata keys for the project. + value (str): + Value for the metadata entry. These are free- + orm strings, and only have meaning as + interpreted by the image running in the + instance. The only restriction placed on values + is that their size must be less than or equal to + 262144 bytes (256 KiB). + """ + + key = proto.Field(proto.STRING, number=106079, optional=True,) value = proto.Field(proto.STRING, number=111972721, optional=True,) -class TestFailure(proto.Message): - r""" +class License(proto.Message): + r"""Represents a License resource. A License represents billing and + aggregate usage data for public and marketplace images. *Caution* + This resource is intended for use only by third-party partners who + are creating Cloud Marketplace images. + Attributes: - actual_output_url (str): - The actual output URL evaluated by load - balancer containing the scheme, host, path and - query parameters. - actual_redirect_response_code (int): - Actual HTTP status code for rule with ``urlRedirect`` - calculated by load balancer - actual_service (str): - BackendService or BackendBucket returned by - load balancer. - expected_output_url (str): - The expected output URL evaluated by load - balancer containing the scheme, host, path and - query parameters. - expected_redirect_response_code (int): - Expected HTTP status code for rule with ``urlRedirect`` - calculated by load balancer - expected_service (str): - Expected BackendService or BackendBucket - resource the given URL should be mapped to. - headers (Sequence[google.cloud.compute_v1.types.UrlMapTestHeader]): - HTTP headers of the request. - host (str): - Host portion of the URL. - path (str): - Path portion including query parameters in - the URL. + charges_use_fee (bool): + [Output Only] Deprecated. This field no longer reflects + whether a license charges a usage fee. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + An optional textual description of the + resource; provided by the client when the + resource is created. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + kind (str): + [Output Only] Type of resource. Always compute#license for + licenses. + license_code (int): + [Output Only] The unique code used to attach this license to + images, snapshots, and disks. + name (str): + Name of the resource. The name must be 1-63 + characters long and comply with RFC1035. + resource_requirements (google.cloud.compute_v1.types.LicenseResourceRequirements): + + self_link (str): + [Output Only] Server-defined URL for the resource. + transferable (bool): + If false, licenses will not be copied from + the source resource when creating an image from + a disk, disk from snapshot, or snapshot from + disk. + """ + + charges_use_fee = proto.Field(proto.BOOL, number=372412622, optional=True,) + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + license_code = proto.Field(proto.UINT64, number=1467179, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + resource_requirements = proto.Field( + proto.MESSAGE, + number=214292769, + optional=True, + message="LicenseResourceRequirements", + ) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + transferable = proto.Field(proto.BOOL, number=4349893, optional=True,) + + +class LicenseCode(proto.Message): + r"""Represents a License Code resource. A License Code is a unique + identifier used to represent a license resource. *Caution* This + resource is intended for use only by third-party partners who are + creating Cloud Marketplace images. + + Attributes: + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + [Output Only] Description of this License Code. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + kind (str): + [Output Only] Type of resource. Always compute#licenseCode + for licenses. + license_alias (Sequence[google.cloud.compute_v1.types.LicenseCodeLicenseAlias]): + [Output Only] URL and description aliases of Licenses with + the same License Code. + name (str): + [Output Only] Name of the resource. The name is 1-20 + characters long and must be a valid 64 bit integer. + self_link (str): + [Output Only] Server-defined URL for the resource. + state (google.cloud.compute_v1.types.LicenseCode.State): + [Output Only] Current state of this License Code. + transferable (bool): + [Output Only] If true, the license will remain attached when + creating images or snapshots from disks. Otherwise, the + license is not transferred. """ - actual_output_url = proto.Field(proto.STRING, number=287075458, optional=True,) - actual_redirect_response_code = proto.Field( - proto.INT32, number=42926553, optional=True, - ) - actual_service = proto.Field(proto.STRING, number=440379652, optional=True,) - expected_output_url = proto.Field(proto.STRING, number=433967384, optional=True,) - expected_redirect_response_code = proto.Field( - proto.INT32, number=18888047, optional=True, - ) - expected_service = proto.Field(proto.STRING, number=133987374, optional=True,) - headers = proto.RepeatedField( - proto.MESSAGE, number=258436998, message="UrlMapTestHeader", + class State(proto.Enum): + r"""[Output Only] Current state of this License Code.""" + UNDEFINED_STATE = 0 + DISABLED = 516696700 + ENABLED = 182130465 + RESTRICTED = 261551195 + STATE_UNSPECIFIED = 470755401 + TERMINATED = 250018339 + + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + license_alias = proto.RepeatedField( + proto.MESSAGE, number=43550930, message="LicenseCodeLicenseAlias", ) - host = proto.Field(proto.STRING, number=3208616, optional=True,) - path = proto.Field(proto.STRING, number=3433509, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + state = proto.Field(proto.ENUM, number=109757585, optional=True, enum=State,) + transferable = proto.Field(proto.BOOL, number=4349893, optional=True,) -class TestPermissionsRequest(proto.Message): +class LicenseCodeLicenseAlias(proto.Message): r""" Attributes: - permissions (Sequence[str]): - The set of permissions to check for the 'resource'. - Permissions with wildcards (such as '*' or 'storage.*') are - not allowed. + description (str): + [Output Only] Description of this License Code. + self_link (str): + [Output Only] URL of license corresponding to this License + Code. """ - permissions = proto.RepeatedField(proto.STRING, number=59962500,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) -class TestPermissionsResponse(proto.Message): - r""" +class LicenseResourceCommitment(proto.Message): + r"""Commitment for a particular license resource. Attributes: - permissions (Sequence[str]): - A subset of ``TestPermissionsRequest.permissions`` that the - caller is allowed. + amount (int): + The number of licenses purchased. + cores_per_license (str): + Specifies the core range of the instance for + which this license applies. + license_ (str): + Any applicable license URI. """ - permissions = proto.RepeatedField(proto.STRING, number=59962500,) + amount = proto.Field(proto.INT64, number=196759640, optional=True,) + cores_per_license = proto.Field(proto.STRING, number=32482324, optional=True,) + license_ = proto.Field(proto.STRING, number=166757441, optional=True,) -class UrlMapTest(proto.Message): - r"""Message for the expected URL mappings. +class LicenseResourceRequirements(proto.Message): + r""" Attributes: - description (str): - Description of this test case. - expected_output_url (str): - The expected output URL evaluated by load balancer - containing the scheme, host, path and query parameters. For - rules that forward requests to backends, the test passes - only when expectedOutputUrl matches the request forwarded by - load balancer to backends. For rules with urlRewrite, the - test verifies that the forwarded request matches hostRewrite - and pathPrefixRewrite in the urlRewrite action. When service - is specified, expectedOutputUrl`s scheme is ignored. For - rules with urlRedirect, the test passes only if - expectedOutputUrl matches the URL in the load balancer's - redirect response. If urlRedirect specifies https_redirect, - the test passes only if the scheme in expectedOutputUrl is - also set to https. If urlRedirect specifies strip_query, the - test passes only if expectedOutputUrl does not contain any - query parameters. expectedOutputUrl is optional when service - is specified. - expected_redirect_response_code (int): - For rules with urlRedirect, the test passes - only if expectedRedirectResponseCode matches the - HTTP status code in load balancer's redirect - response. expectedRedirectResponseCode cannot be - set when service is set. - headers (Sequence[google.cloud.compute_v1.types.UrlMapTestHeader]): - HTTP headers for this request. If headers - contains a host header, then host must also - match the header value. - host (str): - Host portion of the URL. If headers contains - a host header, then host must also match the - header value. - path (str): - Path portion of the URL. - service (str): - Expected BackendService or BackendBucket - resource the given URL should be mapped to. - service cannot be set if - expectedRedirectResponseCode is set. + min_guest_cpu_count (int): + Minimum number of guest cpus required to use + the Instance. Enforced at Instance creation and + Instance start. + min_memory_mb (int): + Minimum memory required to use the Instance. + Enforced at Instance creation and Instance + start. """ - description = proto.Field(proto.STRING, number=422937596, optional=True,) - expected_output_url = proto.Field(proto.STRING, number=433967384, optional=True,) - expected_redirect_response_code = proto.Field( - proto.INT32, number=18888047, optional=True, - ) - headers = proto.RepeatedField( - proto.MESSAGE, number=258436998, message="UrlMapTestHeader", - ) - host = proto.Field(proto.STRING, number=3208616, optional=True,) - path = proto.Field(proto.STRING, number=3433509, optional=True,) - service = proto.Field(proto.STRING, number=373540533, optional=True,) + min_guest_cpu_count = proto.Field(proto.INT32, number=477964836, optional=True,) + min_memory_mb = proto.Field(proto.INT32, number=504785894, optional=True,) -class UrlMapList(proto.Message): - r"""Contains a list of UrlMap resources. +class LicensesListResponse(proto.Message): + r""" Attributes: id (str): [Output Only] Unique identifier for the resource; defined by the server. - items (Sequence[google.cloud.compute_v1.types.UrlMap]): - A list of UrlMap resources. - kind (str): - Type of resource. + items (Sequence[google.cloud.compute_v1.types.License]): + A list of License resources. next_page_token (str): [Output Only] This token allows you to get the next page of results for list requests. If the number of results is @@ -24369,8 +23828,7 @@ def raw_page(self): return self id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="UrlMap",) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="License",) next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) self_link = proto.Field(proto.STRING, number=456214797, optional=True,) warning = proto.Field( @@ -24378,1141 +23836,2022 @@ def raw_page(self): ) -class UrlMapReference(proto.Message): - r""" - Attributes: - url_map (str): +class ListAcceleratorTypesRequest(proto.Message): + r"""A request message for AcceleratorTypes.List. See the method + description for details. + Attributes: + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. + zone (str): + The name of the zone for this request. """ - url_map = proto.Field(proto.STRING, number=367020684, optional=True,) - + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class UrlMapValidationResult(proto.Message): - r"""Message representing the validation result for a UrlMap. - Attributes: - load_errors (Sequence[str]): - load_succeeded (bool): - Whether the given UrlMap can be successfully - loaded. If false, 'loadErrors' indicates the - reasons. - test_failures (Sequence[google.cloud.compute_v1.types.TestFailure]): +class ListAddressesRequest(proto.Message): + r"""A request message for Addresses.List. See the method + description for details. - test_passed (bool): - If successfully loaded, this field indicates - whether the test passed. If false, - 'testFailures's indicate the reason of failure. + Attributes: + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + region (str): + Name of the region for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - load_errors = proto.RepeatedField(proto.STRING, number=310147300,) - load_succeeded = proto.Field(proto.BOOL, number=128326216, optional=True,) - test_failures = proto.RepeatedField( - proto.MESSAGE, number=505934134, message="TestFailure", - ) - test_passed = proto.Field(proto.BOOL, number=192708797, optional=True,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class UrlMapsScopedList(proto.Message): - r""" +class ListAssociationsFirewallPolicyRequest(proto.Message): + r"""A request message for FirewallPolicies.ListAssociations. See + the method description for details. + Attributes: - url_maps (Sequence[google.cloud.compute_v1.types.UrlMap]): - A list of UrlMaps contained in this scope. - warning (google.cloud.compute_v1.types.Warning): - Informational warning which replaces the list - of backend services when the list is empty. + target_resource (str): + The target resource to list associations. It + is an organization, or a folder. """ - url_maps = proto.RepeatedField(proto.MESSAGE, number=103352167, message="UrlMap",) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) + target_resource = proto.Field(proto.STRING, number=467318524, optional=True,) -class UrlMapsAggregatedList(proto.Message): - r""" +class ListAutoscalersRequest(proto.Message): + r"""A request message for Autoscalers.List. See the method + description for details. + Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.UrlMapsAggregatedList.ItemsEntry]): - A list of UrlMapsScopedList resources. - kind (str): - Type of resource. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - unreachables (Sequence[str]): - [Output Only] Unreachable resources. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. + zone (str): + Name of the zone for this request. """ - @property - def raw_page(self): - return self + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.MapField( - proto.STRING, proto.MESSAGE, number=100526016, message="UrlMapsScopedList", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - unreachables = proto.RepeatedField(proto.STRING, number=243372063,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) +class ListAvailableFeaturesSslPoliciesRequest(proto.Message): + r"""A request message for SslPolicies.ListAvailableFeatures. See + the method description for details. -class UrlMapsValidateRequest(proto.Message): - r""" Attributes: - resource (google.cloud.compute_v1.types.UrlMap): - Content of the UrlMap to be validated. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - resource = proto.Field( - proto.MESSAGE, number=195806222, optional=True, message="UrlMap", - ) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class UrlMapsValidateResponse(proto.Message): - r""" - Attributes: - result (google.cloud.compute_v1.types.UrlMapValidationResult): +class ListBackendBucketsRequest(proto.Message): + r"""A request message for BackendBuckets.List. See the method + description for details. + Attributes: + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - result = proto.Field( - proto.MESSAGE, - number=139315229, - optional=True, - message="UrlMapValidationResult", - ) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class UsableSubnetworkSecondaryRange(proto.Message): - r"""Secondary IP range of a usable subnetwork. +class ListBackendServicesRequest(proto.Message): + r"""A request message for BackendServices.List. See the method + description for details. + Attributes: - ip_cidr_range (str): - The range of IP addresses belonging to this - subnetwork secondary range. - range_name (str): - The name associated with this subnetwork - secondary range, used when adding an alias IP - range to a VM instance. The name must be 1-63 - characters long, and comply with RFC1035. The - name must be unique within the subnetwork. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - ip_cidr_range = proto.Field(proto.STRING, number=98117322, optional=True,) - range_name = proto.Field(proto.STRING, number=332216397, optional=True,) - - -class UsableSubnetwork(proto.Message): - r"""Subnetwork which the current user has compute.subnetworks.use - permission on. - - Attributes: - ip_cidr_range (str): - The range of internal addresses that are - owned by this subnetwork. - network (str): - Network URL. - secondary_ip_ranges (Sequence[google.cloud.compute_v1.types.UsableSubnetworkSecondaryRange]): - Secondary IP ranges. - subnetwork (str): - Subnetwork URL. - """ + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - ip_cidr_range = proto.Field(proto.STRING, number=98117322, optional=True,) - network = proto.Field(proto.STRING, number=232872494, optional=True,) - secondary_ip_ranges = proto.RepeatedField( - proto.MESSAGE, number=136658915, message="UsableSubnetworkSecondaryRange", - ) - subnetwork = proto.Field(proto.STRING, number=307827694, optional=True,) +class ListDiskTypesRequest(proto.Message): + r"""A request message for DiskTypes.List. See the method + description for details. -class UsableSubnetworksAggregatedList(proto.Message): - r""" Attributes: - id (str): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - items (Sequence[google.cloud.compute_v1.types.UsableSubnetwork]): - [Output] A list of usable subnetwork URLs. - kind (str): - [Output Only] Type of resource. Always - compute#usableSubnetworksAggregatedList for aggregated lists - of usable subnetworks. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. + zone (str): + The name of the zone for this request. """ - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField( - proto.MESSAGE, number=100526016, message="UsableSubnetwork", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class VmEndpointNatMappingsInterfaceNatMappings(proto.Message): - r"""Contain information of Nat mapping for an interface of this - endpoint. +class ListDisksRequest(proto.Message): + r"""A request message for Disks.List. See the method description + for details. Attributes: - drain_nat_ip_port_ranges (Sequence[str]): - List of all drain IP:port-range mappings assigned to this - interface. These ranges are inclusive, that is, both the - first and the last ports can be used for NAT. Example: - ["2.2.2.2:12345-12355", "1.1.1.1:2234-2234"]. - nat_ip_port_ranges (Sequence[str]): - A list of all IP:port-range mappings assigned to this - interface. These ranges are inclusive, that is, both the - first and the last ports can be used for NAT. Example: - ["2.2.2.2:12345-12355", "1.1.1.1:2234-2234"]. - num_total_drain_nat_ports (int): - Total number of drain ports across all NAT IPs allocated to - this interface. It equals to the aggregated port number in - the field drain_nat_ip_port_ranges. - num_total_nat_ports (int): - Total number of ports across all NAT IPs allocated to this - interface. It equals to the aggregated port number in the - field nat_ip_port_ranges. - source_alias_ip_range (str): - Alias IP range for this interface endpoint. - It will be a private (RFC 1918) IP range. - Examples: "10.33.4.55/32", or "192.168.5.0/24". - source_virtual_ip (str): - Primary IP of the VM for this NIC. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. + zone (str): + The name of the zone for this request. """ - drain_nat_ip_port_ranges = proto.RepeatedField(proto.STRING, number=395440577,) - nat_ip_port_ranges = proto.RepeatedField(proto.STRING, number=531830810,) - num_total_drain_nat_ports = proto.Field( - proto.INT32, number=335532793, optional=True, - ) - num_total_nat_ports = proto.Field(proto.INT32, number=299904384, optional=True,) - source_alias_ip_range = proto.Field(proto.STRING, number=440340952, optional=True,) - source_virtual_ip = proto.Field(proto.STRING, number=149836159, optional=True,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class VmEndpointNatMappings(proto.Message): - r"""Contain information of Nat mapping for a VM endpoint (i.e., - NIC). +class ListErrorsInstanceGroupManagersRequest(proto.Message): + r"""A request message for InstanceGroupManagers.ListErrors. See + the method description for details. Attributes: - instance_name (str): - Name of the VM instance which the endpoint - belongs to - interface_nat_mappings (Sequence[google.cloud.compute_v1.types.VmEndpointNatMappingsInterfaceNatMappings]): - + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + instance_group_manager (str): + The name of the managed instance group. It must be a string + that meets the requirements in RFC1035, or an unsigned long + integer: must match regexp pattern: + (?:`a-z `__?)|1-9{0,19}. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. + zone (str): + The name of the zone where the managed + instance group is located. It should conform to + RFC1035. """ - instance_name = proto.Field(proto.STRING, number=227947509, optional=True,) - interface_nat_mappings = proto.RepeatedField( - proto.MESSAGE, - number=256196617, - message="VmEndpointNatMappingsInterfaceNatMappings", - ) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + instance_group_manager = proto.Field(proto.STRING, number=249363395,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class VmEndpointNatMappingsList(proto.Message): - r"""Contains a list of VmEndpointNatMappings. +class ListErrorsRegionInstanceGroupManagersRequest(proto.Message): + r"""A request message for RegionInstanceGroupManagers.ListErrors. + See the method description for details. + Attributes: - id (str): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - kind (str): - [Output Only] Type of resource. Always - compute#vmEndpointNatMappingsList for lists of Nat mappings - of VM endpoints. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - result (Sequence[google.cloud.compute_v1.types.VmEndpointNatMappings]): - [Output Only] A list of Nat mapping information of VM - endpoints. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + instance_group_manager (str): + The name of the managed instance group. It must be a string + that meets the requirements in RFC1035, or an unsigned long + integer: must match regexp pattern: + (?:`a-z `__?)|1-9{0,19}. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. This + should conform to RFC1035. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - @property - def raw_page(self): - return self + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + instance_group_manager = proto.Field(proto.STRING, number=249363395,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - result = proto.RepeatedField( - proto.MESSAGE, number=139315229, message="VmEndpointNatMappings", - ) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) +class ListExternalVpnGatewaysRequest(proto.Message): + r"""A request message for ExternalVpnGateways.List. See the + method description for details. -class VpnGatewayVpnGatewayInterface(proto.Message): - r"""A VPN gateway interface. Attributes: - id (int): - The numeric ID of this VPN gateway interface. - interconnect_attachment (str): - URL of the interconnect attachment resource. - When the value of this field is present, the VPN - Gateway will be used for IPsec-encrypted Cloud - Interconnect; all Egress or Ingress traffic for - this VPN Gateway interface will go through the - specified interconnect attachment resource. Not - currently available in all Interconnect - locations. - ip_address (str): - [Output Only] The external IP address for this VPN gateway - interface. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - id = proto.Field(proto.UINT32, number=3355, optional=True,) - interconnect_attachment = proto.Field( - proto.STRING, number=308135284, optional=True, - ) - ip_address = proto.Field(proto.STRING, number=406272220, optional=True,) - + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class VpnGateway(proto.Message): - r"""Represents a HA VPN gateway. - HA VPN is a high-availability (HA) Cloud VPN solution that lets you - securely connect your on-premises network to your Google Cloud - Virtual Private Cloud network through an IPsec VPN connection in a - single region. For more information about Cloud HA VPN solutions, - see Cloud VPN topologies . (== resource_for - {$api_version}.vpnGateways ==) +class ListFirewallPoliciesRequest(proto.Message): + r"""A request message for FirewallPolicies.List. See the method + description for details. Attributes: - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - description (str): - An optional description of this resource. - Provide this property when you create the - resource. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - kind (str): - [Output Only] Type of resource. Always compute#vpnGateway - for VPN gateways. - label_fingerprint (str): - A fingerprint for the labels being applied to - this VpnGateway, which is essentially a hash of - the labels set used for optimistic locking. The - fingerprint is initially generated by Compute - Engine and changes after every request to modify - or update labels. You must always provide an up- - to-date fingerprint hash in order to update or - change labels, otherwise the request will fail - with error 412 conditionNotMet. To see the - latest fingerprint, make a get() request to - retrieve an VpnGateway. - labels (Sequence[google.cloud.compute_v1.types.VpnGateway.LabelsEntry]): - Labels for this resource. These can only be - added or modified by the setLabels method. Each - label key/value pair must comply with RFC1035. - Label values may be empty. - name (str): - Name of the resource. Provided by the client when the - resource is created. The name must be 1-63 characters long, - and comply with RFC1035. Specifically, the name must be 1-63 - characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. - network (str): - URL of the network to which this VPN gateway - is attached. Provided by the client when the VPN - gateway is created. - region (str): - [Output Only] URL of the region where the VPN gateway - resides. - self_link (str): - [Output Only] Server-defined URL for the resource. - vpn_interfaces (Sequence[google.cloud.compute_v1.types.VpnGatewayVpnGatewayInterface]): - A list of interfaces on this VPN gateway. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + parent_id (str): + Parent ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - label_fingerprint = proto.Field(proto.STRING, number=178124825, optional=True,) - labels = proto.MapField(proto.STRING, proto.STRING, number=500195327,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - network = proto.Field(proto.STRING, number=232872494, optional=True,) - region = proto.Field(proto.STRING, number=138946292, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - vpn_interfaces = proto.RepeatedField( - proto.MESSAGE, number=91842181, message="VpnGatewayVpnGatewayInterface", - ) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + parent_id = proto.Field(proto.STRING, number=459714768, optional=True,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class VpnGatewaysScopedList(proto.Message): - r""" +class ListFirewallsRequest(proto.Message): + r"""A request message for Firewalls.List. See the method + description for details. + Attributes: - vpn_gateways (Sequence[google.cloud.compute_v1.types.VpnGateway]): - [Output Only] A list of VPN gateways contained in this - scope. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning which replaces the list - of addresses when the list is empty. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - vpn_gateways = proto.RepeatedField( - proto.MESSAGE, number=259177882, message="VpnGateway", - ) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class VpnGatewayAggregatedList(proto.Message): - r""" +class ListForwardingRulesRequest(proto.Message): + r"""A request message for ForwardingRules.List. See the method + description for details. + Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.VpnGatewayAggregatedList.ItemsEntry]): - A list of VpnGateway resources. - kind (str): - [Output Only] Type of resource. Always compute#vpnGateway - for VPN gateways. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - unreachables (Sequence[str]): - [Output Only] Unreachable resources. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - @property - def raw_page(self): - return self + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.MapField( - proto.STRING, proto.MESSAGE, number=100526016, message="VpnGatewaysScopedList", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - unreachables = proto.RepeatedField(proto.STRING, number=243372063,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) +class ListGlobalAddressesRequest(proto.Message): + r"""A request message for GlobalAddresses.List. See the method + description for details. -class VpnGatewayList(proto.Message): - r"""Contains a list of VpnGateway resources. Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.VpnGateway]): - A list of VpnGateway resources. - kind (str): - [Output Only] Type of resource. Always compute#vpnGateway - for VPN gateways. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="VpnGateway",) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class VpnGatewayStatusVpnConnection(proto.Message): - r"""A VPN connection contains all VPN tunnels connected from this - VpnGateway to the same peer gateway. The peer gateway could - either be a external VPN gateway or GCP VPN gateway. +class ListGlobalForwardingRulesRequest(proto.Message): + r"""A request message for GlobalForwardingRules.List. See the + method description for details. Attributes: - peer_external_gateway (str): - URL reference to the peer external VPN gateways to which the - VPN tunnels in this VPN connection are connected. This field - is mutually exclusive with peer_gcp_gateway. - peer_gcp_gateway (str): - URL reference to the peer side VPN gateways to which the VPN - tunnels in this VPN connection are connected. This field is - mutually exclusive with peer_gcp_gateway. - state (google.cloud.compute_v1.types.VpnGatewayStatusHighAvailabilityRequirementState): - HighAvailabilityRequirementState for the VPN - connection. - tunnels (Sequence[google.cloud.compute_v1.types.VpnGatewayStatusTunnel]): - List of VPN tunnels that are in this VPN - connection. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - peer_external_gateway = proto.Field(proto.STRING, number=384956173, optional=True,) - peer_gcp_gateway = proto.Field(proto.STRING, number=281867452, optional=True,) - state = proto.Field( - proto.MESSAGE, - number=109757585, - optional=True, - message="VpnGatewayStatusHighAvailabilityRequirementState", - ) - tunnels = proto.RepeatedField( - proto.MESSAGE, number=104561931, message="VpnGatewayStatusTunnel", - ) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class VpnGatewayStatus(proto.Message): - r""" +class ListGlobalNetworkEndpointGroupsRequest(proto.Message): + r"""A request message for GlobalNetworkEndpointGroups.List. See + the method description for details. + Attributes: - vpn_connections (Sequence[google.cloud.compute_v1.types.VpnGatewayStatusVpnConnection]): - List of VPN connection for this VpnGateway. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - vpn_connections = proto.RepeatedField( - proto.MESSAGE, number=439334538, message="VpnGatewayStatusVpnConnection", - ) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class VpnGatewayStatusHighAvailabilityRequirementState(proto.Message): - r"""Describes the high availability requirement state for the VPN - connection between this Cloud VPN gateway and a peer gateway. +class ListGlobalOperationsRequest(proto.Message): + r"""A request message for GlobalOperations.List. See the method + description for details. Attributes: - state (google.cloud.compute_v1.types.VpnGatewayStatusHighAvailabilityRequirementState.State): - Indicates the high availability requirement state for the - VPN connection. Valid values are CONNECTION_REDUNDANCY_MET, - CONNECTION_REDUNDANCY_NOT_MET. - unsatisfied_reason (google.cloud.compute_v1.types.VpnGatewayStatusHighAvailabilityRequirementState.UnsatisfiedReason): - Indicates the reason why the VPN connection does not meet - the high availability redundancy criteria/requirement. Valid - values is INCOMPLETE_TUNNELS_COVERAGE. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - class State(proto.Enum): - r"""Indicates the high availability requirement state for the VPN - connection. Valid values are CONNECTION_REDUNDANCY_MET, - CONNECTION_REDUNDANCY_NOT_MET. - """ - UNDEFINED_STATE = 0 - CONNECTION_REDUNDANCY_MET = 505242907 - CONNECTION_REDUNDANCY_NOT_MET = 511863311 - - class UnsatisfiedReason(proto.Enum): - r"""Indicates the reason why the VPN connection does not meet the high - availability redundancy criteria/requirement. Valid values is - INCOMPLETE_TUNNELS_COVERAGE. - """ - UNDEFINED_UNSATISFIED_REASON = 0 - INCOMPLETE_TUNNELS_COVERAGE = 55917437 + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - state = proto.Field(proto.ENUM, number=109757585, optional=True, enum=State,) - unsatisfied_reason = proto.Field( - proto.ENUM, number=55016330, optional=True, enum=UnsatisfiedReason, - ) +class ListGlobalOrganizationOperationsRequest(proto.Message): + r"""A request message for GlobalOrganizationOperations.List. See + the method description for details. -class VpnGatewayStatusTunnel(proto.Message): - r"""Contains some information about a VPN tunnel. Attributes: - local_gateway_interface (int): - The VPN gateway interface this VPN tunnel is - associated with. - peer_gateway_interface (int): - The peer gateway interface this VPN tunnel is - connected to, the peer gateway could either be - an external VPN gateway or GCP VPN gateway. - tunnel_url (str): - URL reference to the VPN tunnel. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + parent_id (str): + Parent ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - local_gateway_interface = proto.Field( - proto.UINT32, number=158764330, optional=True, - ) - peer_gateway_interface = proto.Field(proto.UINT32, number=214380385, optional=True,) - tunnel_url = proto.Field(proto.STRING, number=78975256, optional=True,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + parent_id = proto.Field(proto.STRING, number=459714768, optional=True,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class VpnGatewaysGetStatusResponse(proto.Message): - r""" - Attributes: - result (google.cloud.compute_v1.types.VpnGatewayStatus): +class ListGlobalPublicDelegatedPrefixesRequest(proto.Message): + r"""A request message for GlobalPublicDelegatedPrefixes.List. See + the method description for details. + Attributes: + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - result = proto.Field( - proto.MESSAGE, number=139315229, optional=True, message="VpnGatewayStatus", - ) - + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class VpnTunnel(proto.Message): - r"""Represents a Cloud VPN Tunnel resource. - For more information about VPN, read the the Cloud VPN Overview. (== - resource_for {$api_version}.vpnTunnels ==) +class ListHealthChecksRequest(proto.Message): + r"""A request message for HealthChecks.List. See the method + description for details. Attributes: - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - description (str): - An optional description of this resource. - Provide this property when you create the - resource. - detailed_status (str): - [Output Only] Detailed status message for the VPN tunnel. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - ike_version (int): - IKE protocol version to use when establishing - the VPN tunnel with the peer VPN gateway. - Acceptable IKE versions are 1 or 2. The default - version is 2. - kind (str): - [Output Only] Type of resource. Always compute#vpnTunnel for - VPN tunnels. - local_traffic_selector (Sequence[str]): - Local traffic selector to use when - establishing the VPN tunnel with the peer VPN - gateway. The value should be a CIDR formatted - string, for example: 192.168.0.0/16. The ranges - must be disjoint. Only IPv4 is supported. - name (str): - Name of the resource. Provided by the client when the - resource is created. The name must be 1-63 characters long, - and comply with RFC1035. Specifically, the name must be 1-63 - characters long and match the regular expression - ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first - character must be a lowercase letter, and all following - characters must be a dash, lowercase letter, or digit, - except the last character, which cannot be a dash. - peer_external_gateway (str): - URL of the peer side external VPN gateway to - which this VPN tunnel is connected. Provided by - the client when the VPN tunnel is created. This - field is exclusive with the field - peerGcpGateway. - peer_external_gateway_interface (int): - The interface ID of the external VPN gateway - to which this VPN tunnel is connected. Provided - by the client when the VPN tunnel is created. - peer_gcp_gateway (str): - URL of the peer side HA GCP VPN gateway to - which this VPN tunnel is connected. Provided by - the client when the VPN tunnel is created. This - field can be used when creating highly available - VPN from VPC network to VPC network, the field - is exclusive with the field peerExternalGateway. - If provided, the VPN tunnel will automatically - use the same vpnGatewayInterface ID in the peer - GCP VPN gateway. - peer_ip (str): - IP address of the peer VPN gateway. Only IPv4 - is supported. - region (str): - [Output Only] URL of the region where the VPN tunnel - resides. You must specify this field as part of the HTTP - request URL. It is not settable as a field in the request - body. - remote_traffic_selector (Sequence[str]): - Remote traffic selectors to use when - establishing the VPN tunnel with the peer VPN - gateway. The value should be a CIDR formatted - string, for example: 192.168.0.0/16. The ranges - should be disjoint. Only IPv4 is supported. - router (str): - URL of the router resource to be used for - dynamic routing. - self_link (str): - [Output Only] Server-defined URL for the resource. - shared_secret (str): - Shared secret used to set the secure session - between the Cloud VPN gateway and the peer VPN - gateway. - shared_secret_hash (str): - Hash of the shared secret. - status (google.cloud.compute_v1.types.VpnTunnel.Status): - [Output Only] The status of the VPN tunnel, which can be one - of the following: - - - PROVISIONING: Resource is being allocated for the VPN - tunnel. - - WAITING_FOR_FULL_CONFIG: Waiting to receive all - VPN-related configs from the user. Network, - TargetVpnGateway, VpnTunnel, ForwardingRule, and Route - resources are needed to setup the VPN tunnel. - - FIRST_HANDSHAKE: Successful first handshake with the peer - VPN. - - ESTABLISHED: Secure session is successfully established - with the peer VPN. - - NETWORK_ERROR: Deprecated, replaced by - NO_INCOMING_PACKETS - - AUTHORIZATION_ERROR: Auth error (for example, bad shared - secret). - - NEGOTIATION_FAILURE: Handshake failed. - - DEPROVISIONING: Resources are being deallocated for the - VPN tunnel. - - FAILED: Tunnel creation has failed and the tunnel is not - ready to be used. - - NO_INCOMING_PACKETS: No incoming packets from peer. - - REJECTED: Tunnel configuration was rejected, can be - result of being denied access. - - ALLOCATING_RESOURCES: Cloud VPN is in the process of - allocating all required resources. - - STOPPED: Tunnel is stopped due to its Forwarding Rules - being deleted for Classic VPN tunnels or the project is - in frozen state. - - PEER_IDENTITY_MISMATCH: Peer identity does not match peer - IP, probably behind NAT. - - TS_NARROWING_NOT_ALLOWED: Traffic selector narrowing not - allowed for an HA-VPN tunnel. - target_vpn_gateway (str): - URL of the Target VPN gateway with which this - VPN tunnel is associated. Provided by the client - when the VPN tunnel is created. - vpn_gateway (str): - URL of the VPN gateway with which this VPN tunnel is - associated. Provided by the client when the VPN tunnel is - created. This must be used (instead of target_vpn_gateway) - if a High Availability VPN gateway resource is created. - vpn_gateway_interface (int): - The interface ID of the VPN gateway with - which this VPN tunnel is associated. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - class Status(proto.Enum): - r"""[Output Only] The status of the VPN tunnel, which can be one of the - following: - - - PROVISIONING: Resource is being allocated for the VPN tunnel. - - WAITING_FOR_FULL_CONFIG: Waiting to receive all VPN-related - configs from the user. Network, TargetVpnGateway, VpnTunnel, - ForwardingRule, and Route resources are needed to setup the VPN - tunnel. - - FIRST_HANDSHAKE: Successful first handshake with the peer VPN. - - ESTABLISHED: Secure session is successfully established with the - peer VPN. - - NETWORK_ERROR: Deprecated, replaced by NO_INCOMING_PACKETS - - AUTHORIZATION_ERROR: Auth error (for example, bad shared secret). - - NEGOTIATION_FAILURE: Handshake failed. - - DEPROVISIONING: Resources are being deallocated for the VPN - tunnel. - - FAILED: Tunnel creation has failed and the tunnel is not ready to - be used. - - NO_INCOMING_PACKETS: No incoming packets from peer. - - REJECTED: Tunnel configuration was rejected, can be result of - being denied access. - - ALLOCATING_RESOURCES: Cloud VPN is in the process of allocating - all required resources. - - STOPPED: Tunnel is stopped due to its Forwarding Rules being - deleted for Classic VPN tunnels or the project is in frozen - state. - - PEER_IDENTITY_MISMATCH: Peer identity does not match peer IP, - probably behind NAT. - - TS_NARROWING_NOT_ALLOWED: Traffic selector narrowing not allowed - for an HA-VPN tunnel. - """ - UNDEFINED_STATUS = 0 - ALLOCATING_RESOURCES = 320922816 - AUTHORIZATION_ERROR = 23580290 - DEPROVISIONING = 428935662 - ESTABLISHED = 88852344 - FAILED = 455706685 - FIRST_HANDSHAKE = 191393000 - NEGOTIATION_FAILURE = 360325868 - NETWORK_ERROR = 193912951 - NO_INCOMING_PACKETS = 119983216 - PROVISIONING = 290896621 - REJECTED = 174130302 - STOPPED = 444276141 - WAITING_FOR_FULL_CONFIG = 41640522 + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - detailed_status = proto.Field(proto.STRING, number=333501025, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - ike_version = proto.Field(proto.INT32, number=218376220, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - local_traffic_selector = proto.RepeatedField(proto.STRING, number=317314613,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - peer_external_gateway = proto.Field(proto.STRING, number=384956173, optional=True,) - peer_external_gateway_interface = proto.Field( - proto.INT32, number=452768391, optional=True, - ) - peer_gcp_gateway = proto.Field(proto.STRING, number=281867452, optional=True,) - peer_ip = proto.Field(proto.STRING, number=383249700, optional=True,) - region = proto.Field(proto.STRING, number=138946292, optional=True,) - remote_traffic_selector = proto.RepeatedField(proto.STRING, number=358887098,) - router = proto.Field(proto.STRING, number=148608841, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - shared_secret = proto.Field(proto.STRING, number=381932490, optional=True,) - shared_secret_hash = proto.Field(proto.STRING, number=398881891, optional=True,) - status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) - target_vpn_gateway = proto.Field(proto.STRING, number=532512843, optional=True,) - vpn_gateway = proto.Field(proto.STRING, number=406684153, optional=True,) - vpn_gateway_interface = proto.Field(proto.INT32, number=95979123, optional=True,) +class ListImagesRequest(proto.Message): + r"""A request message for Images.List. See the method description + for details. -class VpnTunnelsScopedList(proto.Message): - r""" Attributes: - vpn_tunnels (Sequence[google.cloud.compute_v1.types.VpnTunnel]): - A list of VPN tunnels contained in this - scope. - warning (google.cloud.compute_v1.types.Warning): - Informational warning which replaces the list - of addresses when the list is empty. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - vpn_tunnels = proto.RepeatedField( - proto.MESSAGE, number=163494080, message="VpnTunnel", - ) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class VpnTunnelAggregatedList(proto.Message): - r""" +class ListInstanceGroupManagersRequest(proto.Message): + r"""A request message for InstanceGroupManagers.List. See the + method description for details. + Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.VpnTunnelAggregatedList.ItemsEntry]): - A list of VpnTunnelsScopedList resources. - kind (str): - [Output Only] Type of resource. Always compute#vpnTunnel for - VPN tunnels. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - unreachables (Sequence[str]): - [Output Only] Unreachable resources. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. + zone (str): + The name of the zone where the managed + instance group is located. """ - @property - def raw_page(self): - return self + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.MapField( - proto.STRING, proto.MESSAGE, number=100526016, message="VpnTunnelsScopedList", - ) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - unreachables = proto.RepeatedField(proto.STRING, number=243372063,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) +class ListInstanceGroupsRequest(proto.Message): + r"""A request message for InstanceGroups.List. See the method + description for details. -class VpnTunnelList(proto.Message): - r"""Contains a list of VpnTunnel resources. Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.VpnTunnel]): - A list of VpnTunnel resources. - kind (str): - [Output Only] Type of resource. Always compute#vpnTunnel for - VPN tunnels. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. + zone (str): + The name of the zone where the instance group + is located. """ - @property - def raw_page(self): - return self + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="VpnTunnel",) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) +class ListInstanceTemplatesRequest(proto.Message): + r"""A request message for InstanceTemplates.List. See the method + description for details. -class WafExpressionSetExpression(proto.Message): - r""" Attributes: - id (str): - Expression ID should uniquely identify the - origin of the expression. E.g. owasp- - crs-v020901-id973337 identifies Owasp core rule - set version 2.9.1 rule id 973337. The ID could - be used to determine the individual attack - definition that has been detected. It could also - be used to exclude it from the policy in case of - false positive. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - id = proto.Field(proto.STRING, number=3355, optional=True,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + +class ListInstancesInstanceGroupsRequest(proto.Message): + r"""A request message for InstanceGroups.ListInstances. See the + method description for details. -class XpnHostList(proto.Message): - r""" Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.Project]): - [Output Only] A list of shared VPC host project URLs. - kind (str): - [Output Only] Type of resource. Always compute#xpnHostList - for lists of shared VPC hosts. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + instance_group (str): + The name of the instance group from which you + want to generate a list of included instances. + instance_groups_list_instances_request_resource (google.cloud.compute_v1.types.InstanceGroupsListInstancesRequest): + The body resource for this request + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. + zone (str): + The name of the zone where the instance group + is located. """ - @property - def raw_page(self): - return self - - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Project",) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + instance_group = proto.Field(proto.STRING, number=81095253,) + instance_groups_list_instances_request_resource = proto.Field( + proto.MESSAGE, number=476255263, message="InstanceGroupsListInstancesRequest", ) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class Zone(proto.Message): - r"""Represents a Zone resource. - - A zone is a deployment area. These deployment areas are subsets of a - region. For example the zone us-east1-a is located in the us-east1 - region. For more information, read Regions and Zones. (== - resource_for {$api_version}.zones ==) +class ListInstancesRegionInstanceGroupsRequest(proto.Message): + r"""A request message for RegionInstanceGroups.ListInstances. See + the method description for details. Attributes: - available_cpu_platforms (Sequence[str]): - [Output Only] Available cpu/platform selections for the - zone. - creation_timestamp (str): - [Output Only] Creation timestamp in RFC3339 text format. - deprecated (google.cloud.compute_v1.types.DeprecationStatus): - [Output Only] The deprecation status associated with this - zone. - description (str): - [Output Only] Textual description of the resource. - id (int): - [Output Only] The unique identifier for the resource. This - identifier is defined by the server. - kind (str): - [Output Only] Type of the resource. Always compute#zone for - zones. - name (str): - [Output Only] Name of the resource. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + instance_group (str): + Name of the regional instance group for which + we want to list the instances. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. region (str): - [Output Only] Full URL reference to the region which hosts - the zone. - self_link (str): - [Output Only] Server-defined URL for the resource. - status (google.cloud.compute_v1.types.Zone.Status): - [Output Only] Status of the zone, either UP or DOWN. - supports_pzs (bool): - [Output Only] Reserved for future use. + Name of the region scoping this request. + region_instance_groups_list_instances_request_resource (google.cloud.compute_v1.types.RegionInstanceGroupsListInstancesRequest): + The body resource for this request + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - class Status(proto.Enum): - r"""[Output Only] Status of the zone, either UP or DOWN.""" - UNDEFINED_STATUS = 0 - DOWN = 2104482 - UP = 2715 - - available_cpu_platforms = proto.RepeatedField(proto.STRING, number=175536531,) - creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) - deprecated = proto.Field( - proto.MESSAGE, number=515138995, optional=True, message="DeprecationStatus", + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + instance_group = proto.Field(proto.STRING, number=81095253,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + region_instance_groups_list_instances_request_resource = proto.Field( + proto.MESSAGE, + number=48239828, + message="RegionInstanceGroupsListInstancesRequest", ) - description = proto.Field(proto.STRING, number=422937596, optional=True,) - id = proto.Field(proto.UINT64, number=3355, optional=True,) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - region = proto.Field(proto.STRING, number=138946292, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) - supports_pzs = proto.Field(proto.BOOL, number=83983214, optional=True,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class ZoneList(proto.Message): - r"""Contains a list of zone resources. +class ListInstancesRequest(proto.Message): + r"""A request message for Instances.List. See the method + description for details. + Attributes: - id (str): - [Output Only] Unique identifier for the resource; defined by - the server. - items (Sequence[google.cloud.compute_v1.types.Zone]): - A list of Zone resources. - kind (str): - Type of resource. - next_page_token (str): - [Output Only] This token allows you to get the next page of - results for list requests. If the number of results is - larger than maxResults, use the nextPageToken as a value for - the query parameter pageToken in the next list request. - Subsequent list requests will have their own nextPageToken - to continue paging through the results. - self_link (str): - [Output Only] Server-defined URL for this resource. - warning (google.cloud.compute_v1.types.Warning): - [Output Only] Informational warning message. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. + zone (str): + The name of the zone for this request. """ - @property - def raw_page(self): - return self + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) - id = proto.Field(proto.STRING, number=3355, optional=True,) - items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Zone",) - kind = proto.Field(proto.STRING, number=3292052, optional=True,) - next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) - self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - warning = proto.Field( - proto.MESSAGE, number=50704284, optional=True, message="Warning", - ) +class ListInterconnectAttachmentsRequest(proto.Message): + r"""A request message for InterconnectAttachments.List. See the + method description for details. -class ZoneSetLabelsRequest(proto.Message): - r""" Attributes: - label_fingerprint (str): - The fingerprint of the previous set of labels - for this resource, used to detect conflicts. The - fingerprint is initially generated by Compute - Engine and changes after every request to modify - or update labels. You must always provide an up- - to-date fingerprint hash in order to update or - change labels. Make a get() request to the - resource to get the latest fingerprint. - labels (Sequence[google.cloud.compute_v1.types.ZoneSetLabelsRequest.LabelsEntry]): - The labels to set for this resource. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + region (str): + Name of the region for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - label_fingerprint = proto.Field(proto.STRING, number=178124825, optional=True,) - labels = proto.MapField(proto.STRING, proto.STRING, number=500195327,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class ZoneSetPolicyRequest(proto.Message): - r""" +class ListInterconnectLocationsRequest(proto.Message): + r"""A request message for InterconnectLocations.List. See the + method description for details. + Attributes: - bindings (Sequence[google.cloud.compute_v1.types.Binding]): - Flatten Policy to create a backwacd - compatible wire-format. Deprecated. Use 'policy' - to specify bindings. - etag (str): - Flatten Policy to create a backward - compatible wire-format. Deprecated. Use 'policy' - to specify the etag. - policy (google.cloud.compute_v1.types.Policy): - REQUIRED: The complete policy to be applied - to the 'resource'. The size of the policy is - limited to a few 10s of KB. An empty policy is - in general a valid policy but certain services - (like Projects) might reject them. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - bindings = proto.RepeatedField(proto.MESSAGE, number=403251854, message="Binding",) - etag = proto.Field(proto.STRING, number=3123477, optional=True,) - policy = proto.Field( - proto.MESSAGE, number=91071794, optional=True, message="Policy", - ) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class AggregatedListAcceleratorTypesRequest(proto.Message): - r"""A request message for AcceleratorTypes.AggregatedList. See - the method description for details. +class ListInterconnectsRequest(proto.Message): + r"""A request message for Interconnects.List. See the method + description for details. Attributes: filter (str): @@ -25521,36 +25860,85 @@ class AggregatedListAcceleratorTypesRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. + """ + + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. +class ListLicensesRequest(proto.Message): + r"""A request message for Licenses.List. See the method + description for details. - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + Attributes: + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions explicitly. For example: ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. max_results (int): The maximum number of results per page that should be returned. If the number of available results is larger than @@ -25561,17 +25949,13 @@ class AggregatedListAcceleratorTypesRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -25586,7 +25970,6 @@ class AggregatedListAcceleratorTypesRequest(proto.Message): """ filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) order_by = proto.Field(proto.STRING, number=160562920, optional=True,) page_token = proto.Field(proto.STRING, number=19994697, optional=True,) @@ -25594,26 +25977,76 @@ class AggregatedListAcceleratorTypesRequest(proto.Message): return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class GetAcceleratorTypeRequest(proto.Message): - r"""A request message for AcceleratorTypes.Get. See the method +class ListMachineTypesRequest(proto.Message): + r"""A request message for MachineTypes.List. See the method description for details. Attributes: - accelerator_type (str): - Name of the accelerator type to return. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. project (str): Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. zone (str): The name of the zone for this request. """ - accelerator_type = proto.Field(proto.STRING, number=138031246,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) zone = proto.Field(proto.STRING, number=3744684,) -class ListAcceleratorTypesRequest(proto.Message): - r"""A request message for AcceleratorTypes.List. See the method +class ListManagedInstancesInstanceGroupManagersRequest(proto.Message): + r"""A request message for + InstanceGroupManagers.ListManagedInstances. See the method description for details. Attributes: @@ -25623,25 +26056,23 @@ class ListAcceleratorTypesRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions explicitly. For example: ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + instance_group_manager (str): + The name of the managed instance group. max_results (int): The maximum number of results per page that should be returned. If the number of available results is larger than @@ -25652,17 +26083,13 @@ class ListAcceleratorTypesRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -25675,10 +26102,12 @@ class ListAcceleratorTypesRequest(proto.Message): provides partial results in case of failure. The default value is false. zone (str): - The name of the zone for this request. + The name of the zone where the managed + instance group is located. """ filter = proto.Field(proto.STRING, number=336120696, optional=True,) + instance_group_manager = proto.Field(proto.STRING, number=249363395,) max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) order_by = proto.Field(proto.STRING, number=160562920, optional=True,) page_token = proto.Field(proto.STRING, number=19994697, optional=True,) @@ -25687,9 +26116,10 @@ class ListAcceleratorTypesRequest(proto.Message): zone = proto.Field(proto.STRING, number=3744684,) -class AggregatedListAddressesRequest(proto.Message): - r"""A request message for Addresses.AggregatedList. See the - method description for details. +class ListManagedInstancesRegionInstanceGroupManagersRequest(proto.Message): + r"""A request message for + RegionInstanceGroupManagers.ListManagedInstances. See the method + description for details. Attributes: filter (str): @@ -25698,36 +26128,23 @@ class AggregatedListAddressesRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions explicitly. For example: ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. + instance_group_manager (str): + The name of the managed instance group. max_results (int): The maximum number of results per page that should be returned. If the number of available results is larger than @@ -25738,17 +26155,13 @@ class AggregatedListAddressesRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -25756,6 +26169,8 @@ class AggregatedListAddressesRequest(proto.Message): the next page of results. project (str): Project ID for this request. + region (str): + Name of the region scoping this request. return_partial_success (bool): Opt-in for partial success behavior which provides partial results in case of failure. The @@ -25763,105 +26178,18 @@ class AggregatedListAddressesRequest(proto.Message): """ filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) + instance_group_manager = proto.Field(proto.STRING, number=249363395,) max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) order_by = proto.Field(proto.STRING, number=160562920, optional=True,) page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - - -class DeleteAddressRequest(proto.Message): - r"""A request message for Addresses.Delete. See the method - description for details. - - Attributes: - address (str): - Name of the address resource to delete. - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - address = proto.Field(proto.STRING, number=462920692,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class GetAddressRequest(proto.Message): - r"""A request message for Addresses.Get. See the method - description for details. - - Attributes: - address (str): - Name of the address resource to return. - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - """ - - address = proto.Field(proto.STRING, number=462920692,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - - -class InsertAddressRequest(proto.Message): - r"""A request message for Addresses.Insert. See the method - description for details. - - Attributes: - address_resource (google.cloud.compute_v1.types.Address): - The body resource for this request - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - address_resource = proto.Field(proto.MESSAGE, number=483888121, message="Address",) - project = proto.Field(proto.STRING, number=227560217,) region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class ListAddressesRequest(proto.Message): - r"""A request message for Addresses.List. See the method - description for details. +class ListNetworkEndpointGroupsRequest(proto.Message): + r"""A request message for NetworkEndpointGroups.List. See the + method description for details. Attributes: filter (str): @@ -25870,20 +26198,16 @@ class ListAddressesRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions @@ -25899,17 +26223,13 @@ class ListAddressesRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -25917,12 +26237,14 @@ class ListAddressesRequest(proto.Message): the next page of results. project (str): Project ID for this request. - region (str): - Name of the region for this request. return_partial_success (bool): Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. + zone (str): + The name of the zone where the network + endpoint group is located. It should comply with + RFC1035. """ filter = proto.Field(proto.STRING, number=336120696, optional=True,) @@ -25930,13 +26252,14 @@ class ListAddressesRequest(proto.Message): order_by = proto.Field(proto.STRING, number=160562920, optional=True,) page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class AggregatedListAutoscalersRequest(proto.Message): - r"""A request message for Autoscalers.AggregatedList. See the - method description for details. +class ListNetworkEndpointsGlobalNetworkEndpointGroupsRequest(proto.Message): + r"""A request message for + GlobalNetworkEndpointGroups.ListNetworkEndpoints. See the method + description for details. Attributes: filter (str): @@ -25945,36 +26268,21 @@ class AggregatedListAutoscalersRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions explicitly. For example: ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. max_results (int): The maximum number of results per page that should be returned. If the number of available results is larger than @@ -25982,20 +26290,21 @@ class AggregatedListAutoscalersRequest(proto.Message): that can be used to get the next page of results in subsequent list requests. Acceptable values are ``0`` to ``500``, inclusive. (Default: ``500``) + network_endpoint_group (str): + The name of the network endpoint group from + which you want to generate a list of included + network endpoints. It should comply with + RFC1035. order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -26010,106 +26319,17 @@ class AggregatedListAutoscalersRequest(proto.Message): """ filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + network_endpoint_group = proto.Field(proto.STRING, number=433907078,) order_by = proto.Field(proto.STRING, number=160562920, optional=True,) page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class DeleteAutoscalerRequest(proto.Message): - r"""A request message for Autoscalers.Delete. See the method - description for details. - - Attributes: - autoscaler (str): - Name of the autoscaler to delete. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - Name of the zone for this request. - """ - - autoscaler = proto.Field(proto.STRING, number=517258967,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - - -class GetAutoscalerRequest(proto.Message): - r"""A request message for Autoscalers.Get. See the method - description for details. - - Attributes: - autoscaler (str): - Name of the autoscaler to return. - project (str): - Project ID for this request. - zone (str): - Name of the zone for this request. - """ - - autoscaler = proto.Field(proto.STRING, number=517258967,) - project = proto.Field(proto.STRING, number=227560217,) - zone = proto.Field(proto.STRING, number=3744684,) - - -class InsertAutoscalerRequest(proto.Message): - r"""A request message for Autoscalers.Insert. See the method - description for details. - - Attributes: - autoscaler_resource (google.cloud.compute_v1.types.Autoscaler): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - Name of the zone for this request. - """ - - autoscaler_resource = proto.Field( - proto.MESSAGE, number=207616118, message="Autoscaler", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - - -class ListAutoscalersRequest(proto.Message): - r"""A request message for Autoscalers.List. See the method +class ListNetworkEndpointsNetworkEndpointGroupsRequest(proto.Message): + r"""A request message for + NetworkEndpointGroups.ListNetworkEndpoints. See the method description for details. Attributes: @@ -26119,20 +26339,16 @@ class ListAutoscalersRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions @@ -26145,20 +26361,23 @@ class ListAutoscalersRequest(proto.Message): that can be used to get the next page of results in subsequent list requests. Acceptable values are ``0`` to ``500``, inclusive. (Default: ``500``) + network_endpoint_group (str): + The name of the network endpoint group from + which you want to generate a list of included + network endpoints. It should comply with + RFC1035. + network_endpoint_groups_list_endpoints_request_resource (google.cloud.compute_v1.types.NetworkEndpointGroupsListEndpointsRequest): + The body resource for this request order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -26171,11 +26390,19 @@ class ListAutoscalersRequest(proto.Message): provides partial results in case of failure. The default value is false. zone (str): - Name of the zone for this request. + The name of the zone where the network + endpoint group is located. It should comply with + RFC1035. """ filter = proto.Field(proto.STRING, number=336120696, optional=True,) max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + network_endpoint_group = proto.Field(proto.STRING, number=433907078,) + network_endpoint_groups_list_endpoints_request_resource = proto.Field( + proto.MESSAGE, + number=59493390, + message="NetworkEndpointGroupsListEndpointsRequest", + ) order_by = proto.Field(proto.STRING, number=160562920, optional=True,) page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) @@ -26183,245 +26410,72 @@ class ListAutoscalersRequest(proto.Message): zone = proto.Field(proto.STRING, number=3744684,) -class PatchAutoscalerRequest(proto.Message): - r"""A request message for Autoscalers.Patch. See the method - description for details. - - Attributes: - autoscaler (str): - Name of the autoscaler to patch. - autoscaler_resource (google.cloud.compute_v1.types.Autoscaler): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - Name of the zone for this request. - """ - - autoscaler = proto.Field(proto.STRING, number=517258967, optional=True,) - autoscaler_resource = proto.Field( - proto.MESSAGE, number=207616118, message="Autoscaler", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - - -class UpdateAutoscalerRequest(proto.Message): - r"""A request message for Autoscalers.Update. See the method - description for details. - - Attributes: - autoscaler (str): - Name of the autoscaler to update. - autoscaler_resource (google.cloud.compute_v1.types.Autoscaler): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - Name of the zone for this request. - """ - - autoscaler = proto.Field(proto.STRING, number=517258967, optional=True,) - autoscaler_resource = proto.Field( - proto.MESSAGE, number=207616118, message="Autoscaler", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - - -class AddSignedUrlKeyBackendBucketRequest(proto.Message): - r"""A request message for BackendBuckets.AddSignedUrlKey. See the - method description for details. - - Attributes: - backend_bucket (str): - Name of the BackendBucket resource to which - the Signed URL Key should be added. The name - should conform to RFC1035. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - signed_url_key_resource (google.cloud.compute_v1.types.SignedUrlKey): - The body resource for this request - """ - - backend_bucket = proto.Field(proto.STRING, number=91714037,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - signed_url_key_resource = proto.Field( - proto.MESSAGE, number=457625985, message="SignedUrlKey", - ) - - -class DeleteBackendBucketRequest(proto.Message): - r"""A request message for BackendBuckets.Delete. See the method - description for details. - - Attributes: - backend_bucket (str): - Name of the BackendBucket resource to delete. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - backend_bucket = proto.Field(proto.STRING, number=91714037,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class DeleteSignedUrlKeyBackendBucketRequest(proto.Message): - r"""A request message for BackendBuckets.DeleteSignedUrlKey. See - the method description for details. - - Attributes: - backend_bucket (str): - Name of the BackendBucket resource to which - the Signed URL Key should be added. The name - should conform to RFC1035. - key_name (str): - The name of the Signed URL Key to delete. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - backend_bucket = proto.Field(proto.STRING, number=91714037,) - key_name = proto.Field(proto.STRING, number=500938859,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class GetBackendBucketRequest(proto.Message): - r"""A request message for BackendBuckets.Get. See the method - description for details. - - Attributes: - backend_bucket (str): - Name of the BackendBucket resource to return. - project (str): - Project ID for this request. - """ - - backend_bucket = proto.Field(proto.STRING, number=91714037,) - project = proto.Field(proto.STRING, number=227560217,) - - -class InsertBackendBucketRequest(proto.Message): - r"""A request message for BackendBuckets.Insert. See the method +class ListNetworksRequest(proto.Message): + r"""A request message for Networks.List. See the method description for details. Attributes: - backend_bucket_resource (google.cloud.compute_v1.types.BackendBucket): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - backend_bucket_resource = proto.Field( - proto.MESSAGE, number=380757784, message="BackendBucket", - ) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class ListBackendBucketsRequest(proto.Message): - r"""A request message for BackendBuckets.List. See the method +class ListNodeGroupsRequest(proto.Message): + r"""A request message for NodeGroups.List. See the method description for details. Attributes: @@ -26431,20 +26485,16 @@ class ListBackendBucketsRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions @@ -26460,17 +26510,13 @@ class ListBackendBucketsRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -26482,6 +26528,8 @@ class ListBackendBucketsRequest(proto.Message): Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. + zone (str): + The name of the zone for this request. """ filter = proto.Field(proto.STRING, number=336120696, optional=True,) @@ -26490,124 +26538,146 @@ class ListBackendBucketsRequest(proto.Message): page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class PatchBackendBucketRequest(proto.Message): - r"""A request message for BackendBuckets.Patch. See the method +class ListNodeTemplatesRequest(proto.Message): + r"""A request message for NodeTemplates.List. See the method description for details. Attributes: - backend_bucket (str): - Name of the BackendBucket resource to patch. - backend_bucket_resource (google.cloud.compute_v1.types.BackendBucket): - The body resource for this request + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. project (str): Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + region (str): + The name of the region for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - backend_bucket = proto.Field(proto.STRING, number=91714037,) - backend_bucket_resource = proto.Field( - proto.MESSAGE, number=380757784, message="BackendBucket", - ) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + region = proto.Field(proto.STRING, number=138946292,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class UpdateBackendBucketRequest(proto.Message): - r"""A request message for BackendBuckets.Update. See the method +class ListNodeTypesRequest(proto.Message): + r"""A request message for NodeTypes.List. See the method description for details. Attributes: - backend_bucket (str): - Name of the BackendBucket resource to update. - backend_bucket_resource (google.cloud.compute_v1.types.BackendBucket): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - backend_bucket = proto.Field(proto.STRING, number=91714037,) - backend_bucket_resource = proto.Field( - proto.MESSAGE, number=380757784, message="BackendBucket", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class AddSignedUrlKeyBackendServiceRequest(proto.Message): - r"""A request message for BackendServices.AddSignedUrlKey. See - the method description for details. - - Attributes: - backend_service (str): - Name of the BackendService resource to which - the Signed URL Key should be added. The name - should conform to RFC1035. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. project (str): Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - signed_url_key_resource (google.cloud.compute_v1.types.SignedUrlKey): - The body resource for this request + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. + zone (str): + The name of the zone for this request. """ - backend_service = proto.Field(proto.STRING, number=306946058,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - signed_url_key_resource = proto.Field( - proto.MESSAGE, number=457625985, message="SignedUrlKey", - ) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class AggregatedListBackendServicesRequest(proto.Message): - r"""A request message for BackendServices.AggregatedList. See the - method description for details. +class ListNodesNodeGroupsRequest(proto.Message): + r"""A request message for NodeGroups.ListNodes. See the method + description for details. Attributes: filter (str): @@ -26616,36 +26686,21 @@ class AggregatedListBackendServicesRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions explicitly. For example: ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. max_results (int): The maximum number of results per page that should be returned. If the number of available results is larger than @@ -26653,185 +26708,348 @@ class AggregatedListBackendServicesRequest(proto.Message): that can be used to get the next page of results in subsequent list requests. Acceptable values are ``0`` to ``500``, inclusive. (Default: ``500``) + node_group (str): + Name of the NodeGroup resource whose nodes + you want to list. order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the ``nextPageToken`` returned by a previous list request to get the next page of results. project (str): - Name of the project scoping this request. + Project ID for this request. return_partial_success (bool): Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. + zone (str): + The name of the zone for this request. """ filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + node_group = proto.Field(proto.STRING, number=469958146,) order_by = proto.Field(proto.STRING, number=160562920, optional=True,) page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class DeleteBackendServiceRequest(proto.Message): - r"""A request message for BackendServices.Delete. See the method +class ListPacketMirroringsRequest(proto.Message): + r"""A request message for PacketMirrorings.List. See the method description for details. Attributes: - backend_service (str): - Name of the BackendService resource to - delete. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. project (str): Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + region (str): + Name of the region for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - backend_service = proto.Field(proto.STRING, number=306946058,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + region = proto.Field(proto.STRING, number=138946292,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class DeleteSignedUrlKeyBackendServiceRequest(proto.Message): - r"""A request message for BackendServices.DeleteSignedUrlKey. See - the method description for details. +class ListPeeringRoutesNetworksRequest(proto.Message): + r"""A request message for Networks.ListPeeringRoutes. See the + method description for details. Attributes: - backend_service (str): - Name of the BackendService resource to which - the Signed URL Key should be added. The name - should conform to RFC1035. - key_name (str): - The name of the Signed URL Key to delete. + direction (google.cloud.compute_v1.types.ListPeeringRoutesNetworksRequest.Direction): + The direction of the exchanged routes. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + network (str): + Name of the network for this request. + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + peering_name (str): + The response will show routes exchanged over + the given peering connection. project (str): Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + region (str): + The region of the request. The response will + include all subnet routes, static routes and + dynamic routes in the region. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - backend_service = proto.Field(proto.STRING, number=306946058,) - key_name = proto.Field(proto.STRING, number=500938859,) + class Direction(proto.Enum): + r"""The direction of the exchanged routes.""" + UNDEFINED_DIRECTION = 0 + INCOMING = 338552870 + OUTGOING = 307438444 + + direction = proto.Field( + proto.ENUM, number=111150975, optional=True, enum=Direction, + ) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + network = proto.Field(proto.STRING, number=232872494,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + peering_name = proto.Field(proto.STRING, number=249571370, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + region = proto.Field(proto.STRING, number=138946292, optional=True,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class GetBackendServiceRequest(proto.Message): - r"""A request message for BackendServices.Get. See the method +class ListPerInstanceConfigsInstanceGroupManagersRequest(proto.Message): + r"""A request message for + InstanceGroupManagers.ListPerInstanceConfigs. See the method description for details. Attributes: - backend_service (str): - Name of the BackendService resource to - return. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + instance_group_manager (str): + The name of the managed instance group. It + should conform to RFC1035. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. project (str): Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. + zone (str): + The name of the zone where the managed + instance group is located. It should conform to + RFC1035. """ - backend_service = proto.Field(proto.STRING, number=306946058,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + instance_group_manager = proto.Field(proto.STRING, number=249363395,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class GetHealthBackendServiceRequest(proto.Message): - r"""A request message for BackendServices.GetHealth. See the +class ListPerInstanceConfigsRegionInstanceGroupManagersRequest(proto.Message): + r"""A request message for + RegionInstanceGroupManagers.ListPerInstanceConfigs. See the method description for details. Attributes: - backend_service (str): - Name of the BackendService resource to which - the queried instance belongs. - project (str): - - resource_group_reference_resource (google.cloud.compute_v1.types.ResourceGroupReference): - The body resource for this request - """ - - backend_service = proto.Field(proto.STRING, number=306946058,) - project = proto.Field(proto.STRING, number=227560217,) - resource_group_reference_resource = proto.Field( - proto.MESSAGE, number=112951123, message="ResourceGroupReference", - ) - - -class InsertBackendServiceRequest(proto.Message): - r"""A request message for BackendServices.Insert. See the method - description for details. - - Attributes: - backend_service_resource (google.cloud.compute_v1.types.BackendService): - The body resource for this request + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + instance_group_manager (str): + The name of the managed instance group. It + should conform to RFC1035. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. project (str): Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + region (str): + Name of the region scoping this request, + should conform to RFC1035. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - backend_service_resource = proto.Field( - proto.MESSAGE, number=347586723, message="BackendService", - ) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + instance_group_manager = proto.Field(proto.STRING, number=249363395,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + region = proto.Field(proto.STRING, number=138946292,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class ListBackendServicesRequest(proto.Message): - r"""A request message for BackendServices.List. See the method +class ListPreconfiguredExpressionSetsSecurityPoliciesRequest(proto.Message): + r"""A request message for + SecurityPolicies.ListPreconfiguredExpressionSets. See the method description for details. Attributes: @@ -26841,20 +27059,16 @@ class ListBackendServicesRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions @@ -26870,17 +27084,13 @@ class ListBackendServicesRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -26902,122 +27112,72 @@ class ListBackendServicesRequest(proto.Message): return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class PatchBackendServiceRequest(proto.Message): - r"""A request message for BackendServices.Patch. See the method - description for details. - - Attributes: - backend_service (str): - Name of the BackendService resource to patch. - backend_service_resource (google.cloud.compute_v1.types.BackendService): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - backend_service = proto.Field(proto.STRING, number=306946058,) - backend_service_resource = proto.Field( - proto.MESSAGE, number=347586723, message="BackendService", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class SetSecurityPolicyBackendServiceRequest(proto.Message): - r"""A request message for BackendServices.SetSecurityPolicy. See - the method description for details. - - Attributes: - backend_service (str): - Name of the BackendService resource to which - the security policy should be set. The name - should conform to RFC1035. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - security_policy_reference_resource (google.cloud.compute_v1.types.SecurityPolicyReference): - The body resource for this request - """ - - backend_service = proto.Field(proto.STRING, number=306946058,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - security_policy_reference_resource = proto.Field( - proto.MESSAGE, number=204135024, message="SecurityPolicyReference", - ) - - -class UpdateBackendServiceRequest(proto.Message): - r"""A request message for BackendServices.Update. See the method - description for details. +class ListPublicAdvertisedPrefixesRequest(proto.Message): + r"""A request message for PublicAdvertisedPrefixes.List. See the + method description for details. Attributes: - backend_service (str): - Name of the BackendService resource to - update. - backend_service_resource (google.cloud.compute_v1.types.BackendService): - The body resource for this request + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. project (str): Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - backend_service = proto.Field(proto.STRING, number=306946058,) - backend_service_resource = proto.Field( - proto.MESSAGE, number=347586723, message="BackendService", - ) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class AggregatedListDiskTypesRequest(proto.Message): - r"""A request message for DiskTypes.AggregatedList. See the +class ListPublicDelegatedPrefixesRequest(proto.Message): + r"""A request message for PublicDelegatedPrefixes.List. See the method description for details. Attributes: @@ -27027,36 +27187,21 @@ class AggregatedListDiskTypesRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions explicitly. For example: ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. max_results (int): The maximum number of results per page that should be returned. If the number of available results is larger than @@ -27067,17 +27212,13 @@ class AggregatedListDiskTypesRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -27085,6 +27226,8 @@ class AggregatedListDiskTypesRequest(proto.Message): the next page of results. project (str): Project ID for this request. + region (str): + Name of the region of this request. return_partial_success (bool): Opt-in for partial success behavior which provides partial results in case of failure. The @@ -27092,34 +27235,88 @@ class AggregatedListDiskTypesRequest(proto.Message): """ filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) order_by = proto.Field(proto.STRING, number=160562920, optional=True,) page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class GetDiskTypeRequest(proto.Message): - r"""A request message for DiskTypes.Get. See the method +class ListReferrersInstancesRequest(proto.Message): + r"""A request message for Instances.ListReferrers. See the method description for details. Attributes: - disk_type (str): - Name of the disk type to return. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + instance (str): + Name of the target instance scoping this + request, or '-' if the request should span over + all instances in the container. + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. project (str): Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. zone (str): The name of the zone for this request. """ - disk_type = proto.Field(proto.STRING, number=93009052,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + instance = proto.Field(proto.STRING, number=18257045,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) zone = proto.Field(proto.STRING, number=3744684,) -class ListDiskTypesRequest(proto.Message): - r"""A request message for DiskTypes.List. See the method +class ListRegionAutoscalersRequest(proto.Message): + r"""A request message for RegionAutoscalers.List. See the method description for details. Attributes: @@ -27129,20 +27326,16 @@ class ListDiskTypesRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions @@ -27158,17 +27351,13 @@ class ListDiskTypesRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -27176,12 +27365,12 @@ class ListDiskTypesRequest(proto.Message): the next page of results. project (str): Project ID for this request. + region (str): + Name of the region scoping this request. return_partial_success (bool): Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. - zone (str): - The name of the zone for this request. """ filter = proto.Field(proto.STRING, number=336120696, optional=True,) @@ -27189,54 +27378,14 @@ class ListDiskTypesRequest(proto.Message): order_by = proto.Field(proto.STRING, number=160562920, optional=True,) page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) -class AddResourcePoliciesDiskRequest(proto.Message): - r"""A request message for Disks.AddResourcePolicies. See the +class ListRegionBackendServicesRequest(proto.Message): + r"""A request message for RegionBackendServices.List. See the method description for details. - Attributes: - disk (str): - The disk name for this request. - disks_add_resource_policies_request_resource (google.cloud.compute_v1.types.DisksAddResourcePoliciesRequest): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. - """ - - disk = proto.Field(proto.STRING, number=3083677,) - disks_add_resource_policies_request_resource = proto.Field( - proto.MESSAGE, number=496483363, message="DisksAddResourcePoliciesRequest", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - - -class AggregatedListDisksRequest(proto.Message): - r"""A request message for Disks.AggregatedList. See the method - description for details. - Attributes: filter (str): A filter expression that filters resources listed in the @@ -27244,36 +27393,21 @@ class AggregatedListDisksRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions explicitly. For example: ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. max_results (int): The maximum number of results per page that should be returned. If the number of available results is larger than @@ -27284,17 +27418,13 @@ class AggregatedListDisksRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -27302,6 +27432,8 @@ class AggregatedListDisksRequest(proto.Message): the next page of results. project (str): Project ID for this request. + region (str): + Name of the region scoping this request. return_partial_success (bool): Opt-in for partial success behavior which provides partial results in case of failure. The @@ -27309,178 +27441,151 @@ class AggregatedListDisksRequest(proto.Message): """ filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) order_by = proto.Field(proto.STRING, number=160562920, optional=True,) page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class CreateSnapshotDiskRequest(proto.Message): - r"""A request message for Disks.CreateSnapshot. See the method - description for details. - - Attributes: - disk (str): - Name of the persistent disk to snapshot. - guest_flush (bool): - [Input Only] Whether to attempt an application consistent - snapshot by informing the OS to prepare for the snapshot - process. Currently only supported on Windows instances using - the Volume Shadow Copy Service (VSS). - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - snapshot_resource (google.cloud.compute_v1.types.Snapshot): - The body resource for this request - zone (str): - The name of the zone for this request. - """ - - disk = proto.Field(proto.STRING, number=3083677,) - guest_flush = proto.Field(proto.BOOL, number=385550813, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - snapshot_resource = proto.Field( - proto.MESSAGE, number=481319977, message="Snapshot", - ) - zone = proto.Field(proto.STRING, number=3744684,) - - -class DeleteDiskRequest(proto.Message): - r"""A request message for Disks.Delete. See the method - description for details. - - Attributes: - disk (str): - Name of the persistent disk to delete. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. - """ - - disk = proto.Field(proto.STRING, number=3083677,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - - -class GetDiskRequest(proto.Message): - r"""A request message for Disks.Get. See the method description - for details. - - Attributes: - disk (str): - Name of the persistent disk to return. - project (str): - Project ID for this request. - zone (str): - The name of the zone for this request. - """ - - disk = proto.Field(proto.STRING, number=3083677,) - project = proto.Field(proto.STRING, number=227560217,) - zone = proto.Field(proto.STRING, number=3744684,) - - -class GetIamPolicyDiskRequest(proto.Message): - r"""A request message for Disks.GetIamPolicy. See the method +class ListRegionCommitmentsRequest(proto.Message): + r"""A request message for RegionCommitments.List. See the method description for details. Attributes: - options_requested_policy_version (int): - Requested IAM Policy version. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. project (str): Project ID for this request. - resource (str): - Name or id of the resource for this request. - zone (str): - The name of the zone for this request. + region (str): + Name of the region for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - options_requested_policy_version = proto.Field( - proto.INT32, number=499220029, optional=True, - ) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) - zone = proto.Field(proto.STRING, number=3744684,) + region = proto.Field(proto.STRING, number=138946292,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class InsertDiskRequest(proto.Message): - r"""A request message for Disks.Insert. See the method +class ListRegionDiskTypesRequest(proto.Message): + r"""A request message for RegionDiskTypes.List. See the method description for details. Attributes: - disk_resource (google.cloud.compute_v1.types.Disk): - The body resource for this request + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. project (str): Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - source_image (str): - Source image to restore onto a disk. This - field is optional. - zone (str): - The name of the zone for this request. + region (str): + The name of the region for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - disk_resource = proto.Field(proto.MESSAGE, number=25880688, message="Disk",) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - source_image = proto.Field(proto.STRING, number=50443319, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + region = proto.Field(proto.STRING, number=138946292,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class ListDisksRequest(proto.Message): - r"""A request message for Disks.List. See the method description - for details. +class ListRegionDisksRequest(proto.Message): + r"""A request message for RegionDisks.List. See the method + description for details. Attributes: filter (str): @@ -27489,20 +27594,16 @@ class ListDisksRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions @@ -27518,17 +27619,13 @@ class ListDisksRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -27536,12 +27633,12 @@ class ListDisksRequest(proto.Message): the next page of results. project (str): Project ID for this request. + region (str): + Name of the region for this request. return_partial_success (bool): Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. - zone (str): - The name of the zone for this request. """ filter = proto.Field(proto.STRING, number=336120696, optional=True,) @@ -27549,259 +27646,12 @@ class ListDisksRequest(proto.Message): order_by = proto.Field(proto.STRING, number=160562920, optional=True,) page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - - -class RemoveResourcePoliciesDiskRequest(proto.Message): - r"""A request message for Disks.RemoveResourcePolicies. See the - method description for details. - - Attributes: - disk (str): - The disk name for this request. - disks_remove_resource_policies_request_resource (google.cloud.compute_v1.types.DisksRemoveResourcePoliciesRequest): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. - """ - - disk = proto.Field(proto.STRING, number=3083677,) - disks_remove_resource_policies_request_resource = proto.Field( - proto.MESSAGE, number=436756718, message="DisksRemoveResourcePoliciesRequest", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - - -class ResizeDiskRequest(proto.Message): - r"""A request message for Disks.Resize. See the method - description for details. - - Attributes: - disk (str): - The name of the persistent disk. - disks_resize_request_resource (google.cloud.compute_v1.types.DisksResizeRequest): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. - """ - - disk = proto.Field(proto.STRING, number=3083677,) - disks_resize_request_resource = proto.Field( - proto.MESSAGE, number=78307616, message="DisksResizeRequest", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - - -class SetIamPolicyDiskRequest(proto.Message): - r"""A request message for Disks.SetIamPolicy. See the method - description for details. - - Attributes: - project (str): - Project ID for this request. - resource (str): - Name or id of the resource for this request. - zone (str): - The name of the zone for this request. - zone_set_policy_request_resource (google.cloud.compute_v1.types.ZoneSetPolicyRequest): - The body resource for this request - """ - - project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) - zone = proto.Field(proto.STRING, number=3744684,) - zone_set_policy_request_resource = proto.Field( - proto.MESSAGE, number=382082107, message="ZoneSetPolicyRequest", - ) - - -class SetLabelsDiskRequest(proto.Message): - r"""A request message for Disks.SetLabels. See the method - description for details. - - Attributes: - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - resource (str): - Name or id of the resource for this request. - zone (str): - The name of the zone for this request. - zone_set_labels_request_resource (google.cloud.compute_v1.types.ZoneSetLabelsRequest): - The body resource for this request - """ - - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - resource = proto.Field(proto.STRING, number=195806222,) - zone = proto.Field(proto.STRING, number=3744684,) - zone_set_labels_request_resource = proto.Field( - proto.MESSAGE, number=364950798, message="ZoneSetLabelsRequest", - ) - - -class TestIamPermissionsDiskRequest(proto.Message): - r"""A request message for Disks.TestIamPermissions. See the - method description for details. - - Attributes: - project (str): - Project ID for this request. - resource (str): - Name or id of the resource for this request. - test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): - The body resource for this request - zone (str): - The name of the zone for this request. - """ - - project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) - test_permissions_request_resource = proto.Field( - proto.MESSAGE, number=439214758, message="TestPermissionsRequest", - ) - zone = proto.Field(proto.STRING, number=3744684,) - - -class DeleteExternalVpnGatewayRequest(proto.Message): - r"""A request message for ExternalVpnGateways.Delete. See the - method description for details. - - Attributes: - external_vpn_gateway (str): - Name of the externalVpnGateways to delete. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - external_vpn_gateway = proto.Field(proto.STRING, number=109898629,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class GetExternalVpnGatewayRequest(proto.Message): - r"""A request message for ExternalVpnGateways.Get. See the method - description for details. - - Attributes: - external_vpn_gateway (str): - Name of the externalVpnGateway to return. - project (str): - Project ID for this request. - """ - - external_vpn_gateway = proto.Field(proto.STRING, number=109898629,) - project = proto.Field(proto.STRING, number=227560217,) - - -class InsertExternalVpnGatewayRequest(proto.Message): - r"""A request message for ExternalVpnGateways.Insert. See the - method description for details. - - Attributes: - external_vpn_gateway_resource (google.cloud.compute_v1.types.ExternalVpnGateway): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - external_vpn_gateway_resource = proto.Field( - proto.MESSAGE, number=486813576, message="ExternalVpnGateway", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class ListExternalVpnGatewaysRequest(proto.Message): - r"""A request message for ExternalVpnGateways.List. See the +class ListRegionHealthCheckServicesRequest(proto.Message): + r"""A request message for RegionHealthCheckServices.List. See the method description for details. Attributes: @@ -27811,20 +27661,16 @@ class ListExternalVpnGatewaysRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions @@ -27840,17 +27686,13 @@ class ListExternalVpnGatewaysRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -27858,6 +27700,8 @@ class ListExternalVpnGatewaysRequest(proto.Message): the next page of results. project (str): Project ID for this request. + region (str): + Name of the region scoping this request. return_partial_success (bool): Opt-in for partial success behavior which provides partial results in case of failure. The @@ -27869,289 +27713,12 @@ class ListExternalVpnGatewaysRequest(proto.Message): order_by = proto.Field(proto.STRING, number=160562920, optional=True,) page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - - -class SetLabelsExternalVpnGatewayRequest(proto.Message): - r"""A request message for ExternalVpnGateways.SetLabels. See the - method description for details. - - Attributes: - global_set_labels_request_resource (google.cloud.compute_v1.types.GlobalSetLabelsRequest): - The body resource for this request - project (str): - Project ID for this request. - resource (str): - Name or id of the resource for this request. - """ - - global_set_labels_request_resource = proto.Field( - proto.MESSAGE, number=319917189, message="GlobalSetLabelsRequest", - ) - project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) - - -class TestIamPermissionsExternalVpnGatewayRequest(proto.Message): - r"""A request message for ExternalVpnGateways.TestIamPermissions. - See the method description for details. - - Attributes: - project (str): - Project ID for this request. - resource (str): - Name or id of the resource for this request. - test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): - The body resource for this request - """ - - project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) - test_permissions_request_resource = proto.Field( - proto.MESSAGE, number=439214758, message="TestPermissionsRequest", - ) - - -class AddAssociationFirewallPolicyRequest(proto.Message): - r"""A request message for FirewallPolicies.AddAssociation. See - the method description for details. - - Attributes: - firewall_policy (str): - Name of the firewall policy to update. - firewall_policy_association_resource (google.cloud.compute_v1.types.FirewallPolicyAssociation): - The body resource for this request - replace_existing_association (bool): - Indicates whether or not to replace it if an - association of the attachment already exists. - This is false by default, in which case an error - will be returned if an association already - exists. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - firewall_policy = proto.Field(proto.STRING, number=498173265,) - firewall_policy_association_resource = proto.Field( - proto.MESSAGE, number=259546170, message="FirewallPolicyAssociation", - ) - replace_existing_association = proto.Field( - proto.BOOL, number=209541240, optional=True, - ) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class AddRuleFirewallPolicyRequest(proto.Message): - r"""A request message for FirewallPolicies.AddRule. See the - method description for details. - - Attributes: - firewall_policy (str): - Name of the firewall policy to update. - firewall_policy_rule_resource (google.cloud.compute_v1.types.FirewallPolicyRule): - The body resource for this request - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - firewall_policy = proto.Field(proto.STRING, number=498173265,) - firewall_policy_rule_resource = proto.Field( - proto.MESSAGE, number=250523523, message="FirewallPolicyRule", - ) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class CloneRulesFirewallPolicyRequest(proto.Message): - r"""A request message for FirewallPolicies.CloneRules. See the - method description for details. - - Attributes: - firewall_policy (str): - Name of the firewall policy to update. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - source_firewall_policy (str): - The firewall policy from which to copy rules. - """ - - firewall_policy = proto.Field(proto.STRING, number=498173265,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - source_firewall_policy = proto.Field(proto.STRING, number=25013549, optional=True,) - - -class DeleteFirewallPolicyRequest(proto.Message): - r"""A request message for FirewallPolicies.Delete. See the method - description for details. - - Attributes: - firewall_policy (str): - Name of the firewall policy to delete. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - firewall_policy = proto.Field(proto.STRING, number=498173265,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class GetFirewallPolicyRequest(proto.Message): - r"""A request message for FirewallPolicies.Get. See the method - description for details. - - Attributes: - firewall_policy (str): - Name of the firewall policy to get. - """ - - firewall_policy = proto.Field(proto.STRING, number=498173265,) - - -class GetAssociationFirewallPolicyRequest(proto.Message): - r"""A request message for FirewallPolicies.GetAssociation. See - the method description for details. - - Attributes: - firewall_policy (str): - Name of the firewall policy to which the - queried rule belongs. - name (str): - The name of the association to get from the - firewall policy. - """ - - firewall_policy = proto.Field(proto.STRING, number=498173265,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - - -class GetIamPolicyFirewallPolicyRequest(proto.Message): - r"""A request message for FirewallPolicies.GetIamPolicy. See the - method description for details. - - Attributes: - options_requested_policy_version (int): - Requested IAM Policy version. - resource (str): - Name or id of the resource for this request. - """ - - options_requested_policy_version = proto.Field( - proto.INT32, number=499220029, optional=True, - ) - resource = proto.Field(proto.STRING, number=195806222,) - - -class GetRuleFirewallPolicyRequest(proto.Message): - r"""A request message for FirewallPolicies.GetRule. See the - method description for details. - - Attributes: - firewall_policy (str): - Name of the firewall policy to which the - queried rule belongs. - priority (int): - The priority of the rule to get from the - firewall policy. - """ - - firewall_policy = proto.Field(proto.STRING, number=498173265,) - priority = proto.Field(proto.INT32, number=445151652, optional=True,) - - -class InsertFirewallPolicyRequest(proto.Message): - r"""A request message for FirewallPolicies.Insert. See the method - description for details. - - Attributes: - firewall_policy_resource (google.cloud.compute_v1.types.FirewallPolicy): - The body resource for this request - parent_id (str): - Parent ID for this request. The ID can be either be - "folders/[FOLDER_ID]" if the parent is a folder or - "organizations/[ORGANIZATION_ID]" if the parent is an - organization. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - firewall_policy_resource = proto.Field( - proto.MESSAGE, number=495049532, message="FirewallPolicy", - ) - parent_id = proto.Field(proto.STRING, number=459714768, optional=True,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + region = proto.Field(proto.STRING, number=138946292,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class ListFirewallPoliciesRequest(proto.Message): - r"""A request message for FirewallPolicies.List. See the method +class ListRegionHealthChecksRequest(proto.Message): + r"""A request message for RegionHealthChecks.List. See the method description for details. Attributes: @@ -28161,20 +27728,16 @@ class ListFirewallPoliciesRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions @@ -28190,24 +27753,22 @@ class ListFirewallPoliciesRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the ``nextPageToken`` returned by a previous list request to get the next page of results. - parent_id (str): - Parent ID for this request. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. return_partial_success (bool): Opt-in for partial success behavior which provides partial results in case of failure. The @@ -28218,307 +27779,418 @@ class ListFirewallPoliciesRequest(proto.Message): max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) order_by = proto.Field(proto.STRING, number=160562920, optional=True,) page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - parent_id = proto.Field(proto.STRING, number=459714768, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class ListAssociationsFirewallPolicyRequest(proto.Message): - r"""A request message for FirewallPolicies.ListAssociations. See +class ListRegionInstanceGroupManagersRequest(proto.Message): + r"""A request message for RegionInstanceGroupManagers.List. See the method description for details. Attributes: - target_resource (str): - The target resource to list associations. It - is an organization, or a folder. - """ - - target_resource = proto.Field(proto.STRING, number=467318524, optional=True,) - - -class MoveFirewallPolicyRequest(proto.Message): - r"""A request message for FirewallPolicies.Move. See the method - description for details. - - Attributes: - firewall_policy (str): - Name of the firewall policy to update. - parent_id (str): - The new parent of the firewall policy. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - firewall_policy = proto.Field(proto.STRING, number=498173265,) - parent_id = proto.Field(proto.STRING, number=459714768, optional=True,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class PatchFirewallPolicyRequest(proto.Message): - r"""A request message for FirewallPolicies.Patch. See the method - description for details. - - Attributes: - firewall_policy (str): - Name of the firewall policy to update. - firewall_policy_resource (google.cloud.compute_v1.types.FirewallPolicy): - The body resource for this request - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - firewall_policy = proto.Field(proto.STRING, number=498173265,) - firewall_policy_resource = proto.Field( - proto.MESSAGE, number=495049532, message="FirewallPolicy", - ) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class PatchRuleFirewallPolicyRequest(proto.Message): - r"""A request message for FirewallPolicies.PatchRule. See the +class ListRegionInstanceGroupsRequest(proto.Message): + r"""A request message for RegionInstanceGroups.List. See the method description for details. Attributes: - firewall_policy (str): - Name of the firewall policy to update. - firewall_policy_rule_resource (google.cloud.compute_v1.types.FirewallPolicyRule): - The body resource for this request - priority (int): - The priority of the rule to patch. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - firewall_policy = proto.Field(proto.STRING, number=498173265,) - firewall_policy_rule_resource = proto.Field( - proto.MESSAGE, number=250523523, message="FirewallPolicyRule", - ) - priority = proto.Field(proto.INT32, number=445151652, optional=True,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class RemoveAssociationFirewallPolicyRequest(proto.Message): - r"""A request message for FirewallPolicies.RemoveAssociation. See +class ListRegionNetworkEndpointGroupsRequest(proto.Message): + r"""A request message for RegionNetworkEndpointGroups.List. See the method description for details. Attributes: - firewall_policy (str): - Name of the firewall policy to update. - name (str): - Name for the attachment that will be removed. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - firewall_policy = proto.Field(proto.STRING, number=498173265,) - name = proto.Field(proto.STRING, number=3373707, optional=True,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class RemoveRuleFirewallPolicyRequest(proto.Message): - r"""A request message for FirewallPolicies.RemoveRule. See the - method description for details. - - Attributes: - firewall_policy (str): - Name of the firewall policy to update. - priority (int): - The priority of the rule to remove from the - firewall policy. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - firewall_policy = proto.Field(proto.STRING, number=498173265,) - priority = proto.Field(proto.INT32, number=445151652, optional=True,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class SetIamPolicyFirewallPolicyRequest(proto.Message): - r"""A request message for FirewallPolicies.SetIamPolicy. See the - method description for details. - - Attributes: - global_organization_set_policy_request_resource (google.cloud.compute_v1.types.GlobalOrganizationSetPolicyRequest): - The body resource for this request - resource (str): - Name or id of the resource for this request. - """ - - global_organization_set_policy_request_resource = proto.Field( - proto.MESSAGE, number=177408606, message="GlobalOrganizationSetPolicyRequest", - ) - resource = proto.Field(proto.STRING, number=195806222,) - - -class TestIamPermissionsFirewallPolicyRequest(proto.Message): - r"""A request message for FirewallPolicies.TestIamPermissions. - See the method description for details. - - Attributes: - resource (str): - Name or id of the resource for this request. - test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): - The body resource for this request + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. + project (str): + Project ID for this request. + region (str): + The name of the region where the network + endpoint group is located. It should comply with + RFC1035. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - resource = proto.Field(proto.STRING, number=195806222,) - test_permissions_request_resource = proto.Field( - proto.MESSAGE, number=439214758, message="TestPermissionsRequest", - ) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class DeleteFirewallRequest(proto.Message): - r"""A request message for Firewalls.Delete. See the method - description for details. +class ListRegionNotificationEndpointsRequest(proto.Message): + r"""A request message for RegionNotificationEndpoints.List. See + the method description for details. Attributes: - firewall (str): - Name of the firewall rule to delete. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. project (str): Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + region (str): + Name of the region scoping this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - firewall = proto.Field(proto.STRING, number=511016192,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + region = proto.Field(proto.STRING, number=138946292,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class GetFirewallRequest(proto.Message): - r"""A request message for Firewalls.Get. See the method +class ListRegionOperationsRequest(proto.Message): + r"""A request message for RegionOperations.List. See the method description for details. Attributes: - firewall (str): - Name of the firewall rule to return. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. project (str): Project ID for this request. + region (str): + Name of the region for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - firewall = proto.Field(proto.STRING, number=511016192,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class InsertFirewallRequest(proto.Message): - r"""A request message for Firewalls.Insert. See the method - description for details. +class ListRegionSslCertificatesRequest(proto.Message): + r"""A request message for RegionSslCertificates.List. See the + method description for details. Attributes: - firewall_resource (google.cloud.compute_v1.types.Firewall): - The body resource for this request + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. project (str): Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + region (str): + Name of the region scoping this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - firewall_resource = proto.Field(proto.MESSAGE, number=41425005, message="Firewall",) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + region = proto.Field(proto.STRING, number=138946292,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class ListFirewallsRequest(proto.Message): - r"""A request message for Firewalls.List. See the method - description for details. +class ListRegionTargetHttpProxiesRequest(proto.Message): + r"""A request message for RegionTargetHttpProxies.List. See the + method description for details. Attributes: filter (str): @@ -28527,20 +28199,16 @@ class ListFirewallsRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions @@ -28556,17 +28224,13 @@ class ListFirewallsRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -28574,6 +28238,8 @@ class ListFirewallsRequest(proto.Message): the next page of results. project (str): Project ID for this request. + region (str): + Name of the region scoping this request. return_partial_success (bool): Opt-in for partial success behavior which provides partial results in case of failure. The @@ -28585,81 +28251,12 @@ class ListFirewallsRequest(proto.Message): order_by = proto.Field(proto.STRING, number=160562920, optional=True,) page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class PatchFirewallRequest(proto.Message): - r"""A request message for Firewalls.Patch. See the method - description for details. - - Attributes: - firewall (str): - Name of the firewall rule to patch. - firewall_resource (google.cloud.compute_v1.types.Firewall): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - firewall = proto.Field(proto.STRING, number=511016192,) - firewall_resource = proto.Field(proto.MESSAGE, number=41425005, message="Firewall",) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class UpdateFirewallRequest(proto.Message): - r"""A request message for Firewalls.Update. See the method - description for details. - - Attributes: - firewall (str): - Name of the firewall rule to update. - firewall_resource (google.cloud.compute_v1.types.Firewall): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - firewall = proto.Field(proto.STRING, number=511016192,) - firewall_resource = proto.Field(proto.MESSAGE, number=41425005, message="Firewall",) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class AggregatedListForwardingRulesRequest(proto.Message): - r"""A request message for ForwardingRules.AggregatedList. See the +class ListRegionTargetHttpsProxiesRequest(proto.Message): + r"""A request message for RegionTargetHttpsProxies.List. See the method description for details. Attributes: @@ -28669,36 +28266,21 @@ class AggregatedListForwardingRulesRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions explicitly. For example: ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. max_results (int): The maximum number of results per page that should be returned. If the number of available results is larger than @@ -28709,17 +28291,13 @@ class AggregatedListForwardingRulesRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -28727,6 +28305,8 @@ class AggregatedListForwardingRulesRequest(proto.Message): the next page of results. project (str): Project ID for this request. + region (str): + Name of the region scoping this request. return_partial_success (bool): Opt-in for partial success behavior which provides partial results in case of failure. The @@ -28734,108 +28314,214 @@ class AggregatedListForwardingRulesRequest(proto.Message): """ filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) order_by = proto.Field(proto.STRING, number=160562920, optional=True,) page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class DeleteForwardingRuleRequest(proto.Message): - r"""A request message for ForwardingRules.Delete. See the method +class ListRegionUrlMapsRequest(proto.Message): + r"""A request message for RegionUrlMaps.List. See the method description for details. Attributes: - forwarding_rule (str): - Name of the ForwardingRule resource to - delete. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. project (str): Project ID for this request. region (str): Name of the region scoping this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - forwarding_rule = proto.Field(proto.STRING, number=269964030,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class GetForwardingRuleRequest(proto.Message): - r"""A request message for ForwardingRules.Get. See the method +class ListRegionsRequest(proto.Message): + r"""A request message for Regions.List. See the method description for details. Attributes: - forwarding_rule (str): - Name of the ForwardingRule resource to - return. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. project (str): Project ID for this request. - region (str): - Name of the region scoping this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - forwarding_rule = proto.Field(proto.STRING, number=269964030,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class InsertForwardingRuleRequest(proto.Message): - r"""A request message for ForwardingRules.Insert. See the method +class ListReservationsRequest(proto.Message): + r"""A request message for Reservations.List. See the method description for details. Attributes: - forwarding_rule_resource (google.cloud.compute_v1.types.ForwardingRule): - The body resource for this request + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. project (str): Project ID for this request. - region (str): - Name of the region scoping this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. + zone (str): + Name of the zone for this request. """ - forwarding_rule_resource = proto.Field( - proto.MESSAGE, number=301211695, message="ForwardingRule", - ) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class ListForwardingRulesRequest(proto.Message): - r"""A request message for ForwardingRules.List. See the method +class ListResourcePoliciesRequest(proto.Message): + r"""A request message for ResourcePolicies.List. See the method description for details. Attributes: @@ -28845,20 +28531,16 @@ class ListForwardingRulesRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions @@ -28874,17 +28556,13 @@ class ListForwardingRulesRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -28893,7 +28571,7 @@ class ListForwardingRulesRequest(proto.Message): project (str): Project ID for this request. region (str): - Name of the region scoping this request. + Name of the region for this request. return_partial_success (bool): Opt-in for partial success behavior which provides partial results in case of failure. The @@ -28909,208 +28587,139 @@ class ListForwardingRulesRequest(proto.Message): return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class PatchForwardingRuleRequest(proto.Message): - r"""A request message for ForwardingRules.Patch. See the method +class ListRoutersRequest(proto.Message): + r"""A request message for Routers.List. See the method description for details. Attributes: - forwarding_rule (str): - Name of the ForwardingRule resource to patch. - forwarding_rule_resource (google.cloud.compute_v1.types.ForwardingRule): - The body resource for this request - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - forwarding_rule = proto.Field(proto.STRING, number=269964030,) - forwarding_rule_resource = proto.Field( - proto.MESSAGE, number=301211695, message="ForwardingRule", - ) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class SetLabelsForwardingRuleRequest(proto.Message): - r"""A request message for ForwardingRules.SetLabels. See the - method description for details. - - Attributes: - project (str): - Project ID for this request. - region (str): - The region for this request. - region_set_labels_request_resource (google.cloud.compute_v1.types.RegionSetLabelsRequest): - The body resource for this request - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - resource (str): - Name or id of the resource for this request. - """ - - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - region_set_labels_request_resource = proto.Field( - proto.MESSAGE, number=259357782, message="RegionSetLabelsRequest", - ) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - resource = proto.Field(proto.STRING, number=195806222,) - - -class SetTargetForwardingRuleRequest(proto.Message): - r"""A request message for ForwardingRules.SetTarget. See the - method description for details. - - Attributes: - forwarding_rule (str): - Name of the ForwardingRule resource in which - target is to be set. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. project (str): Project ID for this request. region (str): - Name of the region scoping this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_reference_resource (google.cloud.compute_v1.types.TargetReference): - The body resource for this request + Name of the region for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - forwarding_rule = proto.Field(proto.STRING, number=269964030,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_reference_resource = proto.Field( - proto.MESSAGE, number=523721712, message="TargetReference", - ) - - -class DeleteGlobalAddressRequest(proto.Message): - r"""A request message for GlobalAddresses.Delete. See the method - description for details. - - Attributes: - address (str): - Name of the address resource to delete. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - address = proto.Field(proto.STRING, number=462920692,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class GetGlobalAddressRequest(proto.Message): - r"""A request message for GlobalAddresses.Get. See the method - description for details. - - Attributes: - address (str): - Name of the address resource to return. - project (str): - Project ID for this request. - """ - - address = proto.Field(proto.STRING, number=462920692,) - project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class InsertGlobalAddressRequest(proto.Message): - r"""A request message for GlobalAddresses.Insert. See the method - description for details. +class ListRoutesRequest(proto.Message): + r"""A request message for Routes.List. See the method description + for details. Attributes: - address_resource (google.cloud.compute_v1.types.Address): - The body resource for this request + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. project (str): Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - address_resource = proto.Field(proto.MESSAGE, number=483888121, message="Address",) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class ListGlobalAddressesRequest(proto.Message): - r"""A request message for GlobalAddresses.List. See the method +class ListSecurityPoliciesRequest(proto.Message): + r"""A request message for SecurityPolicies.List. See the method description for details. Attributes: @@ -29120,20 +28729,16 @@ class ListGlobalAddressesRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions @@ -29149,17 +28754,13 @@ class ListGlobalAddressesRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -29181,92 +28782,9 @@ class ListGlobalAddressesRequest(proto.Message): return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class DeleteGlobalForwardingRuleRequest(proto.Message): - r"""A request message for GlobalForwardingRules.Delete. See the - method description for details. - - Attributes: - forwarding_rule (str): - Name of the ForwardingRule resource to - delete. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - forwarding_rule = proto.Field(proto.STRING, number=269964030,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class GetGlobalForwardingRuleRequest(proto.Message): - r"""A request message for GlobalForwardingRules.Get. See the - method description for details. - - Attributes: - forwarding_rule (str): - Name of the ForwardingRule resource to - return. - project (str): - Project ID for this request. - """ - - forwarding_rule = proto.Field(proto.STRING, number=269964030,) - project = proto.Field(proto.STRING, number=227560217,) - - -class InsertGlobalForwardingRuleRequest(proto.Message): - r"""A request message for GlobalForwardingRules.Insert. See the - method description for details. - - Attributes: - forwarding_rule_resource (google.cloud.compute_v1.types.ForwardingRule): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - forwarding_rule_resource = proto.Field( - proto.MESSAGE, number=301211695, message="ForwardingRule", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class ListGlobalForwardingRulesRequest(proto.Message): - r"""A request message for GlobalForwardingRules.List. See the - method description for details. +class ListServiceAttachmentsRequest(proto.Message): + r"""A request message for ServiceAttachments.List. See the method + description for details. Attributes: filter (str): @@ -29275,20 +28793,16 @@ class ListGlobalForwardingRulesRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions @@ -29304,17 +28818,13 @@ class ListGlobalForwardingRulesRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -29322,6 +28832,8 @@ class ListGlobalForwardingRulesRequest(proto.Message): the next page of results. project (str): Project ID for this request. + region (str): + Name of the region of this request. return_partial_success (bool): Opt-in for partial success behavior which provides partial results in case of failure. The @@ -29333,274 +28845,77 @@ class ListGlobalForwardingRulesRequest(proto.Message): order_by = proto.Field(proto.STRING, number=160562920, optional=True,) page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class PatchGlobalForwardingRuleRequest(proto.Message): - r"""A request message for GlobalForwardingRules.Patch. See the - method description for details. - - Attributes: - forwarding_rule (str): - Name of the ForwardingRule resource to patch. - forwarding_rule_resource (google.cloud.compute_v1.types.ForwardingRule): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - forwarding_rule = proto.Field(proto.STRING, number=269964030,) - forwarding_rule_resource = proto.Field( - proto.MESSAGE, number=301211695, message="ForwardingRule", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class SetLabelsGlobalForwardingRuleRequest(proto.Message): - r"""A request message for GlobalForwardingRules.SetLabels. See - the method description for details. - - Attributes: - global_set_labels_request_resource (google.cloud.compute_v1.types.GlobalSetLabelsRequest): - The body resource for this request - project (str): - Project ID for this request. - resource (str): - Name or id of the resource for this request. - """ - - global_set_labels_request_resource = proto.Field( - proto.MESSAGE, number=319917189, message="GlobalSetLabelsRequest", - ) - project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) - - -class SetTargetGlobalForwardingRuleRequest(proto.Message): - r"""A request message for GlobalForwardingRules.SetTarget. See - the method description for details. - - Attributes: - forwarding_rule (str): - Name of the ForwardingRule resource in which - target is to be set. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_reference_resource (google.cloud.compute_v1.types.TargetReference): - The body resource for this request - """ - - forwarding_rule = proto.Field(proto.STRING, number=269964030,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_reference_resource = proto.Field( - proto.MESSAGE, number=523721712, message="TargetReference", - ) - - -class AttachNetworkEndpointsGlobalNetworkEndpointGroupRequest(proto.Message): - r"""A request message for - GlobalNetworkEndpointGroups.AttachNetworkEndpoints. See the - method description for details. - - Attributes: - global_network_endpoint_groups_attach_endpoints_request_resource (google.cloud.compute_v1.types.GlobalNetworkEndpointGroupsAttachEndpointsRequest): - The body resource for this request - network_endpoint_group (str): - The name of the network endpoint group where - you are attaching network endpoints to. It - should comply with RFC1035. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - global_network_endpoint_groups_attach_endpoints_request_resource = proto.Field( - proto.MESSAGE, - number=30691563, - message="GlobalNetworkEndpointGroupsAttachEndpointsRequest", - ) - network_endpoint_group = proto.Field(proto.STRING, number=433907078,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class DeleteGlobalNetworkEndpointGroupRequest(proto.Message): - r"""A request message for GlobalNetworkEndpointGroups.Delete. See - the method description for details. - - Attributes: - network_endpoint_group (str): - The name of the network endpoint group to - delete. It should comply with RFC1035. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - network_endpoint_group = proto.Field(proto.STRING, number=433907078,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class DetachNetworkEndpointsGlobalNetworkEndpointGroupRequest(proto.Message): - r"""A request message for - GlobalNetworkEndpointGroups.DetachNetworkEndpoints. See the - method description for details. - - Attributes: - global_network_endpoint_groups_detach_endpoints_request_resource (google.cloud.compute_v1.types.GlobalNetworkEndpointGroupsDetachEndpointsRequest): - The body resource for this request - network_endpoint_group (str): - The name of the network endpoint group where - you are removing network endpoints. It should - comply with RFC1035. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - global_network_endpoint_groups_detach_endpoints_request_resource = proto.Field( - proto.MESSAGE, - number=8898269, - message="GlobalNetworkEndpointGroupsDetachEndpointsRequest", - ) - network_endpoint_group = proto.Field(proto.STRING, number=433907078,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class GetGlobalNetworkEndpointGroupRequest(proto.Message): - r"""A request message for GlobalNetworkEndpointGroups.Get. See - the method description for details. - - Attributes: - network_endpoint_group (str): - The name of the network endpoint group. It - should comply with RFC1035. - project (str): - Project ID for this request. - """ - - network_endpoint_group = proto.Field(proto.STRING, number=433907078,) - project = proto.Field(proto.STRING, number=227560217,) - - -class InsertGlobalNetworkEndpointGroupRequest(proto.Message): - r"""A request message for GlobalNetworkEndpointGroups.Insert. See - the method description for details. +class ListSnapshotsRequest(proto.Message): + r"""A request message for Snapshots.List. See the method + description for details. Attributes: - network_endpoint_group_resource (google.cloud.compute_v1.types.NetworkEndpointGroup): - The body resource for this request + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. project (str): Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - network_endpoint_group_resource = proto.Field( - proto.MESSAGE, number=525788839, message="NetworkEndpointGroup", - ) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class ListGlobalNetworkEndpointGroupsRequest(proto.Message): - r"""A request message for GlobalNetworkEndpointGroups.List. See - the method description for details. +class ListSslCertificatesRequest(proto.Message): + r"""A request message for SslCertificates.List. See the method + description for details. Attributes: filter (str): @@ -29609,20 +28924,16 @@ class ListGlobalNetworkEndpointGroupsRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions @@ -29638,17 +28949,13 @@ class ListGlobalNetworkEndpointGroupsRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -29670,9 +28977,8 @@ class ListGlobalNetworkEndpointGroupsRequest(proto.Message): return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class ListNetworkEndpointsGlobalNetworkEndpointGroupsRequest(proto.Message): - r"""A request message for - GlobalNetworkEndpointGroups.ListNetworkEndpoints. See the method +class ListSslPoliciesRequest(proto.Message): + r"""A request message for SslPolicies.List. See the method description for details. Attributes: @@ -29682,20 +28988,16 @@ class ListNetworkEndpointsGlobalNetworkEndpointGroupsRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions @@ -29708,25 +29010,16 @@ class ListNetworkEndpointsGlobalNetworkEndpointGroupsRequest(proto.Message): that can be used to get the next page of results in subsequent list requests. Acceptable values are ``0`` to ``500``, inclusive. (Default: ``500``) - network_endpoint_group (str): - The name of the network endpoint group from - which you want to generate a list of included - network endpoints. It should comply with - RFC1035. order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -29742,16 +29035,15 @@ class ListNetworkEndpointsGlobalNetworkEndpointGroupsRequest(proto.Message): filter = proto.Field(proto.STRING, number=336120696, optional=True,) max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - network_endpoint_group = proto.Field(proto.STRING, number=433907078,) order_by = proto.Field(proto.STRING, number=160562920, optional=True,) page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class AggregatedListGlobalOperationsRequest(proto.Message): - r"""A request message for GlobalOperations.AggregatedList. See - the method description for details. +class ListSubnetworksRequest(proto.Message): + r"""A request message for Subnetworks.List. See the method + description for details. Attributes: filter (str): @@ -29760,36 +29052,21 @@ class AggregatedListGlobalOperationsRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions explicitly. For example: ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. max_results (int): The maximum number of results per page that should be returned. If the number of available results is larger than @@ -29800,17 +29077,13 @@ class AggregatedListGlobalOperationsRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -29818,6 +29091,8 @@ class AggregatedListGlobalOperationsRequest(proto.Message): the next page of results. project (str): Project ID for this request. + region (str): + Name of the region scoping this request. return_partial_success (bool): Opt-in for partial success behavior which provides partial results in case of failure. The @@ -29825,52 +29100,144 @@ class AggregatedListGlobalOperationsRequest(proto.Message): """ filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) order_by = proto.Field(proto.STRING, number=160562920, optional=True,) page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class DeleteGlobalOperationRequest(proto.Message): - r"""A request message for GlobalOperations.Delete. See the method +class ListTargetGrpcProxiesRequest(proto.Message): + r"""A request message for TargetGrpcProxies.List. See the method description for details. Attributes: - operation (str): - Name of the Operations resource to delete. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. project (str): Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - operation = proto.Field(proto.STRING, number=52090215,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class DeleteGlobalOperationResponse(proto.Message): - r"""A response message for GlobalOperations.Delete. See the - method description for details. - """ - - -class GetGlobalOperationRequest(proto.Message): - r"""A request message for GlobalOperations.Get. See the method +class ListTargetHttpProxiesRequest(proto.Message): + r"""A request message for TargetHttpProxies.List. See the method description for details. Attributes: - operation (str): - Name of the Operations resource to return. + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. project (str): Project ID for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - operation = proto.Field(proto.STRING, number=52090215,) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class ListGlobalOperationsRequest(proto.Message): - r"""A request message for GlobalOperations.List. See the method +class ListTargetHttpsProxiesRequest(proto.Message): + r"""A request message for TargetHttpsProxies.List. See the method description for details. Attributes: @@ -29880,20 +29247,16 @@ class ListGlobalOperationsRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions @@ -29909,17 +29272,13 @@ class ListGlobalOperationsRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -29941,61 +29300,10 @@ class ListGlobalOperationsRequest(proto.Message): return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class WaitGlobalOperationRequest(proto.Message): - r"""A request message for GlobalOperations.Wait. See the method +class ListTargetInstancesRequest(proto.Message): + r"""A request message for TargetInstances.List. See the method description for details. - Attributes: - operation (str): - Name of the Operations resource to return. - project (str): - Project ID for this request. - """ - - operation = proto.Field(proto.STRING, number=52090215,) - project = proto.Field(proto.STRING, number=227560217,) - - -class DeleteGlobalOrganizationOperationRequest(proto.Message): - r"""A request message for GlobalOrganizationOperations.Delete. - See the method description for details. - - Attributes: - operation (str): - Name of the Operations resource to delete. - parent_id (str): - Parent ID for this request. - """ - - operation = proto.Field(proto.STRING, number=52090215,) - parent_id = proto.Field(proto.STRING, number=459714768, optional=True,) - - -class DeleteGlobalOrganizationOperationResponse(proto.Message): - r"""A response message for GlobalOrganizationOperations.Delete. - See the method description for details. - """ - - -class GetGlobalOrganizationOperationRequest(proto.Message): - r"""A request message for GlobalOrganizationOperations.Get. See - the method description for details. - - Attributes: - operation (str): - Name of the Operations resource to return. - parent_id (str): - Parent ID for this request. - """ - - operation = proto.Field(proto.STRING, number=52090215,) - parent_id = proto.Field(proto.STRING, number=459714768, optional=True,) - - -class ListGlobalOrganizationOperationsRequest(proto.Message): - r"""A request message for GlobalOrganizationOperations.List. See - the method description for details. - Attributes: filter (str): A filter expression that filters resources listed in the @@ -30003,20 +29311,16 @@ class ListGlobalOrganizationOperationsRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions @@ -30032,124 +29336,40 @@ class ListGlobalOrganizationOperationsRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the ``nextPageToken`` returned by a previous list request to get the next page of results. - parent_id (str): - Parent ID for this request. + project (str): + Project ID for this request. return_partial_success (bool): Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. + zone (str): + Name of the zone scoping this request. """ filter = proto.Field(proto.STRING, number=336120696, optional=True,) max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) order_by = proto.Field(proto.STRING, number=160562920, optional=True,) page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - parent_id = proto.Field(proto.STRING, number=459714768, optional=True,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - - -class DeleteGlobalPublicDelegatedPrefixeRequest(proto.Message): - r"""A request message for GlobalPublicDelegatedPrefixes.Delete. - See the method description for details. - - Attributes: - project (str): - Project ID for this request. - public_delegated_prefix (str): - Name of the PublicDelegatedPrefix resource to - delete. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - project = proto.Field(proto.STRING, number=227560217,) - public_delegated_prefix = proto.Field(proto.STRING, number=204238440,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class GetGlobalPublicDelegatedPrefixeRequest(proto.Message): - r"""A request message for GlobalPublicDelegatedPrefixes.Get. See - the method description for details. - - Attributes: - project (str): - Project ID for this request. - public_delegated_prefix (str): - Name of the PublicDelegatedPrefix resource to - return. - """ - - project = proto.Field(proto.STRING, number=227560217,) - public_delegated_prefix = proto.Field(proto.STRING, number=204238440,) - - -class InsertGlobalPublicDelegatedPrefixeRequest(proto.Message): - r"""A request message for GlobalPublicDelegatedPrefixes.Insert. - See the method description for details. - - Attributes: - project (str): - Project ID for this request. - public_delegated_prefix_resource (google.cloud.compute_v1.types.PublicDelegatedPrefix): - The body resource for this request - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - project = proto.Field(proto.STRING, number=227560217,) - public_delegated_prefix_resource = proto.Field( - proto.MESSAGE, number=47594501, message="PublicDelegatedPrefix", - ) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class ListGlobalPublicDelegatedPrefixesRequest(proto.Message): - r"""A request message for GlobalPublicDelegatedPrefixes.List. See - the method description for details. +class ListTargetPoolsRequest(proto.Message): + r"""A request message for TargetPools.List. See the method + description for details. Attributes: filter (str): @@ -30158,20 +29378,16 @@ class ListGlobalPublicDelegatedPrefixesRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions @@ -30187,17 +29403,13 @@ class ListGlobalPublicDelegatedPrefixesRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -30205,6 +29417,8 @@ class ListGlobalPublicDelegatedPrefixesRequest(proto.Message): the next page of results. project (str): Project ID for this request. + region (str): + Name of the region scoping this request. return_partial_success (bool): Opt-in for partial success behavior which provides partial results in case of failure. The @@ -30216,50 +29430,13 @@ class ListGlobalPublicDelegatedPrefixesRequest(proto.Message): order_by = proto.Field(proto.STRING, number=160562920, optional=True,) page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class PatchGlobalPublicDelegatedPrefixeRequest(proto.Message): - r"""A request message for GlobalPublicDelegatedPrefixes.Patch. - See the method description for details. - - Attributes: - project (str): - Project ID for this request. - public_delegated_prefix (str): - Name of the PublicDelegatedPrefix resource to - patch. - public_delegated_prefix_resource (google.cloud.compute_v1.types.PublicDelegatedPrefix): - The body resource for this request - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - project = proto.Field(proto.STRING, number=227560217,) - public_delegated_prefix = proto.Field(proto.STRING, number=204238440,) - public_delegated_prefix_resource = proto.Field( - proto.MESSAGE, number=47594501, message="PublicDelegatedPrefix", - ) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class AggregatedListHealthChecksRequest(proto.Message): - r"""A request message for HealthChecks.AggregatedList. See the - method description for details. +class ListTargetSslProxiesRequest(proto.Message): + r"""A request message for TargetSslProxies.List. See the method + description for details. Attributes: filter (str): @@ -30268,36 +29445,21 @@ class AggregatedListHealthChecksRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions explicitly. For example: ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. max_results (int): The maximum number of results per page that should be returned. If the number of available results is larger than @@ -30308,24 +29470,20 @@ class AggregatedListHealthChecksRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the ``nextPageToken`` returned by a previous list request to get the next page of results. project (str): - Name of the project scoping this request. + Project ID for this request. return_partial_success (bool): Opt-in for partial success behavior which provides partial results in case of failure. The @@ -30333,7 +29491,6 @@ class AggregatedListHealthChecksRequest(proto.Message): """ filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) order_by = proto.Field(proto.STRING, number=160562920, optional=True,) page_token = proto.Field(proto.STRING, number=19994697, optional=True,) @@ -30341,89 +29498,8 @@ class AggregatedListHealthChecksRequest(proto.Message): return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class DeleteHealthCheckRequest(proto.Message): - r"""A request message for HealthChecks.Delete. See the method - description for details. - - Attributes: - health_check (str): - Name of the HealthCheck resource to delete. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - health_check = proto.Field(proto.STRING, number=308876645,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class GetHealthCheckRequest(proto.Message): - r"""A request message for HealthChecks.Get. See the method - description for details. - - Attributes: - health_check (str): - Name of the HealthCheck resource to return. - project (str): - Project ID for this request. - """ - - health_check = proto.Field(proto.STRING, number=308876645,) - project = proto.Field(proto.STRING, number=227560217,) - - -class InsertHealthCheckRequest(proto.Message): - r"""A request message for HealthChecks.Insert. See the method - description for details. - - Attributes: - health_check_resource (google.cloud.compute_v1.types.HealthCheck): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - health_check_resource = proto.Field( - proto.MESSAGE, number=201925032, message="HealthCheck", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class ListHealthChecksRequest(proto.Message): - r"""A request message for HealthChecks.List. See the method +class ListTargetTcpProxiesRequest(proto.Message): + r"""A request message for TargetTcpProxies.List. See the method description for details. Attributes: @@ -30433,20 +29509,16 @@ class ListHealthChecksRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions @@ -30462,17 +29534,13 @@ class ListHealthChecksRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -30483,248 +29551,20 @@ class ListHealthChecksRequest(proto.Message): return_partial_success (bool): Opt-in for partial success behavior which provides partial results in case of failure. The - default value is false. - """ - - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - - -class PatchHealthCheckRequest(proto.Message): - r"""A request message for HealthChecks.Patch. See the method - description for details. - - Attributes: - health_check (str): - Name of the HealthCheck resource to patch. - health_check_resource (google.cloud.compute_v1.types.HealthCheck): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - health_check = proto.Field(proto.STRING, number=308876645,) - health_check_resource = proto.Field( - proto.MESSAGE, number=201925032, message="HealthCheck", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class UpdateHealthCheckRequest(proto.Message): - r"""A request message for HealthChecks.Update. See the method - description for details. - - Attributes: - health_check (str): - Name of the HealthCheck resource to update. - health_check_resource (google.cloud.compute_v1.types.HealthCheck): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - health_check = proto.Field(proto.STRING, number=308876645,) - health_check_resource = proto.Field( - proto.MESSAGE, number=201925032, message="HealthCheck", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class DeleteImageRequest(proto.Message): - r"""A request message for Images.Delete. See the method - description for details. - - Attributes: - image (str): - Name of the image resource to delete. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - image = proto.Field(proto.STRING, number=100313435,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class DeprecateImageRequest(proto.Message): - r"""A request message for Images.Deprecate. See the method - description for details. - - Attributes: - deprecation_status_resource (google.cloud.compute_v1.types.DeprecationStatus): - The body resource for this request - image (str): - Image name. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - deprecation_status_resource = proto.Field( - proto.MESSAGE, number=333006064, message="DeprecationStatus", - ) - image = proto.Field(proto.STRING, number=100313435,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class GetImageRequest(proto.Message): - r"""A request message for Images.Get. See the method description - for details. - - Attributes: - image (str): - Name of the image resource to return. - project (str): - Project ID for this request. - """ - - image = proto.Field(proto.STRING, number=100313435,) - project = proto.Field(proto.STRING, number=227560217,) - - -class GetFromFamilyImageRequest(proto.Message): - r"""A request message for Images.GetFromFamily. See the method - description for details. - - Attributes: - family (str): - Name of the image family to search for. - project (str): - Project ID for this request. - """ - - family = proto.Field(proto.STRING, number=328751972,) - project = proto.Field(proto.STRING, number=227560217,) - - -class GetIamPolicyImageRequest(proto.Message): - r"""A request message for Images.GetIamPolicy. See the method - description for details. - - Attributes: - options_requested_policy_version (int): - Requested IAM Policy version. - project (str): - Project ID for this request. - resource (str): - Name or id of the resource for this request. - """ - - options_requested_policy_version = proto.Field( - proto.INT32, number=499220029, optional=True, - ) - project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) - - -class InsertImageRequest(proto.Message): - r"""A request message for Images.Insert. See the method - description for details. - - Attributes: - force_create (bool): - Force image creation if true. - image_resource (google.cloud.compute_v1.types.Image): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + default value is false. """ - force_create = proto.Field(proto.BOOL, number=197723344, optional=True,) - image_resource = proto.Field(proto.MESSAGE, number=371171954, message="Image",) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class ListImagesRequest(proto.Message): - r"""A request message for Images.List. See the method description - for details. +class ListTargetVpnGatewaysRequest(proto.Message): + r"""A request message for TargetVpnGateways.List. See the method + description for details. Attributes: filter (str): @@ -30733,20 +29573,16 @@ class ListImagesRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions @@ -30762,17 +29598,13 @@ class ListImagesRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -30780,6 +29612,8 @@ class ListImagesRequest(proto.Message): the next page of results. project (str): Project ID for this request. + region (str): + Name of the region for this request. return_partial_success (bool): Opt-in for partial success behavior which provides partial results in case of failure. The @@ -30791,151 +29625,78 @@ class ListImagesRequest(proto.Message): order_by = proto.Field(proto.STRING, number=160562920, optional=True,) page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class PatchImageRequest(proto.Message): - r"""A request message for Images.Patch. See the method - description for details. - - Attributes: - image (str): - Name of the image resource to patch. - image_resource (google.cloud.compute_v1.types.Image): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - image = proto.Field(proto.STRING, number=100313435,) - image_resource = proto.Field(proto.MESSAGE, number=371171954, message="Image",) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class SetIamPolicyImageRequest(proto.Message): - r"""A request message for Images.SetIamPolicy. See the method +class ListUrlMapsRequest(proto.Message): + r"""A request message for UrlMaps.List. See the method description for details. Attributes: - global_set_policy_request_resource (google.cloud.compute_v1.types.GlobalSetPolicyRequest): - The body resource for this request + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. project (str): Project ID for this request. - resource (str): - Name or id of the resource for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - global_set_policy_request_resource = proto.Field( - proto.MESSAGE, number=337048498, message="GlobalSetPolicyRequest", - ) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class SetLabelsImageRequest(proto.Message): - r"""A request message for Images.SetLabels. See the method +class ListUsableSubnetworksRequest(proto.Message): + r"""A request message for Subnetworks.ListUsable. See the method description for details. - Attributes: - global_set_labels_request_resource (google.cloud.compute_v1.types.GlobalSetLabelsRequest): - The body resource for this request - project (str): - Project ID for this request. - resource (str): - Name or id of the resource for this request. - """ - - global_set_labels_request_resource = proto.Field( - proto.MESSAGE, number=319917189, message="GlobalSetLabelsRequest", - ) - project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) - - -class TestIamPermissionsImageRequest(proto.Message): - r"""A request message for Images.TestIamPermissions. See the - method description for details. - - Attributes: - project (str): - Project ID for this request. - resource (str): - Name or id of the resource for this request. - test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): - The body resource for this request - """ - - project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) - test_permissions_request_resource = proto.Field( - proto.MESSAGE, number=439214758, message="TestPermissionsRequest", - ) - - -class AbandonInstancesInstanceGroupManagerRequest(proto.Message): - r"""A request message for InstanceGroupManagers.AbandonInstances. - See the method description for details. - - Attributes: - instance_group_manager (str): - The name of the managed instance group. - instance_group_managers_abandon_instances_request_resource (google.cloud.compute_v1.types.InstanceGroupManagersAbandonInstancesRequest): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone where the managed - instance group is located. - """ - - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - instance_group_managers_abandon_instances_request_resource = proto.Field( - proto.MESSAGE, - number=320929016, - message="InstanceGroupManagersAbandonInstancesRequest", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - - -class AggregatedListInstanceGroupManagersRequest(proto.Message): - r"""A request message for InstanceGroupManagers.AggregatedList. - See the method description for details. - Attributes: filter (str): A filter expression that filters resources listed in the @@ -30943,36 +29704,21 @@ class AggregatedListInstanceGroupManagersRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions explicitly. For example: ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. max_results (int): The maximum number of results per page that should be returned. If the number of available results is larger than @@ -30983,17 +29729,13 @@ class AggregatedListInstanceGroupManagersRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -31008,7 +29750,6 @@ class AggregatedListInstanceGroupManagersRequest(proto.Message): """ filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) order_by = proto.Field(proto.STRING, number=160562920, optional=True,) page_token = proto.Field(proto.STRING, number=19994697, optional=True,) @@ -31016,249 +29757,77 @@ class AggregatedListInstanceGroupManagersRequest(proto.Message): return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class ApplyUpdatesToInstancesInstanceGroupManagerRequest(proto.Message): - r"""A request message for - InstanceGroupManagers.ApplyUpdatesToInstances. See the method +class ListVpnGatewaysRequest(proto.Message): + r"""A request message for VpnGateways.List. See the method description for details. Attributes: - instance_group_manager (str): - The name of the managed instance group, - should conform to RFC1035. - instance_group_managers_apply_updates_request_resource (google.cloud.compute_v1.types.InstanceGroupManagersApplyUpdatesRequest): - The body resource for this request - project (str): - Project ID for this request. - zone (str): - The name of the zone where the managed - instance group is located. Should conform to - RFC1035. - """ - - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - instance_group_managers_apply_updates_request_resource = proto.Field( - proto.MESSAGE, - number=259242835, - message="InstanceGroupManagersApplyUpdatesRequest", - ) - project = proto.Field(proto.STRING, number=227560217,) - zone = proto.Field(proto.STRING, number=3744684,) - - -class CreateInstancesInstanceGroupManagerRequest(proto.Message): - r"""A request message for InstanceGroupManagers.CreateInstances. - See the method description for details. - - Attributes: - instance_group_manager (str): - The name of the managed instance group. It - should conform to RFC1035. - instance_group_managers_create_instances_request_resource (google.cloud.compute_v1.types.InstanceGroupManagersCreateInstancesRequest): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone where the managed - instance group is located. It should conform to - RFC1035. - """ - - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - instance_group_managers_create_instances_request_resource = proto.Field( - proto.MESSAGE, - number=24558867, - message="InstanceGroupManagersCreateInstancesRequest", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - - -class DeleteInstanceGroupManagerRequest(proto.Message): - r"""A request message for InstanceGroupManagers.Delete. See the - method description for details. - - Attributes: - instance_group_manager (str): - The name of the managed instance group to - delete. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone where the managed - instance group is located. - """ - - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - - -class DeleteInstancesInstanceGroupManagerRequest(proto.Message): - r"""A request message for InstanceGroupManagers.DeleteInstances. - See the method description for details. - - Attributes: - instance_group_manager (str): - The name of the managed instance group. - instance_group_managers_delete_instances_request_resource (google.cloud.compute_v1.types.InstanceGroupManagersDeleteInstancesRequest): - The body resource for this request + filter (str): + A filter expression that filters resources listed in the + response. The expression must specify the field name, a + comparison operator, and the value that you want to use for + filtering. The value must be a string, a number, or a + boolean. The comparison operator must be either ``=``, + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: + ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` + By default, each expression is an ``AND`` expression. + However, you can include ``AND`` and ``OR`` expressions + explicitly. For example: + ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` + max_results (int): + The maximum number of results per page that should be + returned. If the number of available results is larger than + ``maxResults``, Compute Engine returns a ``nextPageToken`` + that can be used to get the next page of results in + subsequent list requests. Acceptable values are ``0`` to + ``500``, inclusive. (Default: ``500``) + order_by (str): + Sorts list results by a certain order. By default, results + are returned in alphanumerical order based on the resource + name. You can also sort results in descending order based on + the creation timestamp using + ``orderBy="creationTimestamp desc"``. This sorts results + based on the ``creationTimestamp`` field in reverse + chronological order (newest result first). Use this to sort + resources like operations so that the newest operation is + returned first. Currently, only sorting by ``name`` or + ``creationTimestamp desc`` is supported. + page_token (str): + Specifies a page token to use. Set ``pageToken`` to the + ``nextPageToken`` returned by a previous list request to get + the next page of results. project (str): Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone where the managed - instance group is located. + region (str): + Name of the region for this request. + return_partial_success (bool): + Opt-in for partial success behavior which + provides partial results in case of failure. The + default value is false. """ - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - instance_group_managers_delete_instances_request_resource = proto.Field( - proto.MESSAGE, - number=166421252, - message="InstanceGroupManagersDeleteInstancesRequest", - ) + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + region = proto.Field(proto.STRING, number=138946292,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class DeletePerInstanceConfigsInstanceGroupManagerRequest(proto.Message): - r"""A request message for - InstanceGroupManagers.DeletePerInstanceConfigs. See the method +class ListVpnTunnelsRequest(proto.Message): + r"""A request message for VpnTunnels.List. See the method description for details. - Attributes: - instance_group_manager (str): - The name of the managed instance group. It - should conform to RFC1035. - instance_group_managers_delete_per_instance_configs_req_resource (google.cloud.compute_v1.types.InstanceGroupManagersDeletePerInstanceConfigsReq): - The body resource for this request - project (str): - Project ID for this request. - zone (str): - The name of the zone where the managed - instance group is located. It should conform to - RFC1035. - """ - - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - instance_group_managers_delete_per_instance_configs_req_resource = proto.Field( - proto.MESSAGE, - number=362427680, - message="InstanceGroupManagersDeletePerInstanceConfigsReq", - ) - project = proto.Field(proto.STRING, number=227560217,) - zone = proto.Field(proto.STRING, number=3744684,) - - -class GetInstanceGroupManagerRequest(proto.Message): - r"""A request message for InstanceGroupManagers.Get. See the - method description for details. - - Attributes: - instance_group_manager (str): - The name of the managed instance group. - project (str): - Project ID for this request. - zone (str): - The name of the zone where the managed - instance group is located. - """ - - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - project = proto.Field(proto.STRING, number=227560217,) - zone = proto.Field(proto.STRING, number=3744684,) - - -class InsertInstanceGroupManagerRequest(proto.Message): - r"""A request message for InstanceGroupManagers.Insert. See the - method description for details. - - Attributes: - instance_group_manager_resource (google.cloud.compute_v1.types.InstanceGroupManager): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone where you want to create - the managed instance group. - """ - - instance_group_manager_resource = proto.Field( - proto.MESSAGE, number=261063946, message="InstanceGroupManager", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - - -class ListInstanceGroupManagersRequest(proto.Message): - r"""A request message for InstanceGroupManagers.List. See the - method description for details. - Attributes: filter (str): A filter expression that filters resources listed in the @@ -31266,20 +29835,16 @@ class ListInstanceGroupManagersRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions @@ -31295,17 +29860,13 @@ class ListInstanceGroupManagersRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -31313,13 +29874,12 @@ class ListInstanceGroupManagersRequest(proto.Message): the next page of results. project (str): Project ID for this request. + region (str): + Name of the region for this request. return_partial_success (bool): Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. - zone (str): - The name of the zone where the managed - instance group is located. """ filter = proto.Field(proto.STRING, number=336120696, optional=True,) @@ -31327,13 +29887,13 @@ class ListInstanceGroupManagersRequest(proto.Message): order_by = proto.Field(proto.STRING, number=160562920, optional=True,) page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) -class ListErrorsInstanceGroupManagersRequest(proto.Message): - r"""A request message for InstanceGroupManagers.ListErrors. See - the method description for details. +class ListXpnHostsProjectsRequest(proto.Message): + r"""A request message for Projects.ListXpnHosts. See the method + description for details. Attributes: filter (str): @@ -31342,30 +29902,21 @@ class ListErrorsInstanceGroupManagersRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions explicitly. For example: ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - instance_group_manager (str): - The name of the managed instance group. It must be a string - that meets the requirements in RFC1035, or an unsigned long - integer: must match regexp pattern: - (?:`a-z `__?)|[1-9][0-9]{0,19}. max_results (int): The maximum number of results per page that should be returned. If the number of available results is larger than @@ -31376,17 +29927,13 @@ class ListErrorsInstanceGroupManagersRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -31394,29 +29941,27 @@ class ListErrorsInstanceGroupManagersRequest(proto.Message): the next page of results. project (str): Project ID for this request. + projects_list_xpn_hosts_request_resource (google.cloud.compute_v1.types.ProjectsListXpnHostsRequest): + The body resource for this request return_partial_success (bool): Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. - zone (str): - The name of the zone where the managed - instance group is located. It should conform to - RFC1035. """ filter = proto.Field(proto.STRING, number=336120696, optional=True,) - instance_group_manager = proto.Field(proto.STRING, number=249363395,) max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) order_by = proto.Field(proto.STRING, number=160562920, optional=True,) page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) + projects_list_xpn_hosts_request_resource = proto.Field( + proto.MESSAGE, number=238266391, message="ProjectsListXpnHostsRequest", + ) return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) -class ListManagedInstancesInstanceGroupManagersRequest(proto.Message): - r"""A request message for - InstanceGroupManagers.ListManagedInstances. See the method +class ListZoneOperationsRequest(proto.Message): + r"""A request message for ZoneOperations.List. See the method description for details. Attributes: @@ -31426,27 +29971,21 @@ class ListManagedInstancesInstanceGroupManagersRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions explicitly. For example: ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - instance_group_manager (str): - The name of the managed instance group. max_results (int): The maximum number of results per page that should be returned. If the number of available results is larger than @@ -31457,17 +29996,13 @@ class ListManagedInstancesInstanceGroupManagersRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -31480,12 +30015,10 @@ class ListManagedInstancesInstanceGroupManagersRequest(proto.Message): provides partial results in case of failure. The default value is false. zone (str): - The name of the zone where the managed - instance group is located. + Name of the zone for request. """ filter = proto.Field(proto.STRING, number=336120696, optional=True,) - instance_group_manager = proto.Field(proto.STRING, number=249363395,) max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) order_by = proto.Field(proto.STRING, number=160562920, optional=True,) page_token = proto.Field(proto.STRING, number=19994697, optional=True,) @@ -31494,10 +30027,9 @@ class ListManagedInstancesInstanceGroupManagersRequest(proto.Message): zone = proto.Field(proto.STRING, number=3744684,) -class ListPerInstanceConfigsInstanceGroupManagersRequest(proto.Message): - r"""A request message for - InstanceGroupManagers.ListPerInstanceConfigs. See the method - description for details. +class ListZonesRequest(proto.Message): + r"""A request message for Zones.List. See the method description + for details. Attributes: filter (str): @@ -31506,28 +30038,21 @@ class ListPerInstanceConfigsInstanceGroupManagersRequest(proto.Message): comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: + ``!=``, ``>``, or ``<``. For example, if you are filtering + Compute Engine instances, you can exclude instances named + ``example-instance`` by specifying + ``name != example-instance``. You can also filter nested + fields. For example, you could specify + ``scheduling.automaticRestart = false`` to include instances + only if they are not scheduled for automatic restarts. You + can use filtering on nested fields to filter based on + resource labels. To filter on multiple expressions, provide + each separate expression within parentheses. For example: ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` By default, each expression is an ``AND`` expression. However, you can include ``AND`` and ``OR`` expressions explicitly. For example: ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - instance_group_manager (str): - The name of the managed instance group. It - should conform to RFC1035. max_results (int): The maximum number of results per page that should be returned. If the number of available results is larger than @@ -31538,17 +30063,13 @@ class ListPerInstanceConfigsInstanceGroupManagersRequest(proto.Message): order_by (str): Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using + name. You can also sort results in descending order based on + the creation timestamp using ``orderBy="creationTimestamp desc"``. This sorts results based on the ``creationTimestamp`` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or + returned first. Currently, only sorting by ``name`` or ``creationTimestamp desc`` is supported. page_token (str): Specifies a page token to use. Set ``pageToken`` to the @@ -31560,118 +30081,660 @@ class ListPerInstanceConfigsInstanceGroupManagersRequest(proto.Message): Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. + """ + + filter = proto.Field(proto.STRING, number=336120696, optional=True,) + max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) + order_by = proto.Field(proto.STRING, number=160562920, optional=True,) + page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + project = proto.Field(proto.STRING, number=227560217,) + return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + + +class LocalDisk(proto.Message): + r""" + Attributes: + disk_count (int): + Specifies the number of such disks. + disk_size_gb (int): + Specifies the size of the disk in base-2 GB. + disk_type (str): + Specifies the desired disk type on the node. + This disk type must be a local storage type + (e.g.: local-ssd). Note that for nodeTemplates, + this should be the name of the disk type and not + its URL. + """ + + disk_count = proto.Field(proto.INT32, number=182933485, optional=True,) + disk_size_gb = proto.Field(proto.INT32, number=316263735, optional=True,) + disk_type = proto.Field(proto.STRING, number=93009052, optional=True,) + + +class LocationPolicy(proto.Message): + r"""Configuration for location policy among multiple possible + locations (e.g. preferences for zone selection among zones in a + single region). + + Attributes: + locations (Sequence[google.cloud.compute_v1.types.LocationPolicy.LocationsEntry]): + Location configurations mapped by location + name. Currently only zone names are supported + and must be represented as valid internal URLs, + such as zones/us-central1-a. + """ + + locations = proto.MapField( + proto.STRING, proto.MESSAGE, number=413423454, message="LocationPolicyLocation", + ) + + +class LocationPolicyLocation(proto.Message): + r""" + Attributes: + preference (google.cloud.compute_v1.types.LocationPolicyLocation.Preference): + Preference for a given location: ALLOW or + DENY. + """ + + class Preference(proto.Enum): + r"""Preference for a given location: ALLOW or DENY.""" + UNDEFINED_PREFERENCE = 0 + ALLOW = 62368553 + DENY = 2094604 + PREFERENCE_UNSPECIFIED = 496219571 + + preference = proto.Field( + proto.ENUM, number=150781147, optional=True, enum=Preference, + ) + + +class LogConfig(proto.Message): + r"""This is deprecated and has no effect. Do not use. + Attributes: + cloud_audit (google.cloud.compute_v1.types.LogConfigCloudAuditOptions): + This is deprecated and has no effect. Do not + use. + counter (google.cloud.compute_v1.types.LogConfigCounterOptions): + This is deprecated and has no effect. Do not + use. + data_access (google.cloud.compute_v1.types.LogConfigDataAccessOptions): + This is deprecated and has no effect. Do not + use. + """ + + cloud_audit = proto.Field( + proto.MESSAGE, + number=412852561, + optional=True, + message="LogConfigCloudAuditOptions", + ) + counter = proto.Field( + proto.MESSAGE, + number=420959740, + optional=True, + message="LogConfigCounterOptions", + ) + data_access = proto.Field( + proto.MESSAGE, + number=286633881, + optional=True, + message="LogConfigDataAccessOptions", + ) + + +class LogConfigCloudAuditOptions(proto.Message): + r"""This is deprecated and has no effect. Do not use. + Attributes: + authorization_logging_options (google.cloud.compute_v1.types.AuthorizationLoggingOptions): + This is deprecated and has no effect. Do not + use. + log_name (google.cloud.compute_v1.types.LogConfigCloudAuditOptions.LogName): + This is deprecated and has no effect. Do not + use. + """ + + class LogName(proto.Enum): + r"""This is deprecated and has no effect. Do not use.""" + UNDEFINED_LOG_NAME = 0 + ADMIN_ACTIVITY = 427503135 + DATA_ACCESS = 238070681 + UNSPECIFIED_LOG_NAME = 410515182 + + authorization_logging_options = proto.Field( + proto.MESSAGE, + number=217861624, + optional=True, + message="AuthorizationLoggingOptions", + ) + log_name = proto.Field(proto.ENUM, number=402913958, optional=True, enum=LogName,) + + +class LogConfigCounterOptions(proto.Message): + r"""This is deprecated and has no effect. Do not use. + Attributes: + custom_fields (Sequence[google.cloud.compute_v1.types.LogConfigCounterOptionsCustomField]): + This is deprecated and has no effect. Do not + use. + field (str): + This is deprecated and has no effect. Do not + use. + metric (str): + This is deprecated and has no effect. Do not + use. + """ + + custom_fields = proto.RepeatedField( + proto.MESSAGE, number=249651015, message="LogConfigCounterOptionsCustomField", + ) + field = proto.Field(proto.STRING, number=97427706, optional=True,) + metric = proto.Field(proto.STRING, number=533067184, optional=True,) + + +class LogConfigCounterOptionsCustomField(proto.Message): + r"""This is deprecated and has no effect. Do not use. + Attributes: + name (str): + This is deprecated and has no effect. Do not + use. + value (str): + This is deprecated and has no effect. Do not + use. + """ + + name = proto.Field(proto.STRING, number=3373707, optional=True,) + value = proto.Field(proto.STRING, number=111972721, optional=True,) + + +class LogConfigDataAccessOptions(proto.Message): + r"""This is deprecated and has no effect. Do not use. + Attributes: + log_mode (google.cloud.compute_v1.types.LogConfigDataAccessOptions.LogMode): + This is deprecated and has no effect. Do not + use. + """ + + class LogMode(proto.Enum): + r"""This is deprecated and has no effect. Do not use.""" + UNDEFINED_LOG_MODE = 0 + LOG_FAIL_CLOSED = 360469778 + LOG_MODE_UNSPECIFIED = 88160822 + + log_mode = proto.Field(proto.ENUM, number=402897342, optional=True, enum=LogMode,) + + +class MachineType(proto.Message): + r"""Represents a Machine Type resource. You can use specific + machine types for your VM instances based on performance and + pricing requirements. For more information, read Machine Types. + + Attributes: + accelerators (Sequence[google.cloud.compute_v1.types.Accelerators]): + [Output Only] A list of accelerator configurations assigned + to this machine type. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + deprecated (google.cloud.compute_v1.types.DeprecationStatus): + [Output Only] The deprecation status associated with this + machine type. Only applicable if the machine type is + unavailable. + description (str): + [Output Only] An optional textual description of the + resource. + guest_cpus (int): + [Output Only] The number of virtual CPUs that are available + to the instance. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + image_space_gb (int): + [Deprecated] This property is deprecated and will never be + populated with any relevant values. + is_shared_cpu (bool): + [Output Only] Whether this machine type has a shared CPU. + See Shared-core machine types for more information. + kind (str): + [Output Only] The type of the resource. Always + compute#machineType for machine types. + maximum_persistent_disks (int): + [Output Only] Maximum persistent disks allowed. + maximum_persistent_disks_size_gb (int): + [Output Only] Maximum total persistent disks size (GB) + allowed. + memory_mb (int): + [Output Only] The amount of physical memory available to the + instance, defined in MB. + name (str): + [Output Only] Name of the resource. + scratch_disks (Sequence[google.cloud.compute_v1.types.ScratchDisks]): + [Output Only] A list of extended scratch disks assigned to + the instance. + self_link (str): + [Output Only] Server-defined URL for the resource. zone (str): - The name of the zone where the managed - instance group is located. It should conform to - RFC1035. + [Output Only] The name of the zone where the machine type + resides, such as us-central1-a. + """ + + accelerators = proto.RepeatedField( + proto.MESSAGE, number=269577064, message="Accelerators", + ) + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + deprecated = proto.Field( + proto.MESSAGE, number=515138995, optional=True, message="DeprecationStatus", + ) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + guest_cpus = proto.Field(proto.INT32, number=393356754, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + image_space_gb = proto.Field(proto.INT32, number=75331864, optional=True,) + is_shared_cpu = proto.Field(proto.BOOL, number=521399555, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + maximum_persistent_disks = proto.Field( + proto.INT32, number=496220941, optional=True, + ) + maximum_persistent_disks_size_gb = proto.Field( + proto.INT64, number=154274471, optional=True, + ) + memory_mb = proto.Field(proto.INT32, number=116001171, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + scratch_disks = proto.RepeatedField( + proto.MESSAGE, number=480778481, message="ScratchDisks", + ) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + zone = proto.Field(proto.STRING, number=3744684, optional=True,) + + +class MachineTypeAggregatedList(proto.Message): + r""" + Attributes: + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.MachineTypeAggregatedList.ItemsEntry]): + A list of MachineTypesScopedList resources. + kind (str): + [Output Only] Type of resource. Always + compute#machineTypeAggregatedList for aggregated lists of + machine types. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. + """ + + @property + def raw_page(self): + return self + + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.MapField( + proto.STRING, proto.MESSAGE, number=100526016, message="MachineTypesScopedList", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) + + +class MachineTypeList(proto.Message): + r"""Contains a list of machine types. + Attributes: + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.MachineType]): + A list of MachineType resources. + kind (str): + [Output Only] Type of resource. Always + compute#machineTypeList for lists of machine types. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. + """ + + @property + def raw_page(self): + return self + + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="MachineType",) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) + + +class MachineTypesScopedList(proto.Message): + r""" + Attributes: + machine_types (Sequence[google.cloud.compute_v1.types.MachineType]): + [Output Only] A list of machine types contained in this + scope. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] An informational warning that appears when the + machine types list is empty. + """ + + machine_types = proto.RepeatedField( + proto.MESSAGE, number=79720065, message="MachineType", + ) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) + + +class ManagedInstance(proto.Message): + r"""A Managed Instance resource. + Attributes: + current_action (google.cloud.compute_v1.types.ManagedInstance.CurrentAction): + [Output Only] The current action that the managed instance + group has scheduled for the instance. Possible values: - + NONE The instance is running, and the managed instance group + does not have any scheduled actions for this instance. - + CREATING The managed instance group is creating this + instance. If the group fails to create this instance, it + will try again until it is successful. - + CREATING_WITHOUT_RETRIES The managed instance group is + attempting to create this instance only once. If the group + fails to create this instance, it does not try again and the + group's targetSize value is decreased instead. - RECREATING + The managed instance group is recreating this instance. - + DELETING The managed instance group is permanently deleting + this instance. - ABANDONING The managed instance group is + abandoning this instance. The instance will be removed from + the instance group and from any target pools that are + associated with this group. - RESTARTING The managed + instance group is restarting the instance. - REFRESHING The + managed instance group is applying configuration changes to + the instance without stopping it. For example, the group can + update the target pool list for an instance without stopping + that instance. - VERIFYING The managed instance group has + created the instance and it is in the process of being + verified. + id (int): + [Output only] The unique identifier for this resource. This + field is empty when instance does not exist. + instance (str): + [Output Only] The URL of the instance. The URL can exist + even if the instance has not yet been created. + instance_health (Sequence[google.cloud.compute_v1.types.ManagedInstanceInstanceHealth]): + [Output Only] Health state of the instance per health-check. + instance_status (google.cloud.compute_v1.types.ManagedInstance.InstanceStatus): + [Output Only] The status of the instance. This field is + empty when the instance does not exist. + last_attempt (google.cloud.compute_v1.types.ManagedInstanceLastAttempt): + [Output Only] Information about the last attempt to create + or delete the instance. + preserved_state_from_config (google.cloud.compute_v1.types.PreservedState): + [Output Only] Preserved state applied from per-instance + config for this instance. + preserved_state_from_policy (google.cloud.compute_v1.types.PreservedState): + [Output Only] Preserved state generated based on stateful + policy for this instance. + version (google.cloud.compute_v1.types.ManagedInstanceVersion): + [Output Only] Intended version of this instance. + """ + + class CurrentAction(proto.Enum): + r"""[Output Only] The current action that the managed instance group has + scheduled for the instance. Possible values: - NONE The instance is + running, and the managed instance group does not have any scheduled + actions for this instance. - CREATING The managed instance group is + creating this instance. If the group fails to create this instance, + it will try again until it is successful. - CREATING_WITHOUT_RETRIES + The managed instance group is attempting to create this instance + only once. If the group fails to create this instance, it does not + try again and the group's targetSize value is decreased instead. - + RECREATING The managed instance group is recreating this instance. - + DELETING The managed instance group is permanently deleting this + instance. - ABANDONING The managed instance group is abandoning this + instance. The instance will be removed from the instance group and + from any target pools that are associated with this group. - + RESTARTING The managed instance group is restarting the instance. - + REFRESHING The managed instance group is applying configuration + changes to the instance without stopping it. For example, the group + can update the target pool list for an instance without stopping + that instance. - VERIFYING The managed instance group has created + the instance and it is in the process of being verified. + """ + UNDEFINED_CURRENT_ACTION = 0 + ABANDONING = 388244813 + CREATING = 455564985 + CREATING_WITHOUT_RETRIES = 428843785 + DELETING = 528602024 + NONE = 2402104 + RECREATING = 287278572 + REFRESHING = 163266343 + RESTARTING = 320534387 + VERIFYING = 16982185 + + class InstanceStatus(proto.Enum): + r"""[Output Only] The status of the instance. This field is empty when + the instance does not exist. + """ + UNDEFINED_INSTANCE_STATUS = 0 + DEPROVISIONING = 428935662 + PROVISIONING = 290896621 + REPAIRING = 413483285 + RUNNING = 121282975 + STAGING = 431072283 + STOPPED = 444276141 + STOPPING = 350791796 + SUSPENDED = 51223995 + SUSPENDING = 514206246 + TERMINATED = 250018339 + + current_action = proto.Field( + proto.ENUM, number=178475964, optional=True, enum=CurrentAction, + ) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + instance = proto.Field(proto.STRING, number=18257045, optional=True,) + instance_health = proto.RepeatedField( + proto.MESSAGE, number=382667078, message="ManagedInstanceInstanceHealth", + ) + instance_status = proto.Field( + proto.ENUM, number=174577372, optional=True, enum=InstanceStatus, + ) + last_attempt = proto.Field( + proto.MESSAGE, + number=434771492, + optional=True, + message="ManagedInstanceLastAttempt", + ) + preserved_state_from_config = proto.Field( + proto.MESSAGE, number=98661858, optional=True, message="PreservedState", + ) + preserved_state_from_policy = proto.Field( + proto.MESSAGE, number=470783954, optional=True, message="PreservedState", + ) + version = proto.Field( + proto.MESSAGE, + number=351608024, + optional=True, + message="ManagedInstanceVersion", + ) + + +class ManagedInstanceInstanceHealth(proto.Message): + r""" + Attributes: + detailed_health_state (google.cloud.compute_v1.types.ManagedInstanceInstanceHealth.DetailedHealthState): + [Output Only] The current detailed instance health state. + health_check (str): + [Output Only] The URL for the health check that verifies + whether the instance is healthy. + """ + + class DetailedHealthState(proto.Enum): + r"""[Output Only] The current detailed instance health state.""" + UNDEFINED_DETAILED_HEALTH_STATE = 0 + DRAINING = 480455402 + HEALTHY = 439801213 + TIMEOUT = 477813057 + UNHEALTHY = 462118084 + UNKNOWN = 433141802 + + detailed_health_state = proto.Field( + proto.ENUM, number=510470173, optional=True, enum=DetailedHealthState, + ) + health_check = proto.Field(proto.STRING, number=308876645, optional=True,) + + +class ManagedInstanceLastAttempt(proto.Message): + r""" + Attributes: + errors (google.cloud.compute_v1.types.Errors): + [Output Only] Encountered errors during the last attempt to + create or delete the instance. + """ + + errors = proto.Field( + proto.MESSAGE, number=315977579, optional=True, message="Errors", + ) + + +class ManagedInstanceVersion(proto.Message): + r""" + Attributes: + instance_template (str): + [Output Only] The intended template of the instance. This + field is empty when current_action is one of { DELETING, + ABANDONING }. + name (str): + [Output Only] Name of the version. + """ + + instance_template = proto.Field(proto.STRING, number=309248228, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + + +class Metadata(proto.Message): + r"""A metadata key/value entry. + Attributes: + fingerprint (str): + Specifies a fingerprint for this request, + which is essentially a hash of the metadata's + contents and used for optimistic locking. The + fingerprint is initially generated by Compute + Engine and changes after every request to modify + or update metadata. You must always provide an + up-to-date fingerprint hash in order to update + or change metadata, otherwise the request will + fail with error 412 conditionNotMet. To see the + latest fingerprint, make a get() request to + retrieve the resource. + items (Sequence[google.cloud.compute_v1.types.Items]): + Array of key/value pairs. The total size of + all keys and values must be less than 512 KB. + kind (str): + [Output Only] Type of the resource. Always compute#metadata + for metadata. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Items",) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) -class PatchInstanceGroupManagerRequest(proto.Message): - r"""A request message for InstanceGroupManagers.Patch. See the - method description for details. +class MetadataFilter(proto.Message): + r"""Opaque filter criteria used by loadbalancers to restrict routing + configuration to a limited set of loadbalancing proxies. Proxies and + sidecars involved in loadbalancing would typically present metadata + to the loadbalancers which need to match criteria specified here. If + a match takes place, the relevant configuration is made available to + those proxies. For each metadataFilter in this list, if its + filterMatchCriteria is set to MATCH_ANY, at least one of the + filterLabels must match the corresponding label provided in the + metadata. If its filterMatchCriteria is set to MATCH_ALL, then all + of its filterLabels must match with corresponding labels provided in + the metadata. An example for using metadataFilters would be: if + loadbalancing involves Envoys, they will only receive routing + configuration when values in metadataFilters match values supplied + in of their XDS requests to loadbalancers. Attributes: - instance_group_manager (str): - The name of the instance group manager. - instance_group_manager_resource (google.cloud.compute_v1.types.InstanceGroupManager): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone where you want to create - the managed instance group. + filter_labels (Sequence[google.cloud.compute_v1.types.MetadataFilterLabelMatch]): + The list of label value pairs that must match + labels in the provided metadata based on + filterMatchCriteria This list must not be empty + and can have at the most 64 entries. + filter_match_criteria (google.cloud.compute_v1.types.MetadataFilter.FilterMatchCriteria): + Specifies how individual filterLabel matches within the list + of filterLabels contribute towards the overall + metadataFilter match. Supported values are: - MATCH_ANY: At + least one of the filterLabels must have a matching label in + the provided metadata. - MATCH_ALL: All filterLabels must + have matching labels in the provided metadata. """ - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - instance_group_manager_resource = proto.Field( - proto.MESSAGE, number=261063946, message="InstanceGroupManager", + class FilterMatchCriteria(proto.Enum): + r"""Specifies how individual filterLabel matches within the list of + filterLabels contribute towards the overall metadataFilter match. + Supported values are: - MATCH_ANY: At least one of the filterLabels + must have a matching label in the provided metadata. - MATCH_ALL: + All filterLabels must have matching labels in the provided metadata. + """ + UNDEFINED_FILTER_MATCH_CRITERIA = 0 + MATCH_ALL = 180663271 + MATCH_ANY = 180663346 + NOT_SET = 163646646 + + filter_labels = proto.RepeatedField( + proto.MESSAGE, number=307903142, message="MetadataFilterLabelMatch", + ) + filter_match_criteria = proto.Field( + proto.ENUM, number=239970368, optional=True, enum=FilterMatchCriteria, ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) -class PatchPerInstanceConfigsInstanceGroupManagerRequest(proto.Message): - r"""A request message for - InstanceGroupManagers.PatchPerInstanceConfigs. See the method - description for details. +class MetadataFilterLabelMatch(proto.Message): + r"""MetadataFilter label name value pairs that are expected to + match corresponding labels presented as metadata to the + loadbalancer. Attributes: - instance_group_manager (str): - The name of the managed instance group. It - should conform to RFC1035. - instance_group_managers_patch_per_instance_configs_req_resource (google.cloud.compute_v1.types.InstanceGroupManagersPatchPerInstanceConfigsReq): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone where the managed - instance group is located. It should conform to - RFC1035. + name (str): + Name of metadata label. The name can have a + maximum length of 1024 characters and must be at + least 1 character long. + value (str): + The value of the label must match the + specified value. value can have a maximum length + of 1024 characters. """ - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - instance_group_managers_patch_per_instance_configs_req_resource = proto.Field( - proto.MESSAGE, - number=356650495, - message="InstanceGroupManagersPatchPerInstanceConfigsReq", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + value = proto.Field(proto.STRING, number=111972721, optional=True,) -class RecreateInstancesInstanceGroupManagerRequest(proto.Message): - r"""A request message for - InstanceGroupManagers.RecreateInstances. See the method +class MoveDiskProjectRequest(proto.Message): + r"""A request message for Projects.MoveDisk. See the method description for details. Attributes: - instance_group_manager (str): - The name of the managed instance group. - instance_group_managers_recreate_instances_request_resource (google.cloud.compute_v1.types.InstanceGroupManagersRecreateInstancesRequest): + disk_move_request_resource (google.cloud.compute_v1.types.DiskMoveRequest): The body resource for this request project (str): Project ID for this request. @@ -31680,85 +30743,64 @@ class RecreateInstancesInstanceGroupManagerRequest(proto.Message): Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone where the managed - instance group is located. + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - instance_group_managers_recreate_instances_request_resource = proto.Field( - proto.MESSAGE, - number=21405952, - message="InstanceGroupManagersRecreateInstancesRequest", + disk_move_request_resource = proto.Field( + proto.MESSAGE, number=313008458, message="DiskMoveRequest", ) project = proto.Field(proto.STRING, number=227560217,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) -class ResizeInstanceGroupManagerRequest(proto.Message): - r"""A request message for InstanceGroupManagers.Resize. See the - method description for details. +class MoveFirewallPolicyRequest(proto.Message): + r"""A request message for FirewallPolicies.Move. See the method + description for details. Attributes: - instance_group_manager (str): - The name of the managed instance group. - project (str): - Project ID for this request. + firewall_policy (str): + Name of the firewall policy to update. + parent_id (str): + The new parent of the firewall policy. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - size (int): - The number of running instances that the - managed instance group should maintain at any - given time. The group automatically adds or - removes instances to maintain the number of - instances specified by this parameter. - zone (str): - The name of the zone where the managed - instance group is located. + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - project = proto.Field(proto.STRING, number=227560217,) + firewall_policy = proto.Field(proto.STRING, number=498173265,) + parent_id = proto.Field(proto.STRING, number=459714768, optional=True,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - size = proto.Field(proto.INT32, number=3530753,) - zone = proto.Field(proto.STRING, number=3744684,) -class SetInstanceTemplateInstanceGroupManagerRequest(proto.Message): - r"""A request message for - InstanceGroupManagers.SetInstanceTemplate. See the method +class MoveInstanceProjectRequest(proto.Message): + r"""A request message for Projects.MoveInstance. See the method description for details. Attributes: - instance_group_manager (str): - The name of the managed instance group. - instance_group_managers_set_instance_template_request_resource (google.cloud.compute_v1.types.InstanceGroupManagersSetInstanceTemplateRequest): + instance_move_request_resource (google.cloud.compute_v1.types.InstanceMoveRequest): The body resource for this request project (str): Project ID for this request. @@ -31767,2721 +30809,2830 @@ class SetInstanceTemplateInstanceGroupManagerRequest(proto.Message): Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone where the managed - instance group is located. + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - instance_group_managers_set_instance_template_request_resource = proto.Field( - proto.MESSAGE, - number=9809093, - message="InstanceGroupManagersSetInstanceTemplateRequest", + instance_move_request_resource = proto.Field( + proto.MESSAGE, number=311664194, message="InstanceMoveRequest", ) project = proto.Field(proto.STRING, number=227560217,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - -class SetTargetPoolsInstanceGroupManagerRequest(proto.Message): - r"""A request message for InstanceGroupManagers.SetTargetPools. - See the method description for details. +class NamedPort(proto.Message): + r"""The named port. For example: <"http", 80>. Attributes: - instance_group_manager (str): - The name of the managed instance group. - instance_group_managers_set_target_pools_request_resource (google.cloud.compute_v1.types.InstanceGroupManagersSetTargetPoolsRequest): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone where the managed - instance group is located. + name (str): + The name for this named port. The name must + be 1-63 characters long, and comply with + RFC1035. + port (int): + The port number, which can be a value between + 1 and 65535. """ - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - instance_group_managers_set_target_pools_request_resource = proto.Field( - proto.MESSAGE, - number=281150216, - message="InstanceGroupManagersSetTargetPoolsRequest", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + port = proto.Field(proto.INT32, number=3446913, optional=True,) -class UpdatePerInstanceConfigsInstanceGroupManagerRequest(proto.Message): - r"""A request message for - InstanceGroupManagers.UpdatePerInstanceConfigs. See the method - description for details. +class Network(proto.Message): + r"""Represents a VPC Network resource. Networks connect resources + to each other and to the internet. For more information, read + Virtual Private Cloud (VPC) Network. Attributes: - instance_group_manager (str): - The name of the managed instance group. It - should conform to RFC1035. - instance_group_managers_update_per_instance_configs_req_resource (google.cloud.compute_v1.types.InstanceGroupManagersUpdatePerInstanceConfigsReq): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone where the managed - instance group is located. It should conform to - RFC1035. + I_pv4_range (str): + Deprecated in favor of subnet mode networks. + The range of internal addresses that are legal + on this network. This range is a CIDR + specification, for example: 192.168.0.0/16. + Provided by the client when the network is + created. + auto_create_subnetworks (bool): + Must be set to create a VPC network. If not + set, a legacy network is created. When set to + true, the VPC network is created in auto mode. + When set to false, the VPC network is created in + custom mode. An auto mode VPC network starts + with one subnet per region. Each subnet has a + predetermined range as described in Auto mode + VPC network IP ranges. For custom mode VPC + networks, you can add subnets using the + subnetworks insert method. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + An optional description of this resource. + Provide this field when you create the resource. + gateway_i_pv4 (str): + [Output Only] The gateway address for default routing out of + the network, selected by GCP. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + kind (str): + [Output Only] Type of the resource. Always compute#network + for networks. + mtu (int): + Maximum Transmission Unit in bytes. The + minimum value for this field is 1460 and the + maximum value is 1500 bytes. If unspecified, + defaults to 1460. + name (str): + Name of the resource. Provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?``. The first character must be + a lowercase letter, and all following characters (except for + the last character) must be a dash, lowercase letter, or + digit. The last character must be a lowercase letter or + digit. + peerings (Sequence[google.cloud.compute_v1.types.NetworkPeering]): + [Output Only] A list of network peerings for the resource. + routing_config (google.cloud.compute_v1.types.NetworkRoutingConfig): + The network-level routing configuration for + this network. Used by Cloud Router to determine + what type of network-wide routing behavior to + enforce. + self_link (str): + [Output Only] Server-defined URL for the resource. + subnetworks (Sequence[str]): + [Output Only] Server-defined fully-qualified URLs for all + subnetworks in this VPC network. """ - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - instance_group_managers_update_per_instance_configs_req_resource = proto.Field( - proto.MESSAGE, - number=141402302, - message="InstanceGroupManagersUpdatePerInstanceConfigsReq", + I_pv4_range = proto.Field(proto.STRING, number=59234358, optional=True,) + auto_create_subnetworks = proto.Field(proto.BOOL, number=256156690, optional=True,) + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + gateway_i_pv4 = proto.Field(proto.STRING, number=178678877, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + mtu = proto.Field(proto.INT32, number=108462, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + peerings = proto.RepeatedField( + proto.MESSAGE, number=69883187, message="NetworkPeering", ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - + routing_config = proto.Field( + proto.MESSAGE, number=523556059, optional=True, message="NetworkRoutingConfig", + ) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + subnetworks = proto.RepeatedField(proto.STRING, number=415853125,) -class AddInstancesInstanceGroupRequest(proto.Message): - r"""A request message for InstanceGroups.AddInstances. See the - method description for details. +class NetworkEndpoint(proto.Message): + r"""The network endpoint. Attributes: - instance_group (str): - The name of the instance group where you are - adding instances. - instance_groups_add_instances_request_resource (google.cloud.compute_v1.types.InstanceGroupsAddInstancesRequest): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone where the instance group - is located. + annotations (Sequence[google.cloud.compute_v1.types.NetworkEndpoint.AnnotationsEntry]): + Metadata defined as annotations on the + network endpoint. + fqdn (str): + Optional fully qualified domain name of network endpoint. + This can only be specified when + NetworkEndpointGroup.network_endpoint_type is + NON_GCP_FQDN_PORT. + instance (str): + The name for a specific VM instance that the IP address + belongs to. This is required for network endpoints of type + GCE_VM_IP_PORT. The instance must be in the same zone of + network endpoint group. The name must be 1-63 characters + long, and comply with RFC1035. + ip_address (str): + Optional IPv4 address of network endpoint. + The IP address must belong to a VM in Compute + Engine (either the primary IP or as part of an + aliased IP range). If the IP address is not + specified, then the primary IP address for the + VM instance in the network that the network + endpoint group belongs to will be used. + port (int): + Optional port number of network endpoint. If + not specified, the defaultPort for the network + endpoint group will be used. """ - instance_group = proto.Field(proto.STRING, number=81095253,) - instance_groups_add_instances_request_resource = proto.Field( - proto.MESSAGE, number=453713246, message="InstanceGroupsAddInstancesRequest", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + annotations = proto.MapField(proto.STRING, proto.STRING, number=112032548,) + fqdn = proto.Field(proto.STRING, number=3150485, optional=True,) + instance = proto.Field(proto.STRING, number=18257045, optional=True,) + ip_address = proto.Field(proto.STRING, number=406272220, optional=True,) + port = proto.Field(proto.INT32, number=3446913, optional=True,) -class AggregatedListInstanceGroupsRequest(proto.Message): - r"""A request message for InstanceGroups.AggregatedList. See the - method description for details. +class NetworkEndpointGroup(proto.Message): + r"""Represents a collection of network endpoints. A network + endpoint group (NEG) defines how a set of endpoints should be + reached, whether they are reachable, and where they are located. + For more information about using NEGs, see Setting up external + HTTP(S) Load Balancing with internet NEGs, Setting up zonal + NEGs, or Setting up external HTTP(S) Load Balancing with + serverless NEGs. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + annotations (Sequence[google.cloud.compute_v1.types.NetworkEndpointGroup.AnnotationsEntry]): + Metadata defined as annotations on the + network endpoint group. + app_engine (google.cloud.compute_v1.types.NetworkEndpointGroupAppEngine): + Only valid when networkEndpointType is + "SERVERLESS". Only one of cloudRun, appEngine or + cloudFunction may be set. + cloud_function (google.cloud.compute_v1.types.NetworkEndpointGroupCloudFunction): + Only valid when networkEndpointType is + "SERVERLESS". Only one of cloudRun, appEngine or + cloudFunction may be set. + cloud_run (google.cloud.compute_v1.types.NetworkEndpointGroupCloudRun): + Only valid when networkEndpointType is + "SERVERLESS". Only one of cloudRun, appEngine or + cloudFunction may be set. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + default_port (int): + The default port used if the port number is + not specified in the network endpoint. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + kind (str): + [Output Only] Type of the resource. Always + compute#networkEndpointGroup for network endpoint group. + name (str): + Name of the resource; provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. + network (str): + The URL of the network to which all network + endpoints in the NEG belong. Uses "default" + project network if unspecified. + network_endpoint_type (google.cloud.compute_v1.types.NetworkEndpointGroup.NetworkEndpointType): + Type of network endpoints in this network endpoint group. + Can be one of GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, + INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, + PRIVATE_SERVICE_CONNECT. + region (str): + [Output Only] The URL of the region where the network + endpoint group is located. + self_link (str): + [Output Only] Server-defined URL for the resource. + size (int): + [Output only] Number of network endpoints in the network + endpoint group. + subnetwork (str): + Optional URL of the subnetwork to which all + network endpoints in the NEG belong. + zone (str): + [Output Only] The URL of the zone where the network endpoint + group is located. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + class NetworkEndpointType(proto.Enum): + r"""Type of network endpoints in this network endpoint group. Can be one + of GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, + INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT. + """ + UNDEFINED_NETWORK_ENDPOINT_TYPE = 0 + GCE_VM_IP = 401880793 + GCE_VM_IP_PORT = 501838375 + INTERNET_FQDN_PORT = 404154477 + INTERNET_IP_PORT = 477719963 + NON_GCP_PRIVATE_IP_PORT = 336447968 + SERVERLESS = 270492508 + annotations = proto.MapField(proto.STRING, proto.STRING, number=112032548,) + app_engine = proto.Field( + proto.MESSAGE, + number=340788768, + optional=True, + message="NetworkEndpointGroupAppEngine", + ) + cloud_function = proto.Field( + proto.MESSAGE, + number=519893666, + optional=True, + message="NetworkEndpointGroupCloudFunction", + ) + cloud_run = proto.Field( + proto.MESSAGE, + number=111060353, + optional=True, + message="NetworkEndpointGroupCloudRun", + ) + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + default_port = proto.Field(proto.INT32, number=423377855, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + network = proto.Field(proto.STRING, number=232872494, optional=True,) + network_endpoint_type = proto.Field( + proto.ENUM, number=118301523, optional=True, enum=NetworkEndpointType, + ) + region = proto.Field(proto.STRING, number=138946292, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + size = proto.Field(proto.INT32, number=3530753, optional=True,) + subnetwork = proto.Field(proto.STRING, number=307827694, optional=True,) + zone = proto.Field(proto.STRING, number=3744684, optional=True,) -class DeleteInstanceGroupRequest(proto.Message): - r"""A request message for InstanceGroups.Delete. See the method - description for details. +class NetworkEndpointGroupAggregatedList(proto.Message): + r""" Attributes: - instance_group (str): - The name of the instance group to delete. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone where the instance group - is located. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.NetworkEndpointGroupAggregatedList.ItemsEntry]): + A list of NetworkEndpointGroupsScopedList + resources. + kind (str): + [Output Only] The resource type, which is always + compute#networkEndpointGroupAggregatedList for aggregated + lists of network endpoint groups. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - instance_group = proto.Field(proto.STRING, number=81095253,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + @property + def raw_page(self): + return self + + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.MapField( + proto.STRING, + proto.MESSAGE, + number=100526016, + message="NetworkEndpointGroupsScopedList", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class GetInstanceGroupRequest(proto.Message): - r"""A request message for InstanceGroups.Get. See the method - description for details. +class NetworkEndpointGroupAppEngine(proto.Message): + r"""Configuration for an App Engine network endpoint group (NEG). + The service is optional, may be provided explicitly or in the + URL mask. The version is optional and can only be provided + explicitly or in the URL mask when service is present. Note: App + Engine service must be in the same project and located in the + same region as the Serverless NEG. Attributes: - instance_group (str): - The name of the instance group. - project (str): - Project ID for this request. - zone (str): - The name of the zone where the instance group - is located. + service (str): + Optional serving service. The service name is + case-sensitive and must be 1-63 characters long. + Example value: "default", "my-service". + url_mask (str): + A template to parse service and version + fields from a request URL. URL mask allows for + routing to multiple App Engine services without + having to create multiple Network Endpoint + Groups and backend services. For example, the + request URLs "foo1-dot-appname.appspot.com/v1" + and "foo1-dot-appname.appspot.com/v2" can be + backed by the same Serverless NEG with URL mask + "-dot-appname.appspot.com/". The URL mask will + parse them to { service = "foo1", version = "v1" + } and { service = "foo1", version = "v2" } + respectively. + version (str): + Optional serving version. The version name is + case-sensitive and must be 1-100 characters + long. Example value: "v1", "v2". """ - instance_group = proto.Field(proto.STRING, number=81095253,) - project = proto.Field(proto.STRING, number=227560217,) - zone = proto.Field(proto.STRING, number=3744684,) + service = proto.Field(proto.STRING, number=373540533, optional=True,) + url_mask = proto.Field(proto.STRING, number=103352252, optional=True,) + version = proto.Field(proto.STRING, number=351608024, optional=True,) -class InsertInstanceGroupRequest(proto.Message): - r"""A request message for InstanceGroups.Insert. See the method - description for details. +class NetworkEndpointGroupCloudFunction(proto.Message): + r"""Configuration for a Cloud Function network endpoint group + (NEG). The function must be provided explicitly or in the URL + mask. Note: Cloud Function must be in the same project and + located in the same region as the Serverless NEG. Attributes: - instance_group_resource (google.cloud.compute_v1.types.InstanceGroup): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone where you want to create - the instance group. + function (str): + A user-defined name of the Cloud Function. + The function name is case-sensitive and must be + 1-63 characters long. Example value: "func1". + url_mask (str): + A template to parse function field from a + request URL. URL mask allows for routing to + multiple Cloud Functions without having to + create multiple Network Endpoint Groups and + backend services. For example, request URLs " + mydomain.com/function1" and + "mydomain.com/function2" can be backed by the + same Serverless NEG with URL mask "/". The URL + mask will parse them to { function = "function1" + } and { function = "function2" } respectively. """ - instance_group_resource = proto.Field( - proto.MESSAGE, number=286612152, message="InstanceGroup", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + function = proto.Field(proto.STRING, number=307196888, optional=True,) + url_mask = proto.Field(proto.STRING, number=103352252, optional=True,) -class ListInstanceGroupsRequest(proto.Message): - r"""A request message for InstanceGroups.List. See the method - description for details. +class NetworkEndpointGroupCloudRun(proto.Message): + r"""Configuration for a Cloud Run network endpoint group (NEG). + The service must be provided explicitly or in the URL mask. The + tag is optional, may be provided explicitly or in the URL mask. + Note: Cloud Run service must be in the same project and located + in the same region as the Serverless NEG. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. - zone (str): - The name of the zone where the instance group - is located. + service (str): + Cloud Run service is the main resource of + Cloud Run. The service must be 1-63 characters + long, and comply with RFC1035. Example value: + "run-service". + tag (str): + Optional Cloud Run tag represents the "named- + evision" to provide additional fine-grained + traffic routing information. The tag must be + 1-63 characters long, and comply with RFC1035. + Example value: "revision-0010". + url_mask (str): + A template to parse service and tag fields + from a request URL. URL mask allows for routing + to multiple Run services without having to + create multiple network endpoint groups and + backend services. For example, request URLs + "foo1.domain.com/bar1" and + "foo1.domain.com/bar2" can be backed by the same + Serverless Network Endpoint Group (NEG) with URL + mask ".domain.com/". The URL mask will parse + them to { service="bar1", tag="foo1" } and { + service="bar2", tag="foo2" } respectively. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - + service = proto.Field(proto.STRING, number=373540533, optional=True,) + tag = proto.Field(proto.STRING, number=114586, optional=True,) + url_mask = proto.Field(proto.STRING, number=103352252, optional=True,) -class ListInstancesInstanceGroupsRequest(proto.Message): - r"""A request message for InstanceGroups.ListInstances. See the - method description for details. +class NetworkEndpointGroupList(proto.Message): + r""" Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.NetworkEndpointGroup]): + A list of NetworkEndpointGroup resources. + kind (str): + [Output Only] The resource type, which is always + compute#networkEndpointGroupList for network endpoint group + lists. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + @property + def raw_page(self): + return self - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - instance_group (str): - The name of the instance group from which you - want to generate a list of included instances. - instance_groups_list_instances_request_resource (google.cloud.compute_v1.types.InstanceGroupsListInstancesRequest): - The body resource for this request - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="NetworkEndpointGroup", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. - zone (str): - The name of the zone where the instance group - is located. +class NetworkEndpointGroupsAttachEndpointsRequest(proto.Message): + r""" + Attributes: + network_endpoints (Sequence[google.cloud.compute_v1.types.NetworkEndpoint]): + The list of network endpoints to be attached. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - instance_group = proto.Field(proto.STRING, number=81095253,) - instance_groups_list_instances_request_resource = proto.Field( - proto.MESSAGE, number=476255263, message="InstanceGroupsListInstancesRequest", + network_endpoints = proto.RepeatedField( + proto.MESSAGE, number=149850285, message="NetworkEndpoint", ) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) -class RemoveInstancesInstanceGroupRequest(proto.Message): - r"""A request message for InstanceGroups.RemoveInstances. See the - method description for details. - +class NetworkEndpointGroupsDetachEndpointsRequest(proto.Message): + r""" Attributes: - instance_group (str): - The name of the instance group where the - specified instances will be removed. - instance_groups_remove_instances_request_resource (google.cloud.compute_v1.types.InstanceGroupsRemoveInstancesRequest): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone where the instance group - is located. + network_endpoints (Sequence[google.cloud.compute_v1.types.NetworkEndpoint]): + The list of network endpoints to be detached. """ - instance_group = proto.Field(proto.STRING, number=81095253,) - instance_groups_remove_instances_request_resource = proto.Field( - proto.MESSAGE, number=390981817, message="InstanceGroupsRemoveInstancesRequest", + network_endpoints = proto.RepeatedField( + proto.MESSAGE, number=149850285, message="NetworkEndpoint", ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - -class SetNamedPortsInstanceGroupRequest(proto.Message): - r"""A request message for InstanceGroups.SetNamedPorts. See the - method description for details. +class NetworkEndpointGroupsListEndpointsRequest(proto.Message): + r""" Attributes: - instance_group (str): - The name of the instance group where the - named ports are updated. - instance_groups_set_named_ports_request_resource (google.cloud.compute_v1.types.InstanceGroupsSetNamedPortsRequest): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone where the instance group - is located. + health_status (google.cloud.compute_v1.types.NetworkEndpointGroupsListEndpointsRequest.HealthStatus): + Optional query parameter for showing the + health status of each network endpoint. Valid + options are SKIP or SHOW. If you don't specify + this parameter, the health status of network + endpoints will not be provided. """ - instance_group = proto.Field(proto.STRING, number=81095253,) - instance_groups_set_named_ports_request_resource = proto.Field( - proto.MESSAGE, number=385151535, message="InstanceGroupsSetNamedPortsRequest", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + class HealthStatus(proto.Enum): + r"""Optional query parameter for showing the health status of + each network endpoint. Valid options are SKIP or SHOW. If you + don't specify this parameter, the health status of network + endpoints will not be provided. + """ + UNDEFINED_HEALTH_STATUS = 0 + SHOW = 2544381 + SKIP = 2547071 + health_status = proto.Field( + proto.ENUM, number=380545845, optional=True, enum=HealthStatus, + ) -class DeleteInstanceTemplateRequest(proto.Message): - r"""A request message for InstanceTemplates.Delete. See the - method description for details. +class NetworkEndpointGroupsListNetworkEndpoints(proto.Message): + r""" Attributes: - instance_template (str): - The name of the instance template to delete. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.NetworkEndpointWithHealthStatus]): + A list of NetworkEndpointWithHealthStatus + resources. + kind (str): + [Output Only] The resource type, which is always + compute#networkEndpointGroupsListNetworkEndpoints for the + list of network endpoints in the specified network endpoint + group. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - instance_template = proto.Field(proto.STRING, number=309248228,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="NetworkEndpointWithHealthStatus", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class GetInstanceTemplateRequest(proto.Message): - r"""A request message for InstanceTemplates.Get. See the method - description for details. +class NetworkEndpointGroupsScopedList(proto.Message): + r""" Attributes: - instance_template (str): - The name of the instance template. - project (str): - Project ID for this request. + network_endpoint_groups (Sequence[google.cloud.compute_v1.types.NetworkEndpointGroup]): + [Output Only] The list of network endpoint groups that are + contained in this scope. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] An informational warning that replaces the + list of network endpoint groups when the list is empty. """ - instance_template = proto.Field(proto.STRING, number=309248228,) - project = proto.Field(proto.STRING, number=227560217,) - + network_endpoint_groups = proto.RepeatedField( + proto.MESSAGE, number=29346733, message="NetworkEndpointGroup", + ) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class GetIamPolicyInstanceTemplateRequest(proto.Message): - r"""A request message for InstanceTemplates.GetIamPolicy. See the - method description for details. +class NetworkEndpointWithHealthStatus(proto.Message): + r""" Attributes: - options_requested_policy_version (int): - Requested IAM Policy version. - project (str): - Project ID for this request. - resource (str): - Name or id of the resource for this request. + healths (Sequence[google.cloud.compute_v1.types.HealthStatusForNetworkEndpoint]): + [Output only] The health status of network endpoint; + network_endpoint (google.cloud.compute_v1.types.NetworkEndpoint): + [Output only] The network endpoint; """ - options_requested_policy_version = proto.Field( - proto.INT32, number=499220029, optional=True, + healths = proto.RepeatedField( + proto.MESSAGE, number=258689431, message="HealthStatusForNetworkEndpoint", + ) + network_endpoint = proto.Field( + proto.MESSAGE, number=56789126, optional=True, message="NetworkEndpoint", ) - project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) - -class InsertInstanceTemplateRequest(proto.Message): - r"""A request message for InstanceTemplates.Insert. See the - method description for details. +class NetworkInterface(proto.Message): + r"""A network interface resource attached to an instance. Attributes: - instance_template_resource (google.cloud.compute_v1.types.InstanceTemplate): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + access_configs (Sequence[google.cloud.compute_v1.types.AccessConfig]): + An array of configurations for this interface. Currently, + only one access config, ONE_TO_ONE_NAT, is supported. If + there are no accessConfigs specified, then this instance + will have no external internet access. + alias_ip_ranges (Sequence[google.cloud.compute_v1.types.AliasIpRange]): + An array of alias IP ranges for this network + interface. You can only specify this field for + network interfaces in VPC networks. + fingerprint (str): + Fingerprint hash of contents stored in this + network interface. This field will be ignored + when inserting an Instance or adding a + NetworkInterface. An up-to-date fingerprint must + be provided in order to update the + NetworkInterface. The request will fail with + error 400 Bad Request if the fingerprint is not + provided, or 412 Precondition Failed if the + fingerprint is out of date. + ipv6_access_configs (Sequence[google.cloud.compute_v1.types.AccessConfig]): + An array of IPv6 access configurations for this interface. + Currently, only one IPv6 access config, DIRECT_IPV6, is + supported. If there is no ipv6AccessConfig specified, then + this instance will have no external IPv6 Internet access. + ipv6_access_type (google.cloud.compute_v1.types.NetworkInterface.Ipv6AccessType): + [Output Only] One of EXTERNAL, INTERNAL to indicate whether + the IP can be accessed from the Internet. This field is + always inherited from its subnetwork. Valid only if + stackType is IPV4_IPV6. + ipv6_address (str): + [Output Only] An IPv6 internal network address for this + network interface. + kind (str): + [Output Only] Type of the resource. Always + compute#networkInterface for network interfaces. + name (str): + [Output Only] The name of the network interface, which is + generated by the server. For network devices, these are + eth0, eth1, etc. + network (str): + URL of the network resource for this + instance. When creating an instance, if neither + the network nor the subnetwork is specified, the + default network global/networks/default is used; + if the network is not specified but the + subnetwork is specified, the network is + inferred. If you specify this property, you can + specify the network as a full or partial URL. + For example, the following are all valid URLs: - + https://www.googleapis.com/compute/v1/projects/project/global/networks/ + network - + projects/project/global/networks/network - + global/networks/default + network_i_p (str): + An IPv4 internal IP address to assign to the + instance for this network interface. If not + specified by the user, an unused internal IP is + assigned by the system. + nic_type (google.cloud.compute_v1.types.NetworkInterface.NicType): + The type of vNIC to be used on this + interface. This may be gVNIC or VirtioNet. + queue_count (int): + The networking queue count that's specified + by users for the network interface. Both Rx and + Tx queues will be set to this number. It'll be + empty if not specified by the users. + stack_type (google.cloud.compute_v1.types.NetworkInterface.StackType): + The stack type for this network interface to identify + whether the IPv6 feature is enabled or not. If not + specified, IPV4_ONLY will be used. This field can be both + set at instance creation and update network interface + operations. + subnetwork (str): + The URL of the Subnetwork resource for this + instance. If the network resource is in legacy + mode, do not specify this field. If the network + is in auto subnet mode, specifying the + subnetwork is optional. If the network is in + custom subnet mode, specifying the subnetwork is + required. If you specify this field, you can + specify the subnetwork as a full or partial URL. + For example, the following are all valid URLs: - + https://www.googleapis.com/compute/v1/projects/project/regions/region + /subnetworks/subnetwork - + regions/region/subnetworks/subnetwork """ - instance_template_resource = proto.Field( - proto.MESSAGE, number=10679561, message="InstanceTemplate", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + class Ipv6AccessType(proto.Enum): + r"""[Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP + can be accessed from the Internet. This field is always inherited + from its subnetwork. Valid only if stackType is IPV4_IPV6. + """ + UNDEFINED_IPV6_ACCESS_TYPE = 0 + EXTERNAL = 35607499 + UNSPECIFIED_IPV6_ACCESS_TYPE = 313080613 + class NicType(proto.Enum): + r"""The type of vNIC to be used on this interface. This may be + gVNIC or VirtioNet. + """ + UNDEFINED_NIC_TYPE = 0 + GVNIC = 68209305 + UNSPECIFIED_NIC_TYPE = 67411801 + VIRTIO_NET = 452123481 + + class StackType(proto.Enum): + r"""The stack type for this network interface to identify whether the + IPv6 feature is enabled or not. If not specified, IPV4_ONLY will be + used. This field can be both set at instance creation and update + network interface operations. + """ + UNDEFINED_STACK_TYPE = 0 + IPV4_IPV6 = 22197249 + IPV4_ONLY = 22373798 + UNSPECIFIED_STACK_TYPE = 298084569 + + access_configs = proto.RepeatedField( + proto.MESSAGE, number=111058326, message="AccessConfig", + ) + alias_ip_ranges = proto.RepeatedField( + proto.MESSAGE, number=165085631, message="AliasIpRange", + ) + fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) + ipv6_access_configs = proto.RepeatedField( + proto.MESSAGE, number=483472110, message="AccessConfig", + ) + ipv6_access_type = proto.Field( + proto.ENUM, number=504658653, optional=True, enum=Ipv6AccessType, + ) + ipv6_address = proto.Field(proto.STRING, number=341563804, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + network = proto.Field(proto.STRING, number=232872494, optional=True,) + network_i_p = proto.Field(proto.STRING, number=207181961, optional=True,) + nic_type = proto.Field(proto.ENUM, number=59810577, optional=True, enum=NicType,) + queue_count = proto.Field(proto.INT32, number=503708769, optional=True,) + stack_type = proto.Field( + proto.ENUM, number=425908881, optional=True, enum=StackType, + ) + subnetwork = proto.Field(proto.STRING, number=307827694, optional=True,) -class ListInstanceTemplatesRequest(proto.Message): - r"""A request message for InstanceTemplates.List. See the method - description for details. +class NetworkList(proto.Message): + r"""Contains a list of networks. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.Network]): + A list of Network resources. + kind (str): + [Output Only] Type of resource. Always compute#networkList + for lists of networks. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. + """ - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + @property + def raw_page(self): + return self - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Network",) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. +class NetworkPeering(proto.Message): + r"""A network peering attached to a network resource. The message + includes the peering name, peer network, peering state, and a + flag indicating whether Google Compute Engine should + automatically create routes for the peering. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + Attributes: + auto_create_routes (bool): + This field will be deprecated soon. Use the + exchange_subnet_routes field instead. Indicates whether full + mesh connectivity is created and managed automatically + between peered networks. Currently this field should always + be true since Google Compute Engine will automatically + create and manage subnetwork routes between two networks + when peering state is ACTIVE. + exchange_subnet_routes (bool): + Indicates whether full mesh connectivity is + created and managed automatically between peered + networks. Currently this field should always be + true since Google Compute Engine will + automatically create and manage subnetwork + routes between two networks when peering state + is ACTIVE. + export_custom_routes (bool): + Whether to export the custom routes to peer + network. + export_subnet_routes_with_public_ip (bool): + Whether subnet routes with public IP range + are exported. The default value is true, all + subnet routes are exported. IPv4 special-use + ranges are always exported to peers and are not + controlled by this field. + import_custom_routes (bool): + Whether to import the custom routes from peer + network. + import_subnet_routes_with_public_ip (bool): + Whether subnet routes with public IP range + are imported. The default value is false. IPv4 + special-use ranges are always imported from + peers and are not controlled by this field. + name (str): + Name of this peering. Provided by the client when the + peering is created. The name must comply with RFC1035. + Specifically, the name must be 1-63 characters long and + match regular expression ``[a-z]([-a-z0-9]*[a-z0-9])?``. The + first character must be a lowercase letter, and all the + following characters must be a dash, lowercase letter, or + digit, except the last character, which cannot be a dash. + network (str): + The URL of the peer network. It can be either + full URL or partial URL. The peer network may + belong to a different project. If the partial + URL does not contain project, it is assumed that + the peer network is in the same project as the + current network. + peer_mtu (int): + Maximum Transmission Unit in bytes. + state (google.cloud.compute_v1.types.NetworkPeering.State): + [Output Only] State for the peering, either ``ACTIVE`` or + ``INACTIVE``. The peering is ``ACTIVE`` when there's a + matching configuration in the peer network. + state_details (str): + [Output Only] Details about the current state of the + peering. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + class State(proto.Enum): + r"""[Output Only] State for the peering, either ``ACTIVE`` or + ``INACTIVE``. The peering is ``ACTIVE`` when there's a matching + configuration in the peer network. + """ + UNDEFINED_STATE = 0 + ACTIVE = 314733318 + INACTIVE = 270421099 + + auto_create_routes = proto.Field(proto.BOOL, number=57454941, optional=True,) + exchange_subnet_routes = proto.Field(proto.BOOL, number=26322256, optional=True,) + export_custom_routes = proto.Field(proto.BOOL, number=60281485, optional=True,) + export_subnet_routes_with_public_ip = proto.Field( + proto.BOOL, number=97940834, optional=True, + ) + import_custom_routes = proto.Field(proto.BOOL, number=197982398, optional=True,) + import_subnet_routes_with_public_ip = proto.Field( + proto.BOOL, number=14419729, optional=True, + ) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + network = proto.Field(proto.STRING, number=232872494, optional=True,) + peer_mtu = proto.Field(proto.INT32, number=69584721, optional=True,) + state = proto.Field(proto.ENUM, number=109757585, optional=True, enum=State,) + state_details = proto.Field(proto.STRING, number=95566996, optional=True,) -class SetIamPolicyInstanceTemplateRequest(proto.Message): - r"""A request message for InstanceTemplates.SetIamPolicy. See the - method description for details. +class NetworkRoutingConfig(proto.Message): + r"""A routing configuration attached to a network resource. The + message includes the list of routers associated with the + network, and a flag indicating the type of routing behavior to + enforce network-wide. Attributes: - global_set_policy_request_resource (google.cloud.compute_v1.types.GlobalSetPolicyRequest): - The body resource for this request - project (str): - Project ID for this request. - resource (str): - Name or id of the resource for this request. + routing_mode (google.cloud.compute_v1.types.NetworkRoutingConfig.RoutingMode): + The network-wide routing mode to use. If set + to REGIONAL, this network's Cloud Routers will + only advertise routes with subnets of this + network in the same region as the router. If set + to GLOBAL, this network's Cloud Routers will + advertise routes with all subnets of this + network, across regions. """ - global_set_policy_request_resource = proto.Field( - proto.MESSAGE, number=337048498, message="GlobalSetPolicyRequest", - ) - project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) + class RoutingMode(proto.Enum): + r"""The network-wide routing mode to use. If set to REGIONAL, + this network's Cloud Routers will only advertise routes with + subnets of this network in the same region as the router. If set + to GLOBAL, this network's Cloud Routers will advertise routes + with all subnets of this network, across regions. + """ + UNDEFINED_ROUTING_MODE = 0 + GLOBAL = 494663587 + REGIONAL = 92288543 + routing_mode = proto.Field( + proto.ENUM, number=475143548, optional=True, enum=RoutingMode, + ) -class TestIamPermissionsInstanceTemplateRequest(proto.Message): - r"""A request message for InstanceTemplates.TestIamPermissions. - See the method description for details. +class NetworksAddPeeringRequest(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - resource (str): - Name or id of the resource for this request. - test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): - The body resource for this request + auto_create_routes (bool): + This field will be deprecated soon. Use + exchange_subnet_routes in network_peering instead. Indicates + whether full mesh connectivity is created and managed + automatically between peered networks. Currently this field + should always be true since Google Compute Engine will + automatically create and manage subnetwork routes between + two networks when peering state is ACTIVE. + name (str): + Name of the peering, which should conform to + RFC1035. + network_peering (google.cloud.compute_v1.types.NetworkPeering): + Network peering parameters. In order to specify route + policies for peering using import and export custom routes, + you must specify all peering related parameters (name, peer + network, exchange_subnet_routes) in the network_peering + field. The corresponding fields in NetworksAddPeeringRequest + will be deprecated soon. + peer_network (str): + URL of the peer network. It can be either + full URL or partial URL. The peer network may + belong to a different project. If the partial + URL does not contain project, it is assumed that + the peer network is in the same project as the + current network. """ - project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) - test_permissions_request_resource = proto.Field( - proto.MESSAGE, number=439214758, message="TestPermissionsRequest", + auto_create_routes = proto.Field(proto.BOOL, number=57454941, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + network_peering = proto.Field( + proto.MESSAGE, number=328926767, optional=True, message="NetworkPeering", ) + peer_network = proto.Field(proto.STRING, number=500625489, optional=True,) -class AddAccessConfigInstanceRequest(proto.Message): - r"""A request message for Instances.AddAccessConfig. See the - method description for details. - +class NetworksGetEffectiveFirewallsResponse(proto.Message): + r""" Attributes: - access_config_resource (google.cloud.compute_v1.types.AccessConfig): - The body resource for this request - instance (str): - The instance name for this request. - network_interface (str): - The name of the network interface to add to - this instance. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. + firewall_policys (Sequence[google.cloud.compute_v1.types.NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy]): + Effective firewalls from firewall policy. + firewalls (Sequence[google.cloud.compute_v1.types.Firewall]): + Effective firewalls on the network. """ - access_config_resource = proto.Field( - proto.MESSAGE, number=387825552, message="AccessConfig", + firewall_policys = proto.RepeatedField( + proto.MESSAGE, + number=410985794, + message="NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy", + ) + firewalls = proto.RepeatedField( + proto.MESSAGE, number=272245619, message="Firewall", ) - instance = proto.Field(proto.STRING, number=18257045,) - network_interface = proto.Field(proto.STRING, number=365387880,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - -class AddResourcePoliciesInstanceRequest(proto.Message): - r"""A request message for Instances.AddResourcePolicies. See the - method description for details. +class NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy(proto.Message): + r""" Attributes: - instance (str): - The instance name for this request. - instances_add_resource_policies_request_resource (google.cloud.compute_v1.types.InstancesAddResourcePoliciesRequest): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. + display_name (str): + [Output Only] Deprecated, please use short name instead. The + display name of the firewall policy. + name (str): + [Output Only] The name of the firewall policy. + rules (Sequence[google.cloud.compute_v1.types.FirewallPolicyRule]): + The rules that apply to the network. + short_name (str): + [Output Only] The short name of the firewall policy. + type_ (google.cloud.compute_v1.types.NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy.Type): + [Output Only] The type of the firewall policy. """ - instance = proto.Field(proto.STRING, number=18257045,) - instances_add_resource_policies_request_resource = proto.Field( - proto.MESSAGE, number=489351963, message="InstancesAddResourcePoliciesRequest", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + class Type(proto.Enum): + r"""[Output Only] The type of the firewall policy.""" + UNDEFINED_TYPE = 0 + HIERARCHY = 69902869 + NETWORK = 413984270 + UNSPECIFIED = 526786327 + display_name = proto.Field(proto.STRING, number=4473832, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + rules = proto.RepeatedField( + proto.MESSAGE, number=108873975, message="FirewallPolicyRule", + ) + short_name = proto.Field(proto.STRING, number=492051566, optional=True,) + type_ = proto.Field(proto.ENUM, number=3575610, optional=True, enum=Type,) -class AggregatedListInstancesRequest(proto.Message): - r"""A request message for Instances.AggregatedList. See the - method description for details. +class NetworksRemovePeeringRequest(proto.Message): + r""" Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + name (str): + Name of the peering, which should conform to + RFC1035. + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + name = proto.Field(proto.STRING, number=3373707, optional=True,) - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. +class NetworksUpdatePeeringRequest(proto.Message): + r""" + Attributes: + network_peering (google.cloud.compute_v1.types.NetworkPeering): - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + network_peering = proto.Field( + proto.MESSAGE, number=328926767, optional=True, message="NetworkPeering", + ) -class AttachDiskInstanceRequest(proto.Message): - r"""A request message for Instances.AttachDisk. See the method - description for details. +class NodeGroup(proto.Message): + r"""Represents a sole-tenant Node Group resource. A sole-tenant + node is a physical server that is dedicated to hosting VM + instances only for your specific project. Use sole-tenant nodes + to keep your instances physically separated from instances in + other projects, or to group your instances together on the same + host hardware. For more information, read Sole-tenant nodes. Attributes: - attached_disk_resource (google.cloud.compute_v1.types.AttachedDisk): - The body resource for this request - force_attach (bool): - Whether to force attach the regional disk - even if it's currently attached to another - instance. If you try to force attach a zonal - disk to an instance, you will receive an error. - instance (str): - The instance name for this request. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. - """ - - attached_disk_resource = proto.Field( - proto.MESSAGE, number=90605845, message="AttachedDisk", - ) - force_attach = proto.Field(proto.BOOL, number=142758425, optional=True,) - instance = proto.Field(proto.STRING, number=18257045,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + autoscaling_policy (google.cloud.compute_v1.types.NodeGroupAutoscalingPolicy): + Specifies how autoscaling should behave. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + fingerprint (str): + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + kind (str): + [Output Only] The type of the resource. Always + compute#nodeGroup for node group. + location_hint (str): + An opaque location hint used to place the Node close to + other resources. This field is for use by internal tools + that use the public API. The location hint here on the + NodeGroup overrides any location_hint present in the + NodeTemplate. + maintenance_policy (google.cloud.compute_v1.types.NodeGroup.MaintenancePolicy): + Specifies how to handle instances when a node in the group + undergoes maintenance. Set to one of: DEFAULT, + RESTART_IN_PLACE, or MIGRATE_WITHIN_NODE_GROUP. The default + value is DEFAULT. For more information, see Maintenance + policies. + maintenance_window (google.cloud.compute_v1.types.NodeGroupMaintenanceWindow): -class BulkInsertInstanceRequest(proto.Message): - r"""A request message for Instances.BulkInsert. See the method - description for details. + name (str): + The name of the resource, provided by the client when + initially creating the resource. The resource name must be + 1-63 characters long, and comply with RFC1035. Specifically, + the name must be 1-63 characters long and match the regular + expression ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the + first character must be a lowercase letter, and all + following characters must be a dash, lowercase letter, or + digit, except the last character, which cannot be a dash. + node_template (str): + URL of the node template to create the node + group from. + self_link (str): + [Output Only] Server-defined URL for the resource. + size (int): + [Output Only] The total number of nodes in the node group. + status (google.cloud.compute_v1.types.NodeGroup.Status): - Attributes: - bulk_insert_instance_resource_resource (google.cloud.compute_v1.types.BulkInsertInstanceResource): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). zone (str): - The name of the zone for this request. + [Output Only] The name of the zone where the node group + resides, such as us-central1-a. """ - bulk_insert_instance_resource_resource = proto.Field( - proto.MESSAGE, number=41427278, message="BulkInsertInstanceResource", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + class MaintenancePolicy(proto.Enum): + r"""Specifies how to handle instances when a node in the group undergoes + maintenance. Set to one of: DEFAULT, RESTART_IN_PLACE, or + MIGRATE_WITHIN_NODE_GROUP. The default value is DEFAULT. For more + information, see Maintenance policies. + """ + UNDEFINED_MAINTENANCE_POLICY = 0 + DEFAULT = 115302945 + MAINTENANCE_POLICY_UNSPECIFIED = 72964182 + MIGRATE_WITHIN_NODE_GROUP = 153483394 + RESTART_IN_PLACE = 228647325 + class Status(proto.Enum): + r"""""" + UNDEFINED_STATUS = 0 + CREATING = 455564985 + DELETING = 528602024 + INVALID = 530283991 + READY = 77848963 + + autoscaling_policy = proto.Field( + proto.MESSAGE, + number=221950041, + optional=True, + message="NodeGroupAutoscalingPolicy", + ) + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + location_hint = proto.Field(proto.STRING, number=350519505, optional=True,) + maintenance_policy = proto.Field( + proto.ENUM, number=528327646, optional=True, enum=MaintenancePolicy, + ) + maintenance_window = proto.Field( + proto.MESSAGE, + number=186374812, + optional=True, + message="NodeGroupMaintenanceWindow", + ) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + node_template = proto.Field(proto.STRING, number=323154455, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + size = proto.Field(proto.INT32, number=3530753, optional=True,) + status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) + zone = proto.Field(proto.STRING, number=3744684, optional=True,) -class DeleteInstanceRequest(proto.Message): - r"""A request message for Instances.Delete. See the method - description for details. +class NodeGroupAggregatedList(proto.Message): + r""" Attributes: - instance (str): - Name of the instance resource to delete. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.NodeGroupAggregatedList.ItemsEntry]): + A list of NodeGroupsScopedList resources. + kind (str): + [Output Only] Type of resource.Always + compute#nodeGroupAggregatedList for aggregated lists of node + groups. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - instance = proto.Field(proto.STRING, number=18257045,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.MapField( + proto.STRING, proto.MESSAGE, number=100526016, message="NodeGroupsScopedList", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class DeleteAccessConfigInstanceRequest(proto.Message): - r"""A request message for Instances.DeleteAccessConfig. See the - method description for details. +class NodeGroupAutoscalingPolicy(proto.Message): + r""" Attributes: - access_config (str): - The name of the access config to delete. - instance (str): - The instance name for this request. - network_interface (str): - The name of the network interface. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. + max_nodes (int): + The maximum number of nodes that the group + should have. Must be set if autoscaling is + enabled. Maximum value allowed is 100. + min_nodes (int): + The minimum number of nodes that the group + should have. + mode (google.cloud.compute_v1.types.NodeGroupAutoscalingPolicy.Mode): + The autoscaling mode. Set to one of: ON, OFF, or + ONLY_SCALE_OUT. For more information, see Autoscaler modes. """ - access_config = proto.Field(proto.STRING, number=72856189,) - instance = proto.Field(proto.STRING, number=18257045,) - network_interface = proto.Field(proto.STRING, number=365387880,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + class Mode(proto.Enum): + r"""The autoscaling mode. Set to one of: ON, OFF, or ONLY_SCALE_OUT. For + more information, see Autoscaler modes. + """ + UNDEFINED_MODE = 0 + MODE_UNSPECIFIED = 371348091 + OFF = 78159 + ON = 2527 + ONLY_SCALE_OUT = 152713670 + max_nodes = proto.Field(proto.INT32, number=297762838, optional=True,) + min_nodes = proto.Field(proto.INT32, number=533370500, optional=True,) + mode = proto.Field(proto.ENUM, number=3357091, optional=True, enum=Mode,) -class DetachDiskInstanceRequest(proto.Message): - r"""A request message for Instances.DetachDisk. See the method - description for details. +class NodeGroupList(proto.Message): + r"""Contains a list of nodeGroups. Attributes: - device_name (str): - The device name of the disk to detach. Make a - get() request on the instance to view currently - attached disks and device names. - instance (str): - Instance name for this request. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.NodeGroup]): + A list of NodeGroup resources. + kind (str): + [Output Only] Type of resource.Always compute#nodeGroupList + for lists of node groups. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - device_name = proto.Field(proto.STRING, number=67541716,) - instance = proto.Field(proto.STRING, number=18257045,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="NodeGroup",) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class GetInstanceRequest(proto.Message): - r"""A request message for Instances.Get. See the method - description for details. + +class NodeGroupMaintenanceWindow(proto.Message): + r"""Time window specified for daily maintenance operations. GCE's + internal maintenance will be performed within this window. Attributes: - instance (str): - Name of the instance resource to return. - project (str): - Project ID for this request. - zone (str): - The name of the zone for this request. + maintenance_duration (google.cloud.compute_v1.types.Duration): + [Output only] A predetermined duration for the window, + automatically chosen to be the smallest possible in the + given scenario. + start_time (str): + Start time of the window. This must be in UTC + format that resolves to one of 00:00, 04:00, + 08:00, 12:00, 16:00, or 20:00. For example, both + 13:00-5 and 08:00 are valid. """ - instance = proto.Field(proto.STRING, number=18257045,) - project = proto.Field(proto.STRING, number=227560217,) - zone = proto.Field(proto.STRING, number=3744684,) - + maintenance_duration = proto.Field( + proto.MESSAGE, number=525291840, optional=True, message="Duration", + ) + start_time = proto.Field(proto.STRING, number=37467274, optional=True,) -class GetEffectiveFirewallsInstanceRequest(proto.Message): - r"""A request message for Instances.GetEffectiveFirewalls. See - the method description for details. +class NodeGroupNode(proto.Message): + r""" Attributes: - instance (str): - Name of the instance scoping this request. - network_interface (str): - The name of the network interface to get the - effective firewalls. - project (str): - Project ID for this request. - zone (str): - The name of the zone for this request. + accelerators (Sequence[google.cloud.compute_v1.types.AcceleratorConfig]): + Accelerators for this node. + cpu_overcommit_type (google.cloud.compute_v1.types.NodeGroupNode.CpuOvercommitType): + CPU overcommit. + disks (Sequence[google.cloud.compute_v1.types.LocalDisk]): + Local disk configurations. + instances (Sequence[str]): + Instances scheduled on this node. + name (str): + The name of the node. + node_type (str): + The type of this node. + satisfies_pzs (bool): + [Output Only] Reserved for future use. + server_binding (google.cloud.compute_v1.types.ServerBinding): + Binding properties for the physical server. + server_id (str): + Server ID associated with this node. + status (google.cloud.compute_v1.types.NodeGroupNode.Status): + """ - instance = proto.Field(proto.STRING, number=18257045,) - network_interface = proto.Field(proto.STRING, number=365387880,) - project = proto.Field(proto.STRING, number=227560217,) - zone = proto.Field(proto.STRING, number=3744684,) + class CpuOvercommitType(proto.Enum): + r"""CPU overcommit.""" + UNDEFINED_CPU_OVERCOMMIT_TYPE = 0 + CPU_OVERCOMMIT_TYPE_UNSPECIFIED = 520665615 + ENABLED = 182130465 + NONE = 2402104 + + class Status(proto.Enum): + r"""""" + UNDEFINED_STATUS = 0 + CREATING = 455564985 + DELETING = 528602024 + INVALID = 530283991 + READY = 77848963 + REPAIRING = 413483285 + accelerators = proto.RepeatedField( + proto.MESSAGE, number=269577064, message="AcceleratorConfig", + ) + cpu_overcommit_type = proto.Field( + proto.ENUM, number=247727959, optional=True, enum=CpuOvercommitType, + ) + disks = proto.RepeatedField(proto.MESSAGE, number=95594102, message="LocalDisk",) + instances = proto.RepeatedField(proto.STRING, number=29097598,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + node_type = proto.Field(proto.STRING, number=465832791, optional=True,) + satisfies_pzs = proto.Field(proto.BOOL, number=480964267, optional=True,) + server_binding = proto.Field( + proto.MESSAGE, number=208179593, optional=True, message="ServerBinding", + ) + server_id = proto.Field(proto.STRING, number=339433367, optional=True,) + status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) -class GetGuestAttributesInstanceRequest(proto.Message): - r"""A request message for Instances.GetGuestAttributes. See the - method description for details. +class NodeGroupsAddNodesRequest(proto.Message): + r""" Attributes: - instance (str): - Name of the instance scoping this request. - project (str): - Project ID for this request. - query_path (str): - Specifies the guest attributes path to be - queried. - variable_key (str): - Specifies the key for the guest attributes - entry. - zone (str): - The name of the zone for this request. + additional_node_count (int): + Count of additional nodes to be added to the + node group. """ - instance = proto.Field(proto.STRING, number=18257045,) - project = proto.Field(proto.STRING, number=227560217,) - query_path = proto.Field(proto.STRING, number=368591164, optional=True,) - variable_key = proto.Field(proto.STRING, number=164364828, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - + additional_node_count = proto.Field(proto.INT32, number=134997930, optional=True,) -class GetIamPolicyInstanceRequest(proto.Message): - r"""A request message for Instances.GetIamPolicy. See the method - description for details. +class NodeGroupsDeleteNodesRequest(proto.Message): + r""" Attributes: - options_requested_policy_version (int): - Requested IAM Policy version. - project (str): - Project ID for this request. - resource (str): - Name or id of the resource for this request. - zone (str): - The name of the zone for this request. + nodes (Sequence[str]): + Names of the nodes to delete. """ - options_requested_policy_version = proto.Field( - proto.INT32, number=499220029, optional=True, - ) - project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) - zone = proto.Field(proto.STRING, number=3744684,) - + nodes = proto.RepeatedField(proto.STRING, number=104993457,) -class GetScreenshotInstanceRequest(proto.Message): - r"""A request message for Instances.GetScreenshot. See the method - description for details. +class NodeGroupsListNodes(proto.Message): + r""" Attributes: - instance (str): - Name of the instance scoping this request. - project (str): - Project ID for this request. - zone (str): - The name of the zone for this request. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.NodeGroupNode]): + A list of Node resources. + kind (str): + [Output Only] The resource type, which is always + compute.nodeGroupsListNodes for the list of nodes in the + specified node group. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - instance = proto.Field(proto.STRING, number=18257045,) - project = proto.Field(proto.STRING, number=227560217,) - zone = proto.Field(proto.STRING, number=3744684,) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="NodeGroupNode", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class GetSerialPortOutputInstanceRequest(proto.Message): - r"""A request message for Instances.GetSerialPortOutput. See the - method description for details. +class NodeGroupsScopedList(proto.Message): + r""" Attributes: - instance (str): - Name of the instance for this request. - port (int): - Specifies which COM or serial port to - retrieve data from. - project (str): - Project ID for this request. - start (int): - Specifies the starting byte position of the output to - return. To start with the first byte of output to the - specified port, omit this field or set it to ``0``. - - If the output for that byte position is available, this - field matches the ``start`` parameter sent with the request. - If the amount of serial console output exceeds the size of - the buffer (1 MB), the oldest output is discarded and is no - longer available. If the requested start position refers to - discarded output, the start position is adjusted to the - oldest output still available, and the adjusted start - position is returned as the ``start`` property value. - - You can also provide a negative start position, which - translates to the most recent number of bytes written to the - serial port. For example, -3 is interpreted as the most - recent 3 bytes written to the serial console. - zone (str): - The name of the zone for this request. + node_groups (Sequence[google.cloud.compute_v1.types.NodeGroup]): + [Output Only] A list of node groups contained in this scope. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] An informational warning that appears when the + nodeGroup list is empty. """ - instance = proto.Field(proto.STRING, number=18257045,) - port = proto.Field(proto.INT32, number=3446913, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - start = proto.Field(proto.INT64, number=109757538, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - + node_groups = proto.RepeatedField( + proto.MESSAGE, number=73188017, message="NodeGroup", + ) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class GetShieldedInstanceIdentityInstanceRequest(proto.Message): - r"""A request message for Instances.GetShieldedInstanceIdentity. - See the method description for details. +class NodeGroupsSetNodeTemplateRequest(proto.Message): + r""" Attributes: - instance (str): - Name or id of the instance scoping this - request. - project (str): - Project ID for this request. - zone (str): - The name of the zone for this request. + node_template (str): + Full or partial URL of the node template + resource to be updated for this node group. """ - instance = proto.Field(proto.STRING, number=18257045,) - project = proto.Field(proto.STRING, number=227560217,) - zone = proto.Field(proto.STRING, number=3744684,) + node_template = proto.Field(proto.STRING, number=323154455, optional=True,) -class InsertInstanceRequest(proto.Message): - r"""A request message for Instances.Insert. See the method - description for details. +class NodeTemplate(proto.Message): + r"""Represent a sole-tenant Node Template resource. You can use a + template to define properties for nodes in a node group. For + more information, read Creating node groups and instances. Attributes: - instance_resource (google.cloud.compute_v1.types.Instance): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - source_instance_template (str): - Specifies instance template to create the - instance. - This field is optional. It can be a full or - partial URL. For example, the following are all - valid URLs to an instance template: - - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate - - - projects/project/global/instanceTemplates/instanceTemplate - - global/instanceTemplates/instanceTemplate - zone (str): - The name of the zone for this request. + accelerators (Sequence[google.cloud.compute_v1.types.AcceleratorConfig]): + + cpu_overcommit_type (google.cloud.compute_v1.types.NodeTemplate.CpuOvercommitType): + CPU overcommit. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + disks (Sequence[google.cloud.compute_v1.types.LocalDisk]): + + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + kind (str): + [Output Only] The type of the resource. Always + compute#nodeTemplate for node templates. + name (str): + The name of the resource, provided by the client when + initially creating the resource. The resource name must be + 1-63 characters long, and comply with RFC1035. Specifically, + the name must be 1-63 characters long and match the regular + expression ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the + first character must be a lowercase letter, and all + following characters must be a dash, lowercase letter, or + digit, except the last character, which cannot be a dash. + node_affinity_labels (Sequence[google.cloud.compute_v1.types.NodeTemplate.NodeAffinityLabelsEntry]): + Labels to use for node affinity, which will + be used in instance scheduling. + node_type (str): + The node type to use for nodes group that are + created from this template. + node_type_flexibility (google.cloud.compute_v1.types.NodeTemplateNodeTypeFlexibility): + The flexible properties of the desired node type. Node + groups that use this node template will create nodes of a + type that matches these properties. This field is mutually + exclusive with the node_type property; you can only define + one or the other, but not both. + region (str): + [Output Only] The name of the region where the node template + resides, such as us-central1. + self_link (str): + [Output Only] Server-defined URL for the resource. + server_binding (google.cloud.compute_v1.types.ServerBinding): + Sets the binding properties for the physical server. Valid + values include: - *[Default]* RESTART_NODE_ON_ANY_SERVER: + Restarts VMs on any available physical server - + RESTART_NODE_ON_MINIMAL_SERVER: Restarts VMs on the same + physical server whenever possible See Sole-tenant node + options for more information. + status (google.cloud.compute_v1.types.NodeTemplate.Status): + [Output Only] The status of the node template. One of the + following values: CREATING, READY, and DELETING. + status_message (str): + [Output Only] An optional, human-readable explanation of the + status. """ - instance_resource = proto.Field( - proto.MESSAGE, number=215988344, message="Instance", + class CpuOvercommitType(proto.Enum): + r"""CPU overcommit.""" + UNDEFINED_CPU_OVERCOMMIT_TYPE = 0 + CPU_OVERCOMMIT_TYPE_UNSPECIFIED = 520665615 + ENABLED = 182130465 + NONE = 2402104 + + class Status(proto.Enum): + r"""[Output Only] The status of the node template. One of the following + values: CREATING, READY, and DELETING. + """ + UNDEFINED_STATUS = 0 + CREATING = 455564985 + DELETING = 528602024 + INVALID = 530283991 + READY = 77848963 + + accelerators = proto.RepeatedField( + proto.MESSAGE, number=269577064, message="AcceleratorConfig", ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - source_instance_template = proto.Field( - proto.STRING, number=332423616, optional=True, + cpu_overcommit_type = proto.Field( + proto.ENUM, number=247727959, optional=True, enum=CpuOvercommitType, ) - zone = proto.Field(proto.STRING, number=3744684,) - + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + disks = proto.RepeatedField(proto.MESSAGE, number=95594102, message="LocalDisk",) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + node_affinity_labels = proto.MapField(proto.STRING, proto.STRING, number=339007161,) + node_type = proto.Field(proto.STRING, number=465832791, optional=True,) + node_type_flexibility = proto.Field( + proto.MESSAGE, + number=315257905, + optional=True, + message="NodeTemplateNodeTypeFlexibility", + ) + region = proto.Field(proto.STRING, number=138946292, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + server_binding = proto.Field( + proto.MESSAGE, number=208179593, optional=True, message="ServerBinding", + ) + status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) + status_message = proto.Field(proto.STRING, number=297428154, optional=True,) -class ListInstancesRequest(proto.Message): - r"""A request message for Instances.List. See the method - description for details. +class NodeTemplateAggregatedList(proto.Message): + r""" Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.NodeTemplateAggregatedList.ItemsEntry]): + A list of NodeTemplatesScopedList resources. + kind (str): + [Output Only] Type of resource.Always + compute#nodeTemplateAggregatedList for aggregated lists of + node templates. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + @property + def raw_page(self): + return self - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.MapField( + proto.STRING, + proto.MESSAGE, + number=100526016, + message="NodeTemplatesScopedList", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. - zone (str): - The name of the zone for this request. +class NodeTemplateList(proto.Message): + r"""Contains a list of node templates. + Attributes: + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.NodeTemplate]): + A list of NodeTemplate resources. + kind (str): + [Output Only] Type of resource.Always + compute#nodeTemplateList for lists of node templates. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="NodeTemplate", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class ListReferrersInstancesRequest(proto.Message): - r"""A request message for Instances.ListReferrers. See the method - description for details. +class NodeTemplateNodeTypeFlexibility(proto.Message): + r""" Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + cpus (str): - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - instance (str): - Name of the target instance scoping this - request, or '-' if the request should span over - all instances in the container. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. + local_ssd (str): - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. + memory (str): - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. - zone (str): - The name of the zone for this request. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - instance = proto.Field(proto.STRING, number=18257045,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - + cpus = proto.Field(proto.STRING, number=3060683, optional=True,) + local_ssd = proto.Field(proto.STRING, number=405741360, optional=True,) + memory = proto.Field(proto.STRING, number=532856065, optional=True,) -class RemoveResourcePoliciesInstanceRequest(proto.Message): - r"""A request message for Instances.RemoveResourcePolicies. See - the method description for details. +class NodeTemplatesScopedList(proto.Message): + r""" Attributes: - instance (str): - The instance name for this request. - instances_remove_resource_policies_request_resource (google.cloud.compute_v1.types.InstancesRemoveResourcePoliciesRequest): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. + node_templates (Sequence[google.cloud.compute_v1.types.NodeTemplate]): + [Output Only] A list of node templates contained in this + scope. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] An informational warning that appears when the + node templates list is empty. """ - instance = proto.Field(proto.STRING, number=18257045,) - instances_remove_resource_policies_request_resource = proto.Field( - proto.MESSAGE, - number=49229558, - message="InstancesRemoveResourcePoliciesRequest", + node_templates = proto.RepeatedField( + proto.MESSAGE, number=354111804, message="NodeTemplate", + ) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) -class ResetInstanceRequest(proto.Message): - r"""A request message for Instances.Reset. See the method - description for details. +class NodeType(proto.Message): + r"""Represent a sole-tenant Node Type resource. Each node within + a node group must have a node type. A node type specifies the + total amount of cores and memory for that node. Currently, the + only available node type is n1-node-96-624 node type that has 96 + vCPUs and 624 GB of memory, available in multiple zones. For + more information read Node types. Attributes: - instance (str): - Name of the instance scoping this request. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + cpu_platform (str): + [Output Only] The CPU platform used by this node type. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + deprecated (google.cloud.compute_v1.types.DeprecationStatus): + [Output Only] The deprecation status associated with this + node type. + description (str): + [Output Only] An optional textual description of the + resource. + guest_cpus (int): + [Output Only] The number of virtual CPUs that are available + to the node type. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + kind (str): + [Output Only] The type of the resource. Always + compute#nodeType for node types. + local_ssd_gb (int): + [Output Only] Local SSD available to the node type, defined + in GB. + memory_mb (int): + [Output Only] The amount of physical memory available to the + node type, defined in MB. + name (str): + [Output Only] Name of the resource. + self_link (str): + [Output Only] Server-defined URL for the resource. zone (str): - The name of the zone for this request. + [Output Only] The name of the zone where the node type + resides, such as us-central1-a. """ - instance = proto.Field(proto.STRING, number=18257045,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - + cpu_platform = proto.Field(proto.STRING, number=410285354, optional=True,) + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + deprecated = proto.Field( + proto.MESSAGE, number=515138995, optional=True, message="DeprecationStatus", + ) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + guest_cpus = proto.Field(proto.INT32, number=393356754, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + local_ssd_gb = proto.Field(proto.INT32, number=329237578, optional=True,) + memory_mb = proto.Field(proto.INT32, number=116001171, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + zone = proto.Field(proto.STRING, number=3744684, optional=True,) -class SetDeletionProtectionInstanceRequest(proto.Message): - r"""A request message for Instances.SetDeletionProtection. See - the method description for details. +class NodeTypeAggregatedList(proto.Message): + r""" Attributes: - deletion_protection (bool): - Whether the resource should be protected - against deletion. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - resource (str): - Name or id of the resource for this request. - zone (str): - The name of the zone for this request. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.NodeTypeAggregatedList.ItemsEntry]): + A list of NodeTypesScopedList resources. + kind (str): + [Output Only] Type of resource.Always + compute#nodeTypeAggregatedList for aggregated lists of node + types. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - deletion_protection = proto.Field(proto.BOOL, number=458014698, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - resource = proto.Field(proto.STRING, number=195806222,) - zone = proto.Field(proto.STRING, number=3744684,) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.MapField( + proto.STRING, proto.MESSAGE, number=100526016, message="NodeTypesScopedList", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class SetDiskAutoDeleteInstanceRequest(proto.Message): - r"""A request message for Instances.SetDiskAutoDelete. See the - method description for details. +class NodeTypeList(proto.Message): + r"""Contains a list of node types. Attributes: - auto_delete (bool): - Whether to auto-delete the disk when the - instance is deleted. - device_name (str): - The device name of the disk to modify. Make a - get() request on the instance to view currently - attached disks and device names. - instance (str): - The instance name for this request. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.NodeType]): + A list of NodeType resources. + kind (str): + [Output Only] Type of resource.Always compute#nodeTypeList + for lists of node types. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - auto_delete = proto.Field(proto.BOOL, number=464761403,) - device_name = proto.Field(proto.STRING, number=67541716,) - instance = proto.Field(proto.STRING, number=18257045,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="NodeType",) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class SetIamPolicyInstanceRequest(proto.Message): - r"""A request message for Instances.SetIamPolicy. See the method - description for details. +class NodeTypesScopedList(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - resource (str): - Name or id of the resource for this request. - zone (str): - The name of the zone for this request. - zone_set_policy_request_resource (google.cloud.compute_v1.types.ZoneSetPolicyRequest): - The body resource for this request + node_types (Sequence[google.cloud.compute_v1.types.NodeType]): + [Output Only] A list of node types contained in this scope. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] An informational warning that appears when the + node types list is empty. """ - project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) - zone = proto.Field(proto.STRING, number=3744684,) - zone_set_policy_request_resource = proto.Field( - proto.MESSAGE, number=382082107, message="ZoneSetPolicyRequest", + node_types = proto.RepeatedField( + proto.MESSAGE, number=482172924, message="NodeType", + ) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", ) -class SetLabelsInstanceRequest(proto.Message): - r"""A request message for Instances.SetLabels. See the method - description for details. +class NotificationEndpoint(proto.Message): + r"""Represents a notification endpoint. A notification endpoint + resource defines an endpoint to receive notifications when there + are status changes detected by the associated health check + service. For more information, see Health checks overview. Attributes: - instance (str): - Name of the instance scoping this request. - instances_set_labels_request_resource (google.cloud.compute_v1.types.InstancesSetLabelsRequest): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + grpc_settings (google.cloud.compute_v1.types.NotificationEndpointGrpcSettings): + Settings of the gRPC notification endpoint + including the endpoint URL and the retry + duration. + id (int): + [Output Only] A unique identifier for this resource type. + The server generates this identifier. + kind (str): + [Output Only] Type of the resource. Always + compute#notificationEndpoint for notification endpoints. + name (str): + Name of the resource. Provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. + region (str): + [Output Only] URL of the region where the notification + endpoint resides. This field applies only to the regional + resource. You must specify this field as part of the HTTP + request URL. It is not settable as a field in the request + body. + self_link (str): + [Output Only] Server-defined URL for the resource. """ - instance = proto.Field(proto.STRING, number=18257045,) - instances_set_labels_request_resource = proto.Field( - proto.MESSAGE, number=207749344, message="InstancesSetLabelsRequest", + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + grpc_settings = proto.Field( + proto.MESSAGE, + number=456139556, + optional=True, + message="NotificationEndpointGrpcSettings", ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + region = proto.Field(proto.STRING, number=138946292, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) -class SetMachineResourcesInstanceRequest(proto.Message): - r"""A request message for Instances.SetMachineResources. See the - method description for details. +class NotificationEndpointGrpcSettings(proto.Message): + r"""Represents a gRPC setting that describes one gRPC + notification endpoint and the retry duration attempting to send + notification to this endpoint. Attributes: - instance (str): - Name of the instance scoping this request. - instances_set_machine_resources_request_resource (google.cloud.compute_v1.types.InstancesSetMachineResourcesRequest): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. + authority (str): + Optional. If specified, this field is used to + set the authority header by the sender of + notifications. See + https://tools.ietf.org/html/rfc7540#section-8.1.2.3 + endpoint (str): + Endpoint to which gRPC notifications are + sent. This must be a valid gRPCLB DNS name. + payload_name (str): + Optional. If specified, this field is used to + populate the "name" field in gRPC requests. + resend_interval (google.cloud.compute_v1.types.Duration): + Optional. This field is used to configure how + often to send a full update of all non-healthy + backends. If unspecified, full updates are not + sent. If specified, must be in the range between + 600 seconds to 3600 seconds. Nanos are + disallowed. + retry_duration_sec (int): + How much time (in seconds) is spent + attempting notification retries until a + successful response is received. Default is 30s. + Limit is 20m (1200s). Must be a positive number. """ - instance = proto.Field(proto.STRING, number=18257045,) - instances_set_machine_resources_request_resource = proto.Field( - proto.MESSAGE, number=196286318, message="InstancesSetMachineResourcesRequest", + authority = proto.Field(proto.STRING, number=401868611, optional=True,) + endpoint = proto.Field(proto.STRING, number=130489749, optional=True,) + payload_name = proto.Field(proto.STRING, number=300358300, optional=True,) + resend_interval = proto.Field( + proto.MESSAGE, number=478288969, optional=True, message="Duration", ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - + retry_duration_sec = proto.Field(proto.UINT32, number=115681117, optional=True,) -class SetMachineTypeInstanceRequest(proto.Message): - r"""A request message for Instances.SetMachineType. See the - method description for details. +class NotificationEndpointList(proto.Message): + r""" Attributes: - instance (str): - Name of the instance scoping this request. - instances_set_machine_type_request_resource (google.cloud.compute_v1.types.InstancesSetMachineTypeRequest): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.NotificationEndpoint]): + A list of NotificationEndpoint resources. + kind (str): + [Output Only] Type of the resource. Always + compute#notificationEndpoint for notification endpoints. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - instance = proto.Field(proto.STRING, number=18257045,) - instances_set_machine_type_request_resource = proto.Field( - proto.MESSAGE, number=254157709, message="InstancesSetMachineTypeRequest", + @property + def raw_page(self): + return self + + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="NotificationEndpoint", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) -class SetMetadataInstanceRequest(proto.Message): - r"""A request message for Instances.SetMetadata. See the method - description for details. +class Operation(proto.Message): + r"""Represents an Operation resource. Google Compute Engine has three + Operation resources: \* + `Global `__ \* + `Regional `__ \* + `Zonal `__ You can + use an operation resource to manage asynchronous API requests. For + more information, read Handling API responses. Operations can be + global, regional or zonal. - For global operations, use the + ``globalOperations`` resource. - For regional operations, use the + ``regionOperations`` resource. - For zonal operations, use the + ``zonalOperations`` resource. For more information, read Global, + Regional, and Zonal Resources. Attributes: - instance (str): - Name of the instance scoping this request. - metadata_resource (google.cloud.compute_v1.types.Metadata): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + client_operation_id (str): + [Output Only] The value of ``requestId`` if you provided it + in the request. Not present otherwise. + creation_timestamp (str): + [Deprecated] This field is deprecated. + description (str): + [Output Only] A textual description of the operation, which + is set when the operation is created. + end_time (str): + [Output Only] The time that this operation was completed. + This value is in RFC3339 text format. + error (google.cloud.compute_v1.types.Error): + [Output Only] If errors are generated during processing of + the operation, this field will be populated. + http_error_message (str): + [Output Only] If the operation fails, this field contains + the HTTP error message that was returned, such as + ``NOT FOUND``. + http_error_status_code (int): + [Output Only] If the operation fails, this field contains + the HTTP error status code that was returned. For example, a + ``404`` means the resource was not found. + id (int): + [Output Only] The unique identifier for the operation. This + identifier is defined by the server. + insert_time (str): + [Output Only] The time that this operation was requested. + This value is in RFC3339 text format. + kind (str): + [Output Only] Type of the resource. Always + ``compute#operation`` for Operation resources. + name (str): + [Output Only] Name of the operation. + operation_group_id (str): + [Output Only] An ID that represents a group of operations, + such as when a group of operations results from a + ``bulkInsert`` API request. + operation_type (str): + [Output Only] The type of operation, such as ``insert``, + ``update``, or ``delete``, and so on. + progress (int): + [Output Only] An optional progress indicator that ranges + from 0 to 100. There is no requirement that this be linear + or support any granularity of operations. This should not be + used to guess when the operation will be complete. This + number should monotonically increase as the operation + progresses. + region (str): + [Output Only] The URL of the region where the operation + resides. Only applicable when performing regional + operations. + self_link (str): + [Output Only] Server-defined URL for the resource. + start_time (str): + [Output Only] The time that this operation was started by + the server. This value is in RFC3339 text format. + status (google.cloud.compute_v1.types.Operation.Status): + [Output Only] The status of the operation, which can be one + of the following: ``PENDING``, ``RUNNING``, or ``DONE``. + status_message (str): + [Output Only] An optional textual description of the current + status of the operation. + target_id (int): + [Output Only] The unique target ID, which identifies a + specific incarnation of the target resource. + target_link (str): + [Output Only] The URL of the resource that the operation + modifies. For operations related to creating a snapshot, + this points to the persistent disk that the snapshot was + created from. + user (str): + [Output Only] User who requested the operation, for example: + ``user@example.com``. + warnings (Sequence[google.cloud.compute_v1.types.Warnings]): + [Output Only] If warning messages are generated during + processing of the operation, this field will be populated. zone (str): - The name of the zone for this request. + [Output Only] The URL of the zone where the operation + resides. Only applicable when performing per-zone + operations. """ - instance = proto.Field(proto.STRING, number=18257045,) - metadata_resource = proto.Field( - proto.MESSAGE, number=291086110, message="Metadata", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + class Status(proto.Enum): + r"""[Output Only] The status of the operation, which can be one of the + following: ``PENDING``, ``RUNNING``, or ``DONE``. + """ + UNDEFINED_STATUS = 0 + DONE = 2104194 + PENDING = 35394935 + RUNNING = 121282975 + client_operation_id = proto.Field(proto.STRING, number=297240295, optional=True,) + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + end_time = proto.Field(proto.STRING, number=114938801, optional=True,) + error = proto.Field(proto.MESSAGE, number=96784904, optional=True, message="Error",) + http_error_message = proto.Field(proto.STRING, number=202521945, optional=True,) + http_error_status_code = proto.Field(proto.INT32, number=312345196, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + insert_time = proto.Field(proto.STRING, number=433722515, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + operation_group_id = proto.Field(proto.STRING, number=40171187, optional=True,) + operation_type = proto.Field(proto.STRING, number=177650450, optional=True,) + progress = proto.Field(proto.INT32, number=72663597, optional=True,) + region = proto.Field(proto.STRING, number=138946292, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + start_time = proto.Field(proto.STRING, number=37467274, optional=True,) + status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) + status_message = proto.Field(proto.STRING, number=297428154, optional=True,) + target_id = proto.Field(proto.UINT64, number=258165385, optional=True,) + target_link = proto.Field(proto.STRING, number=62671336, optional=True,) + user = proto.Field(proto.STRING, number=3599307, optional=True,) + warnings = proto.RepeatedField(proto.MESSAGE, number=498091095, message="Warnings",) + zone = proto.Field(proto.STRING, number=3744684, optional=True,) -class SetMinCpuPlatformInstanceRequest(proto.Message): - r"""A request message for Instances.SetMinCpuPlatform. See the - method description for details. +class OperationAggregatedList(proto.Message): + r""" Attributes: - instance (str): - Name of the instance scoping this request. - instances_set_min_cpu_platform_request_resource (google.cloud.compute_v1.types.InstancesSetMinCpuPlatformRequest): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. + id (str): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + items (Sequence[google.cloud.compute_v1.types.OperationAggregatedList.ItemsEntry]): + [Output Only] A map of scoped operation lists. + kind (str): + [Output Only] Type of resource. Always + ``compute#operationAggregatedList`` for aggregated lists of + operations. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than ``maxResults``, use the ``nextPageToken`` as a + value for the query parameter ``pageToken`` in the next list + request. Subsequent list requests will have their own + ``nextPageToken`` to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - instance = proto.Field(proto.STRING, number=18257045,) - instances_set_min_cpu_platform_request_resource = proto.Field( - proto.MESSAGE, number=148459368, message="InstancesSetMinCpuPlatformRequest", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - - -class SetSchedulingInstanceRequest(proto.Message): - r"""A request message for Instances.SetScheduling. See the method - description for details. - - Attributes: - instance (str): - Instance name for this request. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - scheduling_resource (google.cloud.compute_v1.types.Scheduling): - The body resource for this request - zone (str): - The name of the zone for this request. - """ + @property + def raw_page(self): + return self - instance = proto.Field(proto.STRING, number=18257045,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - scheduling_resource = proto.Field( - proto.MESSAGE, number=463181401, message="Scheduling", + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.MapField( + proto.STRING, proto.MESSAGE, number=100526016, message="OperationsScopedList", ) - zone = proto.Field(proto.STRING, number=3744684,) - - -class SetServiceAccountInstanceRequest(proto.Message): - r"""A request message for Instances.SetServiceAccount. See the - method description for details. - - Attributes: - instance (str): - Name of the instance resource to start. - instances_set_service_account_request_resource (google.cloud.compute_v1.types.InstancesSetServiceAccountRequest): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. - """ - - instance = proto.Field(proto.STRING, number=18257045,) - instances_set_service_account_request_resource = proto.Field( - proto.MESSAGE, number=275550008, message="InstancesSetServiceAccountRequest", + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - -class SetShieldedInstanceIntegrityPolicyInstanceRequest(proto.Message): - r"""A request message for - Instances.SetShieldedInstanceIntegrityPolicy. See the method - description for details. +class OperationList(proto.Message): + r"""Contains a list of Operation resources. Attributes: - instance (str): - Name or id of the instance scoping this - request. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - shielded_instance_integrity_policy_resource (google.cloud.compute_v1.types.ShieldedInstanceIntegrityPolicy): - The body resource for this request - zone (str): - The name of the zone for this request. + id (str): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + items (Sequence[google.cloud.compute_v1.types.Operation]): + [Output Only] A list of Operation resources. + kind (str): + [Output Only] Type of resource. Always + ``compute#operations`` for Operations resource. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than ``maxResults``, use the ``nextPageToken`` as a + value for the query parameter ``pageToken`` in the next list + request. Subsequent list requests will have their own + ``nextPageToken`` to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - instance = proto.Field(proto.STRING, number=18257045,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - shielded_instance_integrity_policy_resource = proto.Field( - proto.MESSAGE, number=409169462, message="ShieldedInstanceIntegrityPolicy", - ) - zone = proto.Field(proto.STRING, number=3744684,) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Operation",) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class SetTagsInstanceRequest(proto.Message): - r"""A request message for Instances.SetTags. See the method - description for details. +class OperationsScopedList(proto.Message): + r""" Attributes: - instance (str): - Name of the instance scoping this request. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - tags_resource (google.cloud.compute_v1.types.Tags): - The body resource for this request - zone (str): - The name of the zone for this request. + operations (Sequence[google.cloud.compute_v1.types.Operation]): + [Output Only] A list of operations contained in this scope. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning which replaces the list + of operations when the list is empty. """ - instance = proto.Field(proto.STRING, number=18257045,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - tags_resource = proto.Field(proto.MESSAGE, number=331435380, message="Tags",) - zone = proto.Field(proto.STRING, number=3744684,) + operations = proto.RepeatedField( + proto.MESSAGE, number=4184044, message="Operation", + ) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class SimulateMaintenanceEventInstanceRequest(proto.Message): - r"""A request message for Instances.SimulateMaintenanceEvent. See - the method description for details. +class OutlierDetection(proto.Message): + r"""Settings controlling the eviction of unhealthy hosts from the + load balancing pool for the backend service. Attributes: - instance (str): - Name of the instance scoping this request. - project (str): - Project ID for this request. - zone (str): - The name of the zone for this request. + base_ejection_time (google.cloud.compute_v1.types.Duration): + The base time that a host is ejected for. The + real ejection time is equal to the base ejection + time multiplied by the number of times the host + has been ejected. Defaults to 30000ms or 30s. + consecutive_errors (int): + Number of errors before a host is ejected + from the connection pool. When the backend host + is accessed over HTTP, a 5xx return code + qualifies as an error. Defaults to 5. + consecutive_gateway_failure (int): + The number of consecutive gateway failures + (502, 503, 504 status or connection errors that + are mapped to one of those status codes) before + a consecutive gateway failure ejection occurs. + Defaults to 3. + enforcing_consecutive_errors (int): + The percentage chance that a host will be + actually ejected when an outlier status is + detected through consecutive 5xx. This setting + can be used to disable ejection or to ramp it up + slowly. Defaults to 0. + enforcing_consecutive_gateway_failure (int): + The percentage chance that a host will be + actually ejected when an outlier status is + detected through consecutive gateway failures. + This setting can be used to disable ejection or + to ramp it up slowly. Defaults to 100. + enforcing_success_rate (int): + The percentage chance that a host will be + actually ejected when an outlier status is + detected through success rate statistics. This + setting can be used to disable ejection or to + ramp it up slowly. Defaults to 100. + interval (google.cloud.compute_v1.types.Duration): + Time interval between ejection analysis + sweeps. This can result in both new ejections as + well as hosts being returned to service. + Defaults to 1 second. + max_ejection_percent (int): + Maximum percentage of hosts in the load + balancing pool for the backend service that can + be ejected. Defaults to 50%. + success_rate_minimum_hosts (int): + The number of hosts in a cluster that must + have enough request volume to detect success + rate outliers. If the number of hosts is less + than this setting, outlier detection via success + rate statistics is not performed for any host in + the cluster. Defaults to 5. + success_rate_request_volume (int): + The minimum number of total requests that + must be collected in one interval (as defined by + the interval duration above) to include this + host in success rate based outlier detection. If + the volume is lower than this setting, outlier + detection via success rate statistics is not + performed for that host. Defaults to 100. + success_rate_stdev_factor (int): + This factor is used to determine the ejection threshold for + success rate outlier ejection. The ejection threshold is the + difference between the mean success rate, and the product of + this factor and the standard deviation of the mean success + rate: mean - (stdev \* success_rate_stdev_factor). This + factor is divided by a thousand to get a double. That is, if + the desired factor is 1.9, the runtime value should be 1900. + Defaults to 1900. """ - instance = proto.Field(proto.STRING, number=18257045,) - project = proto.Field(proto.STRING, number=227560217,) - zone = proto.Field(proto.STRING, number=3744684,) + base_ejection_time = proto.Field( + proto.MESSAGE, number=80997255, optional=True, message="Duration", + ) + consecutive_errors = proto.Field(proto.INT32, number=387193248, optional=True,) + consecutive_gateway_failure = proto.Field( + proto.INT32, number=417504250, optional=True, + ) + enforcing_consecutive_errors = proto.Field( + proto.INT32, number=213133760, optional=True, + ) + enforcing_consecutive_gateway_failure = proto.Field( + proto.INT32, number=394440666, optional=True, + ) + enforcing_success_rate = proto.Field(proto.INT32, number=194508732, optional=True,) + interval = proto.Field( + proto.MESSAGE, number=33547461, optional=True, message="Duration", + ) + max_ejection_percent = proto.Field(proto.INT32, number=18436888, optional=True,) + success_rate_minimum_hosts = proto.Field( + proto.INT32, number=525766903, optional=True, + ) + success_rate_request_volume = proto.Field( + proto.INT32, number=281425357, optional=True, + ) + success_rate_stdev_factor = proto.Field( + proto.INT32, number=174735773, optional=True, + ) -class StartInstanceRequest(proto.Message): - r"""A request message for Instances.Start. See the method - description for details. +class PacketMirroring(proto.Message): + r"""Represents a Packet Mirroring resource. Packet Mirroring + clones the traffic of specified instances in your Virtual + Private Cloud (VPC) network and forwards it to a collector + destination, such as an instance group of an internal TCP/UDP + load balancer, for analysis or examination. For more information + about setting up Packet Mirroring, see Using Packet Mirroring. Attributes: - instance (str): - Name of the instance resource to start. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. + collector_ilb (google.cloud.compute_v1.types.PacketMirroringForwardingRuleInfo): + The Forwarding Rule resource of type + loadBalancingScheme=INTERNAL that will be used + as collector for mirrored traffic. The specified + forwarding rule must have isMirroringCollector + set to true. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + enable (google.cloud.compute_v1.types.PacketMirroring.Enable): + Indicates whether or not this packet + mirroring takes effect. If set to FALSE, this + packet mirroring policy will not be enforced on + the network. The default is TRUE. + filter (google.cloud.compute_v1.types.PacketMirroringFilter): + Filter for mirrored traffic. If unspecified, + all traffic is mirrored. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + kind (str): + [Output Only] Type of the resource. Always + compute#packetMirroring for packet mirrorings. + mirrored_resources (google.cloud.compute_v1.types.PacketMirroringMirroredResourceInfo): + PacketMirroring mirroredResourceInfos. + MirroredResourceInfo specifies a set of mirrored + VM instances, subnetworks and/or tags for which + traffic from/to all VM instances will be + mirrored. + name (str): + Name of the resource; provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. + network (google.cloud.compute_v1.types.PacketMirroringNetworkInfo): + Specifies the mirrored VPC network. Only + packets in this network will be mirrored. All + mirrored VMs should have a NIC in the given + network. All mirrored subnetworks should belong + to the given network. + priority (int): + The priority of applying this configuration. + Priority is used to break ties in cases where + there is more than one matching rule. In the + case of two rules that apply for a given + Instance, the one with the lowest-numbered + priority value wins. Default value is 1000. + Valid range is 0 through 65535. + region (str): + [Output Only] URI of the region where the packetMirroring + resides. + self_link (str): + [Output Only] Server-defined URL for the resource. """ - instance = proto.Field(proto.STRING, number=18257045,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + class Enable(proto.Enum): + r"""Indicates whether or not this packet mirroring takes effect. + If set to FALSE, this packet mirroring policy will not be + enforced on the network. The default is TRUE. + """ + UNDEFINED_ENABLE = 0 + FALSE = 66658563 + TRUE = 2583950 + collector_ilb = proto.Field( + proto.MESSAGE, + number=426607853, + optional=True, + message="PacketMirroringForwardingRuleInfo", + ) + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + enable = proto.Field(proto.ENUM, number=311764355, optional=True, enum=Enable,) + filter = proto.Field( + proto.MESSAGE, number=336120696, optional=True, message="PacketMirroringFilter", + ) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + mirrored_resources = proto.Field( + proto.MESSAGE, + number=124817348, + optional=True, + message="PacketMirroringMirroredResourceInfo", + ) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + network = proto.Field( + proto.MESSAGE, + number=232872494, + optional=True, + message="PacketMirroringNetworkInfo", + ) + priority = proto.Field(proto.UINT32, number=445151652, optional=True,) + region = proto.Field(proto.STRING, number=138946292, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) -class StartWithEncryptionKeyInstanceRequest(proto.Message): - r"""A request message for Instances.StartWithEncryptionKey. See - the method description for details. +class PacketMirroringAggregatedList(proto.Message): + r"""Contains a list of packetMirrorings. Attributes: - instance (str): - Name of the instance resource to start. - instances_start_with_encryption_key_request_resource (google.cloud.compute_v1.types.InstancesStartWithEncryptionKeyRequest): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.PacketMirroringAggregatedList.ItemsEntry]): + A list of PacketMirroring resources. + kind (str): + Type of resource. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - instance = proto.Field(proto.STRING, number=18257045,) - instances_start_with_encryption_key_request_resource = proto.Field( + @property + def raw_page(self): + return self + + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.MapField( + proto.STRING, proto.MESSAGE, - number=441712511, - message="InstancesStartWithEncryptionKeyRequest", + number=100526016, + message="PacketMirroringsScopedList", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - -class StopInstanceRequest(proto.Message): - r"""A request message for Instances.Stop. See the method - description for details. +class PacketMirroringFilter(proto.Message): + r""" Attributes: - instance (str): - Name of the instance resource to stop. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. + I_p_protocols (Sequence[str]): + Protocols that apply as filter on mirrored + traffic. If no protocols are specified, all + traffic that matches the specified CIDR ranges + is mirrored. If neither cidrRanges nor + IPProtocols is specified, all traffic is + mirrored. + cidr_ranges (Sequence[str]): + IP CIDR ranges that apply as filter on the + source (ingress) or destination (egress) IP in + the IP header. Only IPv4 is supported. If no + ranges are specified, all traffic that matches + the specified IPProtocols is mirrored. If + neither cidrRanges nor IPProtocols is specified, + all traffic is mirrored. + direction (google.cloud.compute_v1.types.PacketMirroringFilter.Direction): + Direction of traffic to mirror, either + INGRESS, EGRESS, or BOTH. The default is BOTH. """ - instance = proto.Field(proto.STRING, number=18257045,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + class Direction(proto.Enum): + r"""Direction of traffic to mirror, either INGRESS, EGRESS, or + BOTH. The default is BOTH. + """ + UNDEFINED_DIRECTION = 0 + BOTH = 2044801 + EGRESS = 432880501 + INGRESS = 516931221 + I_p_protocols = proto.RepeatedField(proto.STRING, number=98544854,) + cidr_ranges = proto.RepeatedField(proto.STRING, number=487901697,) + direction = proto.Field( + proto.ENUM, number=111150975, optional=True, enum=Direction, + ) -class TestIamPermissionsInstanceRequest(proto.Message): - r"""A request message for Instances.TestIamPermissions. See the - method description for details. +class PacketMirroringForwardingRuleInfo(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - resource (str): - Name or id of the resource for this request. - test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): - The body resource for this request - zone (str): - The name of the zone for this request. + canonical_url (str): + [Output Only] Unique identifier for the forwarding rule; + defined by the server. + url (str): + Resource URL to the forwarding rule + representing the ILB configured as destination + of the mirrored traffic. """ - project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) - test_permissions_request_resource = proto.Field( - proto.MESSAGE, number=439214758, message="TestPermissionsRequest", - ) - zone = proto.Field(proto.STRING, number=3744684,) - + canonical_url = proto.Field(proto.STRING, number=512294820, optional=True,) + url = proto.Field(proto.STRING, number=116079, optional=True,) -class UpdateInstanceRequest(proto.Message): - r"""A request message for Instances.Update. See the method - description for details. +class PacketMirroringList(proto.Message): + r"""Contains a list of PacketMirroring resources. Attributes: - instance (str): - Name of the instance resource to update. - instance_resource (google.cloud.compute_v1.types.Instance): - The body resource for this request - minimal_action (str): - Specifies the action to take when updating an - instance even if the updated properties do not - require it. If not specified, then Compute - Engine acts based on the minimum action that the - updated properties require. - most_disruptive_allowed_action (str): - Specifies the most disruptive action that can be taken on - the instance as part of the update. Compute Engine returns - an error if the instance properties require a more - disruptive action as part of the instance update. Valid - options from lowest to highest are NO_EFFECT, REFRESH, and - RESTART. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.PacketMirroring]): + A list of PacketMirroring resources. + kind (str): + [Output Only] Type of resource. Always + compute#packetMirroring for packetMirrorings. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - instance = proto.Field(proto.STRING, number=18257045,) - instance_resource = proto.Field( - proto.MESSAGE, number=215988344, message="Instance", + @property + def raw_page(self): + return self + + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="PacketMirroring", ) - minimal_action = proto.Field(proto.STRING, number=270567060, optional=True,) - most_disruptive_allowed_action = proto.Field( - proto.STRING, number=66103053, optional=True, + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - -class UpdateAccessConfigInstanceRequest(proto.Message): - r"""A request message for Instances.UpdateAccessConfig. See the - method description for details. +class PacketMirroringMirroredResourceInfo(proto.Message): + r""" Attributes: - access_config_resource (google.cloud.compute_v1.types.AccessConfig): - The body resource for this request - instance (str): - The instance name for this request. - network_interface (str): - The name of the network interface where the - access config is attached. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. + instances (Sequence[google.cloud.compute_v1.types.PacketMirroringMirroredResourceInfoInstanceInfo]): + A set of virtual machine instances that are + being mirrored. They must live in zones + contained in the same region as this + packetMirroring. Note that this config will + apply only to those network interfaces of the + Instances that belong to the network specified + in this packetMirroring. You may specify a + maximum of 50 Instances. + subnetworks (Sequence[google.cloud.compute_v1.types.PacketMirroringMirroredResourceInfoSubnetInfo]): + A set of subnetworks for which traffic + from/to all VM instances will be mirrored. They + must live in the same region as this + packetMirroring. You may specify a maximum of 5 + subnetworks. + tags (Sequence[str]): + A set of mirrored tags. Traffic from/to all + VM instances that have one or more of these tags + will be mirrored. """ - access_config_resource = proto.Field( - proto.MESSAGE, number=387825552, message="AccessConfig", + instances = proto.RepeatedField( + proto.MESSAGE, + number=29097598, + message="PacketMirroringMirroredResourceInfoInstanceInfo", ) - instance = proto.Field(proto.STRING, number=18257045,) - network_interface = proto.Field(proto.STRING, number=365387880,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - + subnetworks = proto.RepeatedField( + proto.MESSAGE, + number=415853125, + message="PacketMirroringMirroredResourceInfoSubnetInfo", + ) + tags = proto.RepeatedField(proto.STRING, number=3552281,) -class UpdateDisplayDeviceInstanceRequest(proto.Message): - r"""A request message for Instances.UpdateDisplayDevice. See the - method description for details. +class PacketMirroringMirroredResourceInfoInstanceInfo(proto.Message): + r""" Attributes: - display_device_resource (google.cloud.compute_v1.types.DisplayDevice): - The body resource for this request - instance (str): - Name of the instance scoping this request. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. + canonical_url (str): + [Output Only] Unique identifier for the instance; defined by + the server. + url (str): + Resource URL to the virtual machine instance + which is being mirrored. """ - display_device_resource = proto.Field( - proto.MESSAGE, number=289686106, message="DisplayDevice", - ) - instance = proto.Field(proto.STRING, number=18257045,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - + canonical_url = proto.Field(proto.STRING, number=512294820, optional=True,) + url = proto.Field(proto.STRING, number=116079, optional=True,) -class UpdateNetworkInterfaceInstanceRequest(proto.Message): - r"""A request message for Instances.UpdateNetworkInterface. See - the method description for details. +class PacketMirroringMirroredResourceInfoSubnetInfo(proto.Message): + r""" Attributes: - instance (str): - The instance name for this request. - network_interface (str): - The name of the network interface to update. - network_interface_resource (google.cloud.compute_v1.types.NetworkInterface): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. + canonical_url (str): + [Output Only] Unique identifier for the subnetwork; defined + by the server. + url (str): + Resource URL to the subnetwork for which + traffic from/to all VM instances will be + mirrored. """ - instance = proto.Field(proto.STRING, number=18257045,) - network_interface = proto.Field(proto.STRING, number=365387880,) - network_interface_resource = proto.Field( - proto.MESSAGE, number=325814789, message="NetworkInterface", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - + canonical_url = proto.Field(proto.STRING, number=512294820, optional=True,) + url = proto.Field(proto.STRING, number=116079, optional=True,) -class UpdateShieldedInstanceConfigInstanceRequest(proto.Message): - r"""A request message for Instances.UpdateShieldedInstanceConfig. - See the method description for details. +class PacketMirroringNetworkInfo(proto.Message): + r""" Attributes: - instance (str): - Name or id of the instance scoping this - request. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - shielded_instance_config_resource (google.cloud.compute_v1.types.ShieldedInstanceConfig): - The body resource for this request - zone (str): - The name of the zone for this request. + canonical_url (str): + [Output Only] Unique identifier for the network; defined by + the server. + url (str): + URL of the network resource. """ - instance = proto.Field(proto.STRING, number=18257045,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - shielded_instance_config_resource = proto.Field( - proto.MESSAGE, number=272059224, message="ShieldedInstanceConfig", - ) - zone = proto.Field(proto.STRING, number=3744684,) - + canonical_url = proto.Field(proto.STRING, number=512294820, optional=True,) + url = proto.Field(proto.STRING, number=116079, optional=True,) -class AggregatedListInterconnectAttachmentsRequest(proto.Message): - r"""A request message for InterconnectAttachments.AggregatedList. - See the method description for details. +class PacketMirroringsScopedList(proto.Message): + r""" Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + packet_mirrorings (Sequence[google.cloud.compute_v1.types.PacketMirroring]): + A list of packetMirrorings contained in this + scope. + warning (google.cloud.compute_v1.types.Warning): + Informational warning which replaces the list + of packetMirrorings when the list is empty. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + packet_mirrorings = proto.RepeatedField( + proto.MESSAGE, number=154615079, message="PacketMirroring", + ) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class DeleteInterconnectAttachmentRequest(proto.Message): - r"""A request message for InterconnectAttachments.Delete. See the - method description for details. +class PatchAutoscalerRequest(proto.Message): + r"""A request message for Autoscalers.Patch. See the method + description for details. - Attributes: - interconnect_attachment (str): - Name of the interconnect attachment to - delete. + Attributes: + autoscaler (str): + Name of the autoscaler to patch. + autoscaler_resource (google.cloud.compute_v1.types.Autoscaler): + The body resource for this request project (str): Project ID for this request. - region (str): - Name of the region for this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + Name of the zone for this request. """ - interconnect_attachment = proto.Field(proto.STRING, number=308135284,) + autoscaler = proto.Field(proto.STRING, number=517258967, optional=True,) + autoscaler_resource = proto.Field( + proto.MESSAGE, number=207616118, message="Autoscaler", + ) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class GetInterconnectAttachmentRequest(proto.Message): - r"""A request message for InterconnectAttachments.Get. See the - method description for details. +class PatchBackendBucketRequest(proto.Message): + r"""A request message for BackendBuckets.Patch. See the method + description for details. Attributes: - interconnect_attachment (str): - Name of the interconnect attachment to - return. + backend_bucket (str): + Name of the BackendBucket resource to patch. + backend_bucket_resource (google.cloud.compute_v1.types.BackendBucket): + The body resource for this request project (str): Project ID for this request. - region (str): - Name of the region for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - interconnect_attachment = proto.Field(proto.STRING, number=308135284,) + backend_bucket = proto.Field(proto.STRING, number=91714037,) + backend_bucket_resource = proto.Field( + proto.MESSAGE, number=380757784, message="BackendBucket", + ) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class InsertInterconnectAttachmentRequest(proto.Message): - r"""A request message for InterconnectAttachments.Insert. See the - method description for details. +class PatchBackendServiceRequest(proto.Message): + r"""A request message for BackendServices.Patch. See the method + description for details. Attributes: - interconnect_attachment_resource (google.cloud.compute_v1.types.InterconnectAttachment): + backend_service (str): + Name of the BackendService resource to patch. + backend_service_resource (google.cloud.compute_v1.types.BackendService): The body resource for this request project (str): Project ID for this request. - region (str): - Name of the region for this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - validate_only (bool): - If true, the request will not be committed. + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - interconnect_attachment_resource = proto.Field( - proto.MESSAGE, number=212341369, message="InterconnectAttachment", + backend_service = proto.Field(proto.STRING, number=306946058,) + backend_service_resource = proto.Field( + proto.MESSAGE, number=347586723, message="BackendService", ) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - validate_only = proto.Field(proto.BOOL, number=242744629, optional=True,) -class ListInterconnectAttachmentsRequest(proto.Message): - r"""A request message for InterconnectAttachments.List. See the - method description for details. +class PatchFirewallPolicyRequest(proto.Message): + r"""A request message for FirewallPolicies.Patch. See the method + description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + firewall_policy (str): + Name of the firewall policy to update. + firewall_policy_resource (google.cloud.compute_v1.types.FirewallPolicy): + The body resource for this request + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + firewall_policy = proto.Field(proto.STRING, number=498173265,) + firewall_policy_resource = proto.Field( + proto.MESSAGE, number=495049532, message="FirewallPolicy", + ) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. +class PatchFirewallRequest(proto.Message): + r"""A request message for Firewalls.Patch. See the method + description for details. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. + Attributes: + firewall (str): + Name of the firewall rule to patch. + firewall_resource (google.cloud.compute_v1.types.Firewall): + The body resource for this request project (str): Project ID for this request. - region (str): - Name of the region for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + firewall = proto.Field(proto.STRING, number=511016192,) + firewall_resource = proto.Field(proto.MESSAGE, number=41425005, message="Firewall",) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class PatchInterconnectAttachmentRequest(proto.Message): - r"""A request message for InterconnectAttachments.Patch. See the - method description for details. +class PatchForwardingRuleRequest(proto.Message): + r"""A request message for ForwardingRules.Patch. See the method + description for details. Attributes: - interconnect_attachment (str): - Name of the interconnect attachment to patch. - interconnect_attachment_resource (google.cloud.compute_v1.types.InterconnectAttachment): + forwarding_rule (str): + Name of the ForwardingRule resource to patch. + forwarding_rule_resource (google.cloud.compute_v1.types.ForwardingRule): The body resource for this request project (str): Project ID for this request. @@ -34492,122 +33643,110 @@ class PatchInterconnectAttachmentRequest(proto.Message): Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - interconnect_attachment = proto.Field(proto.STRING, number=308135284,) - interconnect_attachment_resource = proto.Field( - proto.MESSAGE, number=212341369, message="InterconnectAttachment", + forwarding_rule = proto.Field(proto.STRING, number=269964030,) + forwarding_rule_resource = proto.Field( + proto.MESSAGE, number=301211695, message="ForwardingRule", ) project = proto.Field(proto.STRING, number=227560217,) region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class GetInterconnectLocationRequest(proto.Message): - r"""A request message for InterconnectLocations.Get. See the +class PatchGlobalForwardingRuleRequest(proto.Message): + r"""A request message for GlobalForwardingRules.Patch. See the method description for details. Attributes: - interconnect_location (str): - Name of the interconnect location to return. + forwarding_rule (str): + Name of the ForwardingRule resource to patch. + forwarding_rule_resource (google.cloud.compute_v1.types.ForwardingRule): + The body resource for this request project (str): Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - interconnect_location = proto.Field(proto.STRING, number=492235846,) + forwarding_rule = proto.Field(proto.STRING, number=269964030,) + forwarding_rule_resource = proto.Field( + proto.MESSAGE, number=301211695, message="ForwardingRule", + ) project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class ListInterconnectLocationsRequest(proto.Message): - r"""A request message for InterconnectLocations.List. See the - method description for details. +class PatchGlobalPublicDelegatedPrefixeRequest(proto.Message): + r"""A request message for GlobalPublicDelegatedPrefixes.Patch. + See the method description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. project (str): Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + public_delegated_prefix (str): + Name of the PublicDelegatedPrefix resource to + patch. + public_delegated_prefix_resource (google.cloud.compute_v1.types.PublicDelegatedPrefix): + The body resource for this request + request_id (str): + An optional request ID to identify requests. Specify a + unique request ID so that if you must retry your request, + the server will know to ignore the request if it has already + been completed. For example, consider a situation where you + make an initial request and the request times out. If you + make the request again with the same request ID, the server + can check if original operation with the same request ID was + received, and if so, will ignore the second request. This + prevents clients from accidentally creating duplicate + commitments. The request ID must be a valid UUID with the + exception that zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). end_interface: + MixerMutationRequestBuilder """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + public_delegated_prefix = proto.Field(proto.STRING, number=204238440,) + public_delegated_prefix_resource = proto.Field( + proto.MESSAGE, number=47594501, message="PublicDelegatedPrefix", + ) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class DeleteInterconnectRequest(proto.Message): - r"""A request message for Interconnects.Delete. See the method +class PatchHealthCheckRequest(proto.Message): + r"""A request message for HealthChecks.Patch. See the method description for details. Attributes: - interconnect (str): - Name of the interconnect to delete. + health_check (str): + Name of the HealthCheck resource to patch. + health_check_resource (google.cloud.compute_v1.types.HealthCheck): + The body resource for this request project (str): Project ID for this request. request_id (str): @@ -34615,60 +33754,70 @@ class DeleteInterconnectRequest(proto.Message): Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - interconnect = proto.Field(proto.STRING, number=224601230,) + health_check = proto.Field(proto.STRING, number=308876645,) + health_check_resource = proto.Field( + proto.MESSAGE, number=201925032, message="HealthCheck", + ) project = proto.Field(proto.STRING, number=227560217,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class GetInterconnectRequest(proto.Message): - r"""A request message for Interconnects.Get. See the method +class PatchImageRequest(proto.Message): + r"""A request message for Images.Patch. See the method description for details. Attributes: - interconnect (str): - Name of the interconnect to return. + image (str): + Name of the image resource to patch. + image_resource (google.cloud.compute_v1.types.Image): + The body resource for this request project (str): Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - interconnect = proto.Field(proto.STRING, number=224601230,) + image = proto.Field(proto.STRING, number=100313435,) + image_resource = proto.Field(proto.MESSAGE, number=371171954, message="Image",) project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class GetDiagnosticsInterconnectRequest(proto.Message): - r"""A request message for Interconnects.GetDiagnostics. See the +class PatchInstanceGroupManagerRequest(proto.Message): + r"""A request message for InstanceGroupManagers.Patch. See the method description for details. Attributes: - interconnect (str): - Name of the interconnect resource to query. - project (str): - Project ID for this request. - """ - - interconnect = proto.Field(proto.STRING, number=224601230,) - project = proto.Field(proto.STRING, number=227560217,) - - -class InsertInterconnectRequest(proto.Message): - r"""A request message for Interconnects.Insert. See the method - description for details. - - Attributes: - interconnect_resource (google.cloud.compute_v1.types.Interconnect): + instance_group_manager (str): + The name of the instance group manager. + instance_group_manager_resource (google.cloud.compute_v1.types.InstanceGroupManager): The body resource for this request project (str): Project ID for this request. @@ -34677,96 +33826,69 @@ class InsertInterconnectRequest(proto.Message): Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone where you want to create + the managed instance group. """ - interconnect_resource = proto.Field( - proto.MESSAGE, number=397611167, message="Interconnect", + instance_group_manager = proto.Field(proto.STRING, number=249363395,) + instance_group_manager_resource = proto.Field( + proto.MESSAGE, number=261063946, message="InstanceGroupManager", ) project = proto.Field(proto.STRING, number=227560217,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class ListInterconnectsRequest(proto.Message): - r"""A request message for Interconnects.List. See the method - description for details. +class PatchInterconnectAttachmentRequest(proto.Message): + r"""A request message for InterconnectAttachments.Patch. See the + method description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. + interconnect_attachment (str): + Name of the interconnect attachment to patch. + interconnect_attachment_resource (google.cloud.compute_v1.types.InterconnectAttachment): + The body resource for this request project (str): Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + region (str): + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + interconnect_attachment = proto.Field(proto.STRING, number=308135284,) + interconnect_attachment_resource = proto.Field( + proto.MESSAGE, number=212341369, message="InterconnectAttachment", + ) project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) class PatchInterconnectRequest(proto.Message): @@ -34785,17 +33907,17 @@ class PatchInterconnectRequest(proto.Message): Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ interconnect = proto.Field(proto.STRING, number=224601230,) @@ -34806,49 +33928,15 @@ class PatchInterconnectRequest(proto.Message): request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class GetLicenseCodeRequest(proto.Message): - r"""A request message for LicenseCodes.Get. See the method +class PatchNetworkRequest(proto.Message): + r"""A request message for Networks.Patch. See the method description for details. Attributes: - license_code (str): - Number corresponding to the License code - resource to return. - project (str): - Project ID for this request. - """ - - license_code = proto.Field(proto.STRING, number=1467179,) - project = proto.Field(proto.STRING, number=227560217,) - - -class TestIamPermissionsLicenseCodeRequest(proto.Message): - r"""A request message for LicenseCodes.TestIamPermissions. See - the method description for details. - - Attributes: - project (str): - Project ID for this request. - resource (str): - Name or id of the resource for this request. - test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): + network (str): + Name of the network to update. + network_resource (google.cloud.compute_v1.types.Network): The body resource for this request - """ - - project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) - test_permissions_request_resource = proto.Field( - proto.MESSAGE, number=439214758, message="TestPermissionsRequest", - ) - - -class DeleteLicenseRequest(proto.Message): - r"""A request message for Licenses.Delete. See the method - description for details. - - Attributes: - license_ (str): - Name of the license resource to delete. project (str): Project ID for this request. request_id (str): @@ -34856,858 +33944,681 @@ class DeleteLicenseRequest(proto.Message): Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - license_ = proto.Field(proto.STRING, number=166757441,) + network = proto.Field(proto.STRING, number=232872494,) + network_resource = proto.Field(proto.MESSAGE, number=122105599, message="Network",) project = proto.Field(proto.STRING, number=227560217,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class GetLicenseRequest(proto.Message): - r"""A request message for Licenses.Get. See the method - description for details. - - Attributes: - license_ (str): - Name of the License resource to return. - project (str): - Project ID for this request. - """ - - license_ = proto.Field(proto.STRING, number=166757441,) - project = proto.Field(proto.STRING, number=227560217,) - - -class GetIamPolicyLicenseRequest(proto.Message): - r"""A request message for Licenses.GetIamPolicy. See the method +class PatchNodeGroupRequest(proto.Message): + r"""A request message for NodeGroups.Patch. See the method description for details. Attributes: - options_requested_policy_version (int): - Requested IAM Policy version. + node_group (str): + Name of the NodeGroup resource to update. + node_group_resource (google.cloud.compute_v1.types.NodeGroup): + The body resource for this request project (str): Project ID for this request. - resource (str): - Name or id of the resource for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. """ - options_requested_policy_version = proto.Field( - proto.INT32, number=499220029, optional=True, + node_group = proto.Field(proto.STRING, number=469958146,) + node_group_resource = proto.Field( + proto.MESSAGE, number=505321899, message="NodeGroup", ) project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class InsertLicenseRequest(proto.Message): - r"""A request message for Licenses.Insert. See the method +class PatchPacketMirroringRequest(proto.Message): + r"""A request message for PacketMirrorings.Patch. See the method description for details. Attributes: - license_resource (google.cloud.compute_v1.types.License): + packet_mirroring (str): + Name of the PacketMirroring resource to + patch. + packet_mirroring_resource (google.cloud.compute_v1.types.PacketMirroring): The body resource for this request project (str): Project ID for this request. + region (str): + Name of the region for this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - license_resource = proto.Field(proto.MESSAGE, number=437955148, message="License",) + packet_mirroring = proto.Field(proto.STRING, number=22305996,) + packet_mirroring_resource = proto.Field( + proto.MESSAGE, number=493501985, message="PacketMirroring", + ) project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class ListLicensesRequest(proto.Message): - r"""A request message for Licenses.List. See the method +class PatchPerInstanceConfigsInstanceGroupManagerRequest(proto.Message): + r"""A request message for + InstanceGroupManagers.PatchPerInstanceConfigs. See the method description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. + instance_group_manager (str): + The name of the managed instance group. It + should conform to RFC1035. + instance_group_managers_patch_per_instance_configs_req_resource (google.cloud.compute_v1.types.InstanceGroupManagersPatchPerInstanceConfigsReq): + The body resource for this request project (str): Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone where the managed + instance group is located. It should conform to + RFC1035. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + instance_group_manager = proto.Field(proto.STRING, number=249363395,) + instance_group_managers_patch_per_instance_configs_req_resource = proto.Field( + proto.MESSAGE, + number=356650495, + message="InstanceGroupManagersPatchPerInstanceConfigsReq", + ) project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class SetIamPolicyLicenseRequest(proto.Message): - r"""A request message for Licenses.SetIamPolicy. See the method - description for details. +class PatchPerInstanceConfigsRegionInstanceGroupManagerRequest(proto.Message): + r"""A request message for + RegionInstanceGroupManagers.PatchPerInstanceConfigs. See the + method description for details. Attributes: - global_set_policy_request_resource (google.cloud.compute_v1.types.GlobalSetPolicyRequest): - The body resource for this request + instance_group_manager (str): + The name of the managed instance group. It + should conform to RFC1035. project (str): Project ID for this request. - resource (str): - Name or id of the resource for this request. + region (str): + Name of the region scoping this request, + should conform to RFC1035. + region_instance_group_manager_patch_instance_config_req_resource (google.cloud.compute_v1.types.RegionInstanceGroupManagerPatchInstanceConfigReq): + The body resource for this request + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - global_set_policy_request_resource = proto.Field( - proto.MESSAGE, number=337048498, message="GlobalSetPolicyRequest", - ) + instance_group_manager = proto.Field(proto.STRING, number=249363395,) project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) + region = proto.Field(proto.STRING, number=138946292,) + region_instance_group_manager_patch_instance_config_req_resource = proto.Field( + proto.MESSAGE, + number=197682890, + message="RegionInstanceGroupManagerPatchInstanceConfigReq", + ) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class TestIamPermissionsLicenseRequest(proto.Message): - r"""A request message for Licenses.TestIamPermissions. See the +class PatchPublicAdvertisedPrefixeRequest(proto.Message): + r"""A request message for PublicAdvertisedPrefixes.Patch. See the method description for details. Attributes: project (str): Project ID for this request. - resource (str): - Name or id of the resource for this request. - test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): + public_advertised_prefix (str): + Name of the PublicAdvertisedPrefix resource + to patch. + public_advertised_prefix_resource (google.cloud.compute_v1.types.PublicAdvertisedPrefix): The body resource for this request + request_id (str): + An optional request ID to identify requests. Specify a + unique request ID so that if you must retry your request, + the server will know to ignore the request if it has already + been completed. For example, consider a situation where you + make an initial request and the request times out. If you + make the request again with the same request ID, the server + can check if original operation with the same request ID was + received, and if so, will ignore the second request. This + prevents clients from accidentally creating duplicate + commitments. The request ID must be a valid UUID with the + exception that zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). end_interface: + MixerMutationRequestBuilder """ project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) - test_permissions_request_resource = proto.Field( - proto.MESSAGE, number=439214758, message="TestPermissionsRequest", + public_advertised_prefix = proto.Field(proto.STRING, number=101874590,) + public_advertised_prefix_resource = proto.Field( + proto.MESSAGE, number=233614223, message="PublicAdvertisedPrefix", ) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class AggregatedListMachineTypesRequest(proto.Message): - r"""A request message for MachineTypes.AggregatedList. See the +class PatchPublicDelegatedPrefixeRequest(proto.Message): + r"""A request message for PublicDelegatedPrefixes.Patch. See the method description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. project (str): Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + public_delegated_prefix (str): + Name of the PublicDelegatedPrefix resource to + patch. + public_delegated_prefix_resource (google.cloud.compute_v1.types.PublicDelegatedPrefix): + The body resource for this request + region (str): + Name of the region for this request. + request_id (str): + An optional request ID to identify requests. Specify a + unique request ID so that if you must retry your request, + the server will know to ignore the request if it has already + been completed. For example, consider a situation where you + make an initial request and the request times out. If you + make the request again with the same request ID, the server + can check if original operation with the same request ID was + received, and if so, will ignore the second request. This + prevents clients from accidentally creating duplicate + commitments. The request ID must be a valid UUID with the + exception that zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). end_interface: + MixerMutationRequestBuilder """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + public_delegated_prefix = proto.Field(proto.STRING, number=204238440,) + public_delegated_prefix_resource = proto.Field( + proto.MESSAGE, number=47594501, message="PublicDelegatedPrefix", + ) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class GetMachineTypeRequest(proto.Message): - r"""A request message for MachineTypes.Get. See the method +class PatchRegionAutoscalerRequest(proto.Message): + r"""A request message for RegionAutoscalers.Patch. See the method description for details. Attributes: - machine_type (str): - Name of the machine type to return. + autoscaler (str): + Name of the autoscaler to patch. + autoscaler_resource (google.cloud.compute_v1.types.Autoscaler): + The body resource for this request project (str): Project ID for this request. - zone (str): - The name of the zone for this request. + region (str): + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - machine_type = proto.Field(proto.STRING, number=227711026,) + autoscaler = proto.Field(proto.STRING, number=517258967, optional=True,) + autoscaler_resource = proto.Field( + proto.MESSAGE, number=207616118, message="Autoscaler", + ) project = proto.Field(proto.STRING, number=227560217,) - zone = proto.Field(proto.STRING, number=3744684,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class ListMachineTypesRequest(proto.Message): - r"""A request message for MachineTypes.List. See the method - description for details. +class PatchRegionBackendServiceRequest(proto.Message): + r"""A request message for RegionBackendServices.Patch. See the + method description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. + backend_service (str): + Name of the BackendService resource to patch. + backend_service_resource (google.cloud.compute_v1.types.BackendService): + The body resource for this request project (str): Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. - zone (str): - The name of the zone for this request. + region (str): + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + backend_service = proto.Field(proto.STRING, number=306946058,) + backend_service_resource = proto.Field( + proto.MESSAGE, number=347586723, message="BackendService", + ) project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class AggregatedListNetworkEndpointGroupsRequest(proto.Message): - r"""A request message for NetworkEndpointGroups.AggregatedList. - See the method description for details. +class PatchRegionHealthCheckRequest(proto.Message): + r"""A request message for RegionHealthChecks.Patch. See the + method description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. + health_check (str): + Name of the HealthCheck resource to patch. + health_check_resource (google.cloud.compute_v1.types.HealthCheck): + The body resource for this request project (str): Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + region (str): + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + health_check = proto.Field(proto.STRING, number=308876645,) + health_check_resource = proto.Field( + proto.MESSAGE, number=201925032, message="HealthCheck", + ) project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class AttachNetworkEndpointsNetworkEndpointGroupRequest(proto.Message): - r"""A request message for - NetworkEndpointGroups.AttachNetworkEndpoints. See the method - description for details. +class PatchRegionHealthCheckServiceRequest(proto.Message): + r"""A request message for RegionHealthCheckServices.Patch. See + the method description for details. Attributes: - network_endpoint_group (str): - The name of the network endpoint group where - you are attaching network endpoints to. It - should comply with RFC1035. - network_endpoint_groups_attach_endpoints_request_resource (google.cloud.compute_v1.types.NetworkEndpointGroupsAttachEndpointsRequest): + health_check_service (str): + Name of the HealthCheckService to update. The + name must be 1-63 characters long, and comply + with RFC1035. + health_check_service_resource (google.cloud.compute_v1.types.HealthCheckService): The body resource for this request project (str): Project ID for this request. + region (str): + Name of the region scoping this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone where the network - endpoint group is located. It should comply with - RFC1035. + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - network_endpoint_group = proto.Field(proto.STRING, number=433907078,) - network_endpoint_groups_attach_endpoints_request_resource = proto.Field( - proto.MESSAGE, - number=531079, - message="NetworkEndpointGroupsAttachEndpointsRequest", + health_check_service = proto.Field(proto.STRING, number=408374747,) + health_check_service_resource = proto.Field( + proto.MESSAGE, number=477367794, message="HealthCheckService", ) project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) -class DeleteNetworkEndpointGroupRequest(proto.Message): - r"""A request message for NetworkEndpointGroups.Delete. See the - method description for details. +class PatchRegionInstanceGroupManagerRequest(proto.Message): + r"""A request message for RegionInstanceGroupManagers.Patch. See + the method description for details. Attributes: - network_endpoint_group (str): - The name of the network endpoint group to - delete. It should comply with RFC1035. + instance_group_manager (str): + The name of the instance group manager. + instance_group_manager_resource (google.cloud.compute_v1.types.InstanceGroupManager): + The body resource for this request project (str): Project ID for this request. + region (str): + Name of the region scoping this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone where the network - endpoint group is located. It should comply with - RFC1035. + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - network_endpoint_group = proto.Field(proto.STRING, number=433907078,) + instance_group_manager = proto.Field(proto.STRING, number=249363395,) + instance_group_manager_resource = proto.Field( + proto.MESSAGE, number=261063946, message="InstanceGroupManager", + ) project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) -class DetachNetworkEndpointsNetworkEndpointGroupRequest(proto.Message): - r"""A request message for - NetworkEndpointGroups.DetachNetworkEndpoints. See the method +class PatchRegionUrlMapRequest(proto.Message): + r"""A request message for RegionUrlMaps.Patch. See the method description for details. Attributes: - network_endpoint_group (str): - The name of the network endpoint group where - you are removing network endpoints. It should - comply with RFC1035. - network_endpoint_groups_detach_endpoints_request_resource (google.cloud.compute_v1.types.NetworkEndpointGroupsDetachEndpointsRequest): + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + request_id (str): + begin_interface: MixerMutationRequestBuilder Request ID to + support idempotency. + url_map (str): + Name of the UrlMap resource to patch. + url_map_resource (google.cloud.compute_v1.types.UrlMap): The body resource for this request + """ + + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + url_map = proto.Field(proto.STRING, number=367020684,) + url_map_resource = proto.Field(proto.MESSAGE, number=168675425, message="UrlMap",) + + +class PatchRouterRequest(proto.Message): + r"""A request message for Routers.Patch. See the method + description for details. + + Attributes: project (str): Project ID for this request. + region (str): + Name of the region for this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone where the network - endpoint group is located. It should comply with - RFC1035. + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + router (str): + Name of the Router resource to patch. + router_resource (google.cloud.compute_v1.types.Router): + The body resource for this request """ - network_endpoint_group = proto.Field(proto.STRING, number=433907078,) - network_endpoint_groups_detach_endpoints_request_resource = proto.Field( - proto.MESSAGE, - number=515608697, - message="NetworkEndpointGroupsDetachEndpointsRequest", - ) project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - - -class GetNetworkEndpointGroupRequest(proto.Message): - r"""A request message for NetworkEndpointGroups.Get. See the - method description for details. - - Attributes: - network_endpoint_group (str): - The name of the network endpoint group. It - should comply with RFC1035. - project (str): - Project ID for this request. - zone (str): - The name of the zone where the network - endpoint group is located. It should comply with - RFC1035. - """ - - network_endpoint_group = proto.Field(proto.STRING, number=433907078,) - project = proto.Field(proto.STRING, number=227560217,) - zone = proto.Field(proto.STRING, number=3744684,) + router = proto.Field(proto.STRING, number=148608841,) + router_resource = proto.Field(proto.MESSAGE, number=155222084, message="Router",) -class InsertNetworkEndpointGroupRequest(proto.Message): - r"""A request message for NetworkEndpointGroups.Insert. See the +class PatchRuleFirewallPolicyRequest(proto.Message): + r"""A request message for FirewallPolicies.PatchRule. See the method description for details. Attributes: - network_endpoint_group_resource (google.cloud.compute_v1.types.NetworkEndpointGroup): + firewall_policy (str): + Name of the firewall policy to update. + firewall_policy_rule_resource (google.cloud.compute_v1.types.FirewallPolicyRule): The body resource for this request - project (str): - Project ID for this request. + priority (int): + The priority of the rule to patch. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone where you want to create - the network endpoint group. It should comply - with RFC1035. + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - network_endpoint_group_resource = proto.Field( - proto.MESSAGE, number=525788839, message="NetworkEndpointGroup", + firewall_policy = proto.Field(proto.STRING, number=498173265,) + firewall_policy_rule_resource = proto.Field( + proto.MESSAGE, number=250523523, message="FirewallPolicyRule", ) - project = proto.Field(proto.STRING, number=227560217,) + priority = proto.Field(proto.INT32, number=445151652, optional=True,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) -class ListNetworkEndpointGroupsRequest(proto.Message): - r"""A request message for NetworkEndpointGroups.List. See the +class PatchRuleSecurityPolicyRequest(proto.Message): + r"""A request message for SecurityPolicies.PatchRule. See the method description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. + priority (int): + The priority of the rule to patch. project (str): Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. - zone (str): - The name of the zone where the network - endpoint group is located. It should comply with - RFC1035. + security_policy (str): + Name of the security policy to update. + security_policy_rule_resource (google.cloud.compute_v1.types.SecurityPolicyRule): + The body resource for this request """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + priority = proto.Field(proto.INT32, number=445151652, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + security_policy = proto.Field(proto.STRING, number=171082513,) + security_policy_rule_resource = proto.Field( + proto.MESSAGE, number=402693443, message="SecurityPolicyRule", + ) -class ListNetworkEndpointsNetworkEndpointGroupsRequest(proto.Message): - r"""A request message for - NetworkEndpointGroups.ListNetworkEndpoints. See the method +class PatchSecurityPolicyRequest(proto.Message): + r"""A request message for SecurityPolicies.Patch. See the method description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - network_endpoint_group (str): - The name of the network endpoint group from - which you want to generate a list of included - network endpoints. It should comply with - RFC1035. - network_endpoint_groups_list_endpoints_request_resource (google.cloud.compute_v1.types.NetworkEndpointGroupsListEndpointsRequest): - The body resource for this request - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. project (str): Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. - zone (str): - The name of the zone where the network - endpoint group is located. It should comply with - RFC1035. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + security_policy (str): + Name of the security policy to update. + security_policy_resource (google.cloud.compute_v1.types.SecurityPolicy): + The body resource for this request """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - network_endpoint_group = proto.Field(proto.STRING, number=433907078,) - network_endpoint_groups_list_endpoints_request_resource = proto.Field( - proto.MESSAGE, - number=59493390, - message="NetworkEndpointGroupsListEndpointsRequest", - ) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + security_policy = proto.Field(proto.STRING, number=171082513,) + security_policy_resource = proto.Field( + proto.MESSAGE, number=216159612, message="SecurityPolicy", + ) -class TestIamPermissionsNetworkEndpointGroupRequest(proto.Message): - r"""A request message for - NetworkEndpointGroups.TestIamPermissions. See the method - description for details. +class PatchServiceAttachmentRequest(proto.Message): + r"""A request message for ServiceAttachments.Patch. See the + method description for details. Attributes: project (str): Project ID for this request. - resource (str): - Name or id of the resource for this request. - test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): + region (str): + The region scoping this request and should + conform to RFC1035. + request_id (str): + An optional request ID to identify requests. Specify a + unique request ID so that if you must retry your request, + the server will know to ignore the request if it has already + been completed. For example, consider a situation where you + make an initial request and the request times out. If you + make the request again with the same request ID, the server + can check if original operation with the same request ID was + received, and if so, will ignore the second request. This + prevents clients from accidentally creating duplicate + commitments. The request ID must be a valid UUID with the + exception that zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). end_interface: + MixerMutationRequestBuilder + service_attachment (str): + The resource id of the ServiceAttachment to + patch. It should conform to RFC1035 resource + name or be a string form on an unsigned long + number. + service_attachment_resource (google.cloud.compute_v1.types.ServiceAttachment): The body resource for this request - zone (str): - The name of the zone for this request. """ project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) - test_permissions_request_resource = proto.Field( - proto.MESSAGE, number=439214758, message="TestPermissionsRequest", + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + service_attachment = proto.Field(proto.STRING, number=338957549,) + service_attachment_resource = proto.Field( + proto.MESSAGE, number=472980256, message="ServiceAttachment", ) - zone = proto.Field(proto.STRING, number=3744684,) -class AddPeeringNetworkRequest(proto.Message): - r"""A request message for Networks.AddPeering. See the method +class PatchSslPolicyRequest(proto.Message): + r"""A request message for SslPolicies.Patch. See the method description for details. Attributes: - network (str): - Name of the network resource to add peering - to. - networks_add_peering_request_resource (google.cloud.compute_v1.types.NetworksAddPeeringRequest): - The body resource for this request project (str): Project ID for this request. request_id (str): @@ -35715,96 +34626,198 @@ class AddPeeringNetworkRequest(proto.Message): Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + ssl_policy (str): + Name of the SSL policy to update. The name + must be 1-63 characters long, and comply with + RFC1035. + ssl_policy_resource (google.cloud.compute_v1.types.SslPolicy): + The body resource for this request """ - network = proto.Field(proto.STRING, number=232872494,) - networks_add_peering_request_resource = proto.Field( - proto.MESSAGE, number=388810421, message="NetworksAddPeeringRequest", - ) project = proto.Field(proto.STRING, number=227560217,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + ssl_policy = proto.Field(proto.STRING, number=295190213,) + ssl_policy_resource = proto.Field( + proto.MESSAGE, number=274891848, message="SslPolicy", + ) -class DeleteNetworkRequest(proto.Message): - r"""A request message for Networks.Delete. See the method +class PatchSubnetworkRequest(proto.Message): + r"""A request message for Subnetworks.Patch. See the method description for details. Attributes: - network (str): - Name of the network to delete. + drain_timeout_seconds (int): + The drain timeout specifies the upper bound in seconds on + the amount of time allowed to drain connections from the + current ACTIVE subnetwork to the current BACKUP subnetwork. + The drain timeout is only applicable when the following + conditions are true: - the subnetwork being patched has + purpose = INTERNAL_HTTPS_LOAD_BALANCER - the subnetwork + being patched has role = BACKUP - the patch request is + setting the role to ACTIVE. Note that after this patch + operation the roles of the ACTIVE and BACKUP subnetworks + will be swapped. project (str): Project ID for this request. + region (str): + Name of the region scoping this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + subnetwork (str): + Name of the Subnetwork resource to patch. + subnetwork_resource (google.cloud.compute_v1.types.Subnetwork): + The body resource for this request """ - network = proto.Field(proto.STRING, number=232872494,) + drain_timeout_seconds = proto.Field(proto.INT32, number=357707098, optional=True,) project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + subnetwork = proto.Field(proto.STRING, number=307827694,) + subnetwork_resource = proto.Field( + proto.MESSAGE, number=42233151, message="Subnetwork", + ) -class GetNetworkRequest(proto.Message): - r"""A request message for Networks.Get. See the method +class PatchTargetGrpcProxyRequest(proto.Message): + r"""A request message for TargetGrpcProxies.Patch. See the method description for details. Attributes: - network (str): - Name of the network to return. project (str): Project ID for this request. + request_id (str): + An optional request ID to identify requests. Specify a + unique request ID so that if you must retry your request, + the server will know to ignore the request if it has already + been completed. For example, consider a situation where you + make an initial request and the request times out. If you + make the request again with the same request ID, the server + can check if original operation with the same request ID was + received, and if so, will ignore the second request. This + prevents clients from accidentally creating duplicate + commitments. The request ID must be a valid UUID with the + exception that zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). end_interface: + MixerMutationRequestBuilder + target_grpc_proxy (str): + Name of the TargetGrpcProxy resource to + patch. + target_grpc_proxy_resource (google.cloud.compute_v1.types.TargetGrpcProxy): + The body resource for this request """ - network = proto.Field(proto.STRING, number=232872494,) project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_grpc_proxy = proto.Field(proto.STRING, number=5020283,) + target_grpc_proxy_resource = proto.Field( + proto.MESSAGE, number=328922450, message="TargetGrpcProxy", + ) -class GetEffectiveFirewallsNetworkRequest(proto.Message): - r"""A request message for Networks.GetEffectiveFirewalls. See the +class PatchTargetHttpProxyRequest(proto.Message): + r"""A request message for TargetHttpProxies.Patch. See the method + description for details. + + Attributes: + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. Specify a + unique request ID so that if you must retry your request, + the server will know to ignore the request if it has already + been completed. For example, consider a situation where you + make an initial request and the request times out. If you + make the request again with the same request ID, the server + can check if original operation with the same request ID was + received, and if so, will ignore the second request. This + prevents clients from accidentally creating duplicate + commitments. The request ID must be a valid UUID with the + exception that zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). end_interface: + MixerMutationRequestBuilder + target_http_proxy (str): + Name of the TargetHttpProxy resource to + patch. + target_http_proxy_resource (google.cloud.compute_v1.types.TargetHttpProxy): + The body resource for this request + """ + + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_http_proxy = proto.Field(proto.STRING, number=206872421,) + target_http_proxy_resource = proto.Field( + proto.MESSAGE, number=24696744, message="TargetHttpProxy", + ) + + +class PatchTargetHttpsProxyRequest(proto.Message): + r"""A request message for TargetHttpsProxies.Patch. See the method description for details. Attributes: - network (str): - Name of the network for this request. project (str): Project ID for this request. + request_id (str): + An optional request ID to identify requests. Specify a + unique request ID so that if you must retry your request, + the server will know to ignore the request if it has already + been completed. For example, consider a situation where you + make an initial request and the request times out. If you + make the request again with the same request ID, the server + can check if original operation with the same request ID was + received, and if so, will ignore the second request. This + prevents clients from accidentally creating duplicate + commitments. The request ID must be a valid UUID with the + exception that zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). end_interface: + MixerMutationRequestBuilder + target_https_proxy (str): + Name of the TargetHttpsProxy resource to + patch. + target_https_proxy_resource (google.cloud.compute_v1.types.TargetHttpsProxy): + The body resource for this request """ - network = proto.Field(proto.STRING, number=232872494,) project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_https_proxy = proto.Field(proto.STRING, number=52336748,) + target_https_proxy_resource = proto.Field( + proto.MESSAGE, number=433657473, message="TargetHttpsProxy", + ) -class InsertNetworkRequest(proto.Message): - r"""A request message for Networks.Insert. See the method +class PatchUrlMapRequest(proto.Message): + r"""A request message for UrlMaps.Patch. See the method description for details. Attributes: - network_resource (google.cloud.compute_v1.types.Network): - The body resource for this request project (str): Project ID for this request. request_id (str): @@ -35812,2145 +34825,2184 @@ class InsertNetworkRequest(proto.Message): Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + url_map (str): + Name of the UrlMap resource to patch. + url_map_resource (google.cloud.compute_v1.types.UrlMap): + The body resource for this request """ - network_resource = proto.Field(proto.MESSAGE, number=122105599, message="Network",) project = proto.Field(proto.STRING, number=227560217,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + url_map = proto.Field(proto.STRING, number=367020684,) + url_map_resource = proto.Field(proto.MESSAGE, number=168675425, message="UrlMap",) -class ListNetworksRequest(proto.Message): - r"""A request message for Networks.List. See the method - description for details. +class PathMatcher(proto.Message): + r"""A matcher for the path portion of the URL. The BackendService + from the longest-matched rule will serve the URL. If no rule was + matched, the default service will be used. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + default_route_action (google.cloud.compute_v1.types.HttpRouteAction): + defaultRouteAction takes effect when none of + the pathRules or routeRules match. The load + balancer performs advanced routing actions like + URL rewrites, header transformations, etc. prior + to forwarding the request to the selected + backend. If defaultRouteAction specifies any + weightedBackendServices, defaultService must not + be set. Conversely if defaultService is set, + defaultRouteAction cannot contain any + weightedBackendServices. Only one of + defaultRouteAction or defaultUrlRedirect must be + set. UrlMaps for external HTTP(S) load balancers + support only the urlRewrite action within a + pathMatcher's defaultRouteAction. + default_service (str): + The full or partial URL to the BackendService resource. This + will be used if none of the pathRules or routeRules defined + by this PathMatcher are matched. For example, the following + are all valid URLs to a BackendService resource: - + https://www.googleapis.com/compute/v1/projects/project + /global/backendServices/backendService - + compute/v1/projects/project/global/backendServices/backendService + - global/backendServices/backendService If + defaultRouteAction is additionally specified, advanced + routing actions like URL Rewrites, etc. take effect prior to + sending the request to the backend. However, if + defaultService is specified, defaultRouteAction cannot + contain any weightedBackendServices. Conversely, if + defaultRouteAction specifies any weightedBackendServices, + defaultService must not be specified. Only one of + defaultService, defaultUrlRedirect or + defaultRouteAction.weightedBackendService must be set. + Authorization requires one or more of the following Google + IAM permissions on the specified resource default_service: - + compute.backendBuckets.use - compute.backendServices.use + default_url_redirect (google.cloud.compute_v1.types.HttpRedirectAction): + When none of the specified pathRules or + routeRules match, the request is redirected to a + URL specified by defaultUrlRedirect. If + defaultUrlRedirect is specified, defaultService + or defaultRouteAction must not be set. Not + supported when the URL map is bound to target + gRPC proxy. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + header_action (google.cloud.compute_v1.types.HttpHeaderAction): + Specifies changes to request and response + headers that need to take effect for the + selected backendService. HeaderAction specified + here are applied after the matching + HttpRouteRule HeaderAction and before the + HeaderAction in the UrlMap Note that + headerAction is not supported for Loadbalancers + that have their loadBalancingScheme set to + EXTERNAL. Not supported when the URL map is + bound to target gRPC proxy that has + validateForProxyless field set to true. + name (str): + The name to which this PathMatcher is + referred by the HostRule. + path_rules (Sequence[google.cloud.compute_v1.types.PathRule]): + The list of path rules. Use this list instead of routeRules + when routing based on simple path matching is all that's + required. The order by which path rules are specified does + not matter. Matches are always done on the + longest-path-first basis. For example: a pathRule with a + path /a/b/c/\* will match before /a/b/\* irrespective of the + order in which those paths appear in this list. Within a + given pathMatcher, only one of pathRules or routeRules must + be set. + route_rules (Sequence[google.cloud.compute_v1.types.HttpRouteRule]): + The list of HTTP route rules. Use this list + instead of pathRules when advanced route + matching and routing actions are desired. + routeRules are evaluated in order of priority, + from the lowest to highest number. Within a + given pathMatcher, you can set only one of + pathRules or routeRules. + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + default_route_action = proto.Field( + proto.MESSAGE, number=378919466, optional=True, message="HttpRouteAction", + ) + default_service = proto.Field(proto.STRING, number=370242231, optional=True,) + default_url_redirect = proto.Field( + proto.MESSAGE, number=359503338, optional=True, message="HttpRedirectAction", + ) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + header_action = proto.Field( + proto.MESSAGE, number=328077352, optional=True, message="HttpHeaderAction", + ) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + path_rules = proto.RepeatedField( + proto.MESSAGE, number=104439901, message="PathRule", + ) + route_rules = proto.RepeatedField( + proto.MESSAGE, number=376292225, message="HttpRouteRule", + ) - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. +class PathRule(proto.Message): + r"""A path-matching rule for a URL. If matched, will use the + specified BackendService to handle the traffic arriving at this + URL. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + Attributes: + paths (Sequence[str]): + The list of path patterns to match. Each must start with / + and the only place a \* is allowed is at the end following a + /. The string fed to the path matcher does not include any + text after the first ? or #, and those chars are not allowed + here. + route_action (google.cloud.compute_v1.types.HttpRouteAction): + In response to a matching path, the load + balancer performs advanced routing actions like + URL rewrites, header transformations, etc. prior + to forwarding the request to the selected + backend. If routeAction specifies any + weightedBackendServices, service must not be + set. Conversely if service is set, routeAction + cannot contain any weightedBackendServices. Only + one of routeAction or urlRedirect must be set. + UrlMaps for external HTTP(S) load balancers + support only the urlRewrite action within a + pathRule's routeAction. + service (str): + The full or partial URL of the backend + service resource to which traffic is directed if + this rule is matched. If routeAction is + additionally specified, advanced routing actions + like URL Rewrites, etc. take effect prior to + sending the request to the backend. However, if + service is specified, routeAction cannot contain + any weightedBackendService s. Conversely, if + routeAction specifies any + weightedBackendServices, service must not be + specified. Only one of urlRedirect, service or + routeAction.weightedBackendService must be set. + url_redirect (google.cloud.compute_v1.types.HttpRedirectAction): + When a path pattern is matched, the request + is redirected to a URL specified by urlRedirect. + If urlRedirect is specified, service or + routeAction must not be set. Not supported when + the URL map is bound to target gRPC proxy. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - + paths = proto.RepeatedField(proto.STRING, number=106438894,) + route_action = proto.Field( + proto.MESSAGE, number=424563948, optional=True, message="HttpRouteAction", + ) + service = proto.Field(proto.STRING, number=373540533, optional=True,) + url_redirect = proto.Field( + proto.MESSAGE, number=405147820, optional=True, message="HttpRedirectAction", + ) -class ListPeeringRoutesNetworksRequest(proto.Message): - r"""A request message for Networks.ListPeeringRoutes. See the - method description for details. +class PerInstanceConfig(proto.Message): + r""" Attributes: - direction (google.cloud.compute_v1.types.ListPeeringRoutesNetworksRequest.Direction): - The direction of the exchanged routes. - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - network (str): - Name of the network for this request. - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - peering_name (str): - The response will show routes exchanged over - the given peering connection. - project (str): - Project ID for this request. - region (str): - The region of the request. The response will - include all subnet routes, static routes and - dynamic routes in the region. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + fingerprint (str): + Fingerprint of this per-instance config. This + field can be used in optimistic locking. It is + ignored when inserting a per-instance config. An + up-to-date fingerprint must be provided in order + to update an existing per-instance config or the + field needs to be unset. + name (str): + The name of a per-instance config and its + corresponding instance. Serves as a merge key + during UpdatePerInstanceConfigs operations, that + is, if a per-instance config with the same name + exists then it will be updated, otherwise a new + one will be created for the VM instance with the + same name. An attempt to create a per-instance + config for a VM instance that either doesn't + exist or is not part of the group will result in + an error. + preserved_state (google.cloud.compute_v1.types.PreservedState): + The intended preserved state for the given + instance. Does not contain preserved state + generated from a stateful policy. + status (google.cloud.compute_v1.types.PerInstanceConfig.Status): + The status of applying this per-instance + config on the corresponding managed instance. """ - class Direction(proto.Enum): - r"""The direction of the exchanged routes.""" - UNDEFINED_DIRECTION = 0 - INCOMING = 338552870 - OUTGOING = 307438444 + class Status(proto.Enum): + r"""The status of applying this per-instance config on the + corresponding managed instance. + """ + UNDEFINED_STATUS = 0 + APPLYING = 352003508 + DELETING = 528602024 + EFFECTIVE = 244201863 + NONE = 2402104 + UNAPPLIED = 483935140 + UNAPPLIED_DELETION = 313956873 - direction = proto.Field( - proto.ENUM, number=111150975, optional=True, enum=Direction, + fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + preserved_state = proto.Field( + proto.MESSAGE, number=2634026, optional=True, message="PreservedState", ) - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - network = proto.Field(proto.STRING, number=232872494,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - peering_name = proto.Field(proto.STRING, number=249571370, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292, optional=True,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) -class PatchNetworkRequest(proto.Message): - r"""A request message for Networks.Patch. See the method - description for details. +class Policy(proto.Message): + r"""An Identity and Access Management (IAM) policy, which specifies + access controls for Google Cloud resources. A ``Policy`` is a + collection of ``bindings``. A ``binding`` binds one or more + ``members`` to a single ``role``. Members can be user accounts, + service accounts, Google groups, and domains (such as G Suite). A + ``role`` is a named list of permissions; each ``role`` can be an IAM + predefined role or a user-created custom role. For some types of + Google Cloud resources, a ``binding`` can also specify a + ``condition``, which is a logical expression that allows access to a + resource only if the expression evaluates to ``true``. A condition + can add constraints based on attributes of the request, the + resource, or both. To learn which resources support conditions in + their IAM policies, see the `IAM + documentation `__. + **JSON example:** { "bindings": [ { "role": + "roles/resourcemanager.organizationAdmin", "members": [ + "user:mike@example.com", "group:admins@example.com", + "domain:google.com", + "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { + "role": "roles/resourcemanager.organizationViewer", "members": [ + "user:eve@example.com" ], "condition": { "title": "expirable + access", "description": "Does not grant access after Sep 2020", + "expression": "request.time < + timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": + "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - + members: - user:mike@example.com - group:admins@example.com - + domain:google.com - + serviceAccount:my-project-id@appspot.gserviceaccount.com role: + roles/resourcemanager.organizationAdmin - members: - + user:eve@example.com role: roles/resourcemanager.organizationViewer + condition: title: expirable access description: Does not grant + access after Sep 2020 expression: request.time < + timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 + For a description of IAM and its features, see the `IAM + documentation `__. Attributes: - network (str): - Name of the network to update. - network_resource (google.cloud.compute_v1.types.Network): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + audit_configs (Sequence[google.cloud.compute_v1.types.AuditConfig]): + Specifies cloud audit logging configuration + for this policy. + bindings (Sequence[google.cloud.compute_v1.types.Binding]): + Associates a list of ``members`` to a ``role``. Optionally, + may specify a ``condition`` that determines how and when the + ``bindings`` are applied. Each of the ``bindings`` must + contain at least one member. + etag (str): + ``etag`` is used for optimistic concurrency control as a way + to help prevent simultaneous updates of a policy from + overwriting each other. It is strongly suggested that + systems make use of the ``etag`` in the read-modify-write + cycle to perform policy updates in order to avoid race + conditions: An ``etag`` is returned in the response to + ``getIamPolicy``, and systems are expected to put that etag + in the request to ``setIamPolicy`` to ensure that their + change will be applied to the same version of the policy. + **Important:** If you use IAM Conditions, you must include + the ``etag`` field whenever you call ``setIamPolicy``. If + you omit this field, then IAM allows you to overwrite a + version ``3`` policy with a version ``1`` policy, and all of + the conditions in the version ``3`` policy are lost. + iam_owned (bool): + This is deprecated and has no effect. Do not + use. + rules (Sequence[google.cloud.compute_v1.types.Rule]): + This is deprecated and has no effect. Do not + use. + version (int): + Specifies the format of the policy. Valid values are ``0``, + ``1``, and ``3``. Requests that specify an invalid value are + rejected. Any operation that affects conditional role + bindings must specify version ``3``. This requirement + applies to the following operations: \* Getting a policy + that includes a conditional role binding \* Adding a + conditional role binding to a policy \* Changing a + conditional role binding in a policy \* Removing any role + binding, with or without a condition, from a policy that + includes conditions **Important:** If you use IAM + Conditions, you must include the ``etag`` field whenever you + call ``setIamPolicy``. If you omit this field, then IAM + allows you to overwrite a version ``3`` policy with a + version ``1`` policy, and all of the conditions in the + version ``3`` policy are lost. If a policy does not include + any conditions, operations on that policy may specify any + valid version or leave the field unset. To learn which + resources support conditions in their IAM policies, see the + `IAM + documentation `__. """ - network = proto.Field(proto.STRING, number=232872494,) - network_resource = proto.Field(proto.MESSAGE, number=122105599, message="Network",) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - + audit_configs = proto.RepeatedField( + proto.MESSAGE, number=328080653, message="AuditConfig", + ) + bindings = proto.RepeatedField(proto.MESSAGE, number=403251854, message="Binding",) + etag = proto.Field(proto.STRING, number=3123477, optional=True,) + iam_owned = proto.Field(proto.BOOL, number=450566203, optional=True,) + rules = proto.RepeatedField(proto.MESSAGE, number=108873975, message="Rule",) + version = proto.Field(proto.INT32, number=351608024, optional=True,) -class RemovePeeringNetworkRequest(proto.Message): - r"""A request message for Networks.RemovePeering. See the method - description for details. +class PreconfiguredWafSet(proto.Message): + r""" Attributes: - network (str): - Name of the network resource to remove - peering from. - networks_remove_peering_request_resource (google.cloud.compute_v1.types.NetworksRemovePeeringRequest): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + expression_sets (Sequence[google.cloud.compute_v1.types.WafExpressionSet]): + List of entities that are currently supported + for WAF rules. """ - network = proto.Field(proto.STRING, number=232872494,) - networks_remove_peering_request_resource = proto.Field( - proto.MESSAGE, number=421162494, message="NetworksRemovePeeringRequest", + expression_sets = proto.RepeatedField( + proto.MESSAGE, number=474011032, message="WafExpressionSet", ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - -class SwitchToCustomModeNetworkRequest(proto.Message): - r"""A request message for Networks.SwitchToCustomMode. See the - method description for details. +class PreservedState(proto.Message): + r"""Preserved state for a given instance. Attributes: - network (str): - Name of the network to be updated. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + disks (Sequence[google.cloud.compute_v1.types.PreservedState.DisksEntry]): + Preserved disks defined for this instance. + This map is keyed with the device names of the + disks. + metadata (Sequence[google.cloud.compute_v1.types.PreservedState.MetadataEntry]): + Preserved metadata defined for this instance. """ - network = proto.Field(proto.STRING, number=232872494,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - + disks = proto.MapField( + proto.STRING, + proto.MESSAGE, + number=95594102, + message="PreservedStatePreservedDisk", + ) + metadata = proto.MapField(proto.STRING, proto.STRING, number=86866735,) -class UpdatePeeringNetworkRequest(proto.Message): - r"""A request message for Networks.UpdatePeering. See the method - description for details. +class PreservedStatePreservedDisk(proto.Message): + r""" Attributes: - network (str): - Name of the network resource which the - updated peering is belonging to. - networks_update_peering_request_resource (google.cloud.compute_v1.types.NetworksUpdatePeeringRequest): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + auto_delete (google.cloud.compute_v1.types.PreservedStatePreservedDisk.AutoDelete): + These stateful disks will never be deleted during + autohealing, update, instance recreate operations. This flag + is used to configure if the disk should be deleted after it + is no longer used by the group, e.g. when the given instance + or the whole MIG is deleted. Note: disks attached in + READ_ONLY mode cannot be auto-deleted. + mode (google.cloud.compute_v1.types.PreservedStatePreservedDisk.Mode): + The mode in which to attach this disk, either READ_WRITE or + READ_ONLY. If not specified, the default is to attach the + disk in READ_WRITE mode. + source (str): + The URL of the disk resource that is stateful + and should be attached to the VM instance. """ - network = proto.Field(proto.STRING, number=232872494,) - networks_update_peering_request_resource = proto.Field( - proto.MESSAGE, number=224433497, message="NetworksUpdatePeeringRequest", + class AutoDelete(proto.Enum): + r"""These stateful disks will never be deleted during autohealing, + update, instance recreate operations. This flag is used to configure + if the disk should be deleted after it is no longer used by the + group, e.g. when the given instance or the whole MIG is deleted. + Note: disks attached in READ_ONLY mode cannot be auto-deleted. + """ + UNDEFINED_AUTO_DELETE = 0 + NEVER = 74175084 + ON_PERMANENT_INSTANCE_DELETION = 95727719 + + class Mode(proto.Enum): + r"""The mode in which to attach this disk, either READ_WRITE or + READ_ONLY. If not specified, the default is to attach the disk in + READ_WRITE mode. + """ + UNDEFINED_MODE = 0 + READ_ONLY = 91950261 + READ_WRITE = 173607894 + + auto_delete = proto.Field( + proto.ENUM, number=464761403, optional=True, enum=AutoDelete, ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + mode = proto.Field(proto.ENUM, number=3357091, optional=True, enum=Mode,) + source = proto.Field(proto.STRING, number=177235995, optional=True,) -class AddNodesNodeGroupRequest(proto.Message): - r"""A request message for NodeGroups.AddNodes. See the method +class PreviewRouterRequest(proto.Message): + r"""A request message for Routers.Preview. See the method description for details. Attributes: - node_group (str): - Name of the NodeGroup resource. - node_groups_add_nodes_request_resource (google.cloud.compute_v1.types.NodeGroupsAddNodesRequest): - The body resource for this request project (str): Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. + region (str): + Name of the region for this request. + router (str): + Name of the Router resource to query. + router_resource (google.cloud.compute_v1.types.Router): + The body resource for this request """ - node_group = proto.Field(proto.STRING, number=469958146,) - node_groups_add_nodes_request_resource = proto.Field( - proto.MESSAGE, number=131263288, message="NodeGroupsAddNodesRequest", - ) project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + region = proto.Field(proto.STRING, number=138946292,) + router = proto.Field(proto.STRING, number=148608841,) + router_resource = proto.Field(proto.MESSAGE, number=155222084, message="Router",) -class AggregatedListNodeGroupsRequest(proto.Message): - r"""A request message for NodeGroups.AggregatedList. See the - method description for details. +class Project(proto.Message): + r"""Represents a Project resource. A project is used to organize + resources in a Google Cloud Platform environment. For more + information, read about the Resource Hierarchy. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. + common_instance_metadata (google.cloud.compute_v1.types.Metadata): + Metadata key/value pairs available to all + instances contained in this project. See Custom + metadata for more information. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + default_network_tier (google.cloud.compute_v1.types.Project.DefaultNetworkTier): + This signifies the default network tier used + for configuring resources of the project and can + only take the following values: PREMIUM, + STANDARD. Initially the default network tier is + PREMIUM. + default_service_account (str): + [Output Only] Default service account used by VMs running in + this project. + description (str): + An optional textual description of the + resource. + enabled_features (Sequence[str]): + Restricted features enabled for use on this + project. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. This is *not* the + project ID, and is just a unique ID used by Compute Engine + to identify resources. + kind (str): + [Output Only] Type of the resource. Always compute#project + for projects. + name (str): + The project ID. For example: my-example- + roject. Use the project ID to make requests to + Compute Engine. + quotas (Sequence[google.cloud.compute_v1.types.Quota]): + [Output Only] Quotas assigned to this project. + self_link (str): + [Output Only] Server-defined URL for the resource. + usage_export_location (google.cloud.compute_v1.types.UsageExportLocation): + The naming prefix for daily usage reports and + the Google Cloud Storage bucket where they are + stored. + xpn_project_status (google.cloud.compute_v1.types.Project.XpnProjectStatus): + [Output Only] The role this project has in a shared VPC + configuration. Currently, only projects with the host role, + which is specified by the value HOST, are differentiated. + """ - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + class DefaultNetworkTier(proto.Enum): + r"""This signifies the default network tier used for configuring + resources of the project and can only take the following values: + PREMIUM, STANDARD. Initially the default network tier is + PREMIUM. + """ + UNDEFINED_DEFAULT_NETWORK_TIER = 0 + PREMIUM = 399530551 + STANDARD = 484642493 - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + class XpnProjectStatus(proto.Enum): + r"""[Output Only] The role this project has in a shared VPC + configuration. Currently, only projects with the host role, which is + specified by the value HOST, are differentiated. + """ + UNDEFINED_XPN_PROJECT_STATUS = 0 + HOST = 2223528 + UNSPECIFIED_XPN_PROJECT_STATUS = 340393257 - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. + common_instance_metadata = proto.Field( + proto.MESSAGE, number=185794117, optional=True, message="Metadata", + ) + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + default_network_tier = proto.Field( + proto.ENUM, number=471753361, optional=True, enum=DefaultNetworkTier, + ) + default_service_account = proto.Field( + proto.STRING, number=298712229, optional=True, + ) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + enabled_features = proto.RepeatedField(proto.STRING, number=469017467,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + quotas = proto.RepeatedField(proto.MESSAGE, number=125341947, message="Quota",) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + usage_export_location = proto.Field( + proto.MESSAGE, number=347543874, optional=True, message="UsageExportLocation", + ) + xpn_project_status = proto.Field( + proto.ENUM, number=228419265, optional=True, enum=XpnProjectStatus, + ) - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. +class ProjectsDisableXpnResourceRequest(proto.Message): + r""" + Attributes: + xpn_resource (google.cloud.compute_v1.types.XpnResourceId): + Service resource (a.k.a service project) ID. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - + xpn_resource = proto.Field( + proto.MESSAGE, number=133384631, optional=True, message="XpnResourceId", + ) -class DeleteNodeGroupRequest(proto.Message): - r"""A request message for NodeGroups.Delete. See the method - description for details. +class ProjectsEnableXpnResourceRequest(proto.Message): + r""" Attributes: - node_group (str): - Name of the NodeGroup resource to delete. - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. + xpn_resource (google.cloud.compute_v1.types.XpnResourceId): + Service resource (a.k.a service project) ID. """ - node_group = proto.Field(proto.STRING, number=469958146,) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - + xpn_resource = proto.Field( + proto.MESSAGE, number=133384631, optional=True, message="XpnResourceId", + ) -class DeleteNodesNodeGroupRequest(proto.Message): - r"""A request message for NodeGroups.DeleteNodes. See the method - description for details. +class ProjectsGetXpnResources(proto.Message): + r""" Attributes: - node_group (str): - Name of the NodeGroup resource whose nodes - will be deleted. - node_groups_delete_nodes_request_resource (google.cloud.compute_v1.types.NodeGroupsDeleteNodesRequest): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. + kind (str): + [Output Only] Type of resource. Always + compute#projectsGetXpnResources for lists of service + resources (a.k.a service projects) + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + resources (Sequence[google.cloud.compute_v1.types.XpnResourceId]): + Service resources (a.k.a service projects) + attached to this project as their shared VPC + host. """ - node_group = proto.Field(proto.STRING, number=469958146,) - node_groups_delete_nodes_request_resource = proto.Field( - proto.MESSAGE, number=183298962, message="NodeGroupsDeleteNodesRequest", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + @property + def raw_page(self): + return self + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + resources = proto.RepeatedField( + proto.MESSAGE, number=164412965, message="XpnResourceId", + ) -class GetNodeGroupRequest(proto.Message): - r"""A request message for NodeGroups.Get. See the method - description for details. +class ProjectsListXpnHostsRequest(proto.Message): + r""" Attributes: - node_group (str): - Name of the node group to return. - project (str): - Project ID for this request. - zone (str): - The name of the zone for this request. + organization (str): + Optional organization ID managed by Cloud + Resource Manager, for which to list shared VPC + host projects. If not specified, the + organization will be inferred from the project. """ - node_group = proto.Field(proto.STRING, number=469958146,) - project = proto.Field(proto.STRING, number=227560217,) - zone = proto.Field(proto.STRING, number=3744684,) - + organization = proto.Field(proto.STRING, number=105180467, optional=True,) -class GetIamPolicyNodeGroupRequest(proto.Message): - r"""A request message for NodeGroups.GetIamPolicy. See the method - description for details. +class ProjectsSetDefaultNetworkTierRequest(proto.Message): + r""" Attributes: - options_requested_policy_version (int): - Requested IAM Policy version. - project (str): - Project ID for this request. - resource (str): - Name or id of the resource for this request. - zone (str): - The name of the zone for this request. + network_tier (google.cloud.compute_v1.types.ProjectsSetDefaultNetworkTierRequest.NetworkTier): + Default network tier to be set. """ - options_requested_policy_version = proto.Field( - proto.INT32, number=499220029, optional=True, + class NetworkTier(proto.Enum): + r"""Default network tier to be set.""" + UNDEFINED_NETWORK_TIER = 0 + PREMIUM = 399530551 + STANDARD = 484642493 + + network_tier = proto.Field( + proto.ENUM, number=517397843, optional=True, enum=NetworkTier, ) - project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) - zone = proto.Field(proto.STRING, number=3744684,) -class InsertNodeGroupRequest(proto.Message): - r"""A request message for NodeGroups.Insert. See the method - description for details. +class PublicAdvertisedPrefix(proto.Message): + r"""A public advertised prefix represents an aggregated IP prefix + or netblock which customers bring to cloud. The IP prefix is a + single unit of route advertisement and is announced globally to + the internet. Attributes: - initial_node_count (int): - Initial count of nodes in the node group. - node_group_resource (google.cloud.compute_v1.types.NodeGroup): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + dns_verification_ip (str): + The IPv4 address to be used for reverse DNS + verification. + fingerprint (str): + Fingerprint of this resource. A hash of the + contents stored in this object. This field is + used in optimistic locking. This field will be + ignored when inserting a new + PublicAdvertisedPrefix. An up-to-date + fingerprint must be provided in order to update + the PublicAdvertisedPrefix, otherwise the + request will fail with error 412 + conditionNotMet. To see the latest fingerprint, + make a get() request to retrieve a + PublicAdvertisedPrefix. + id (int): + [Output Only] The unique identifier for the resource type. + The server generates this identifier. + ip_cidr_range (str): + The IPv4 address range, in CIDR format, + represented by this public advertised prefix. + kind (str): + [Output Only] Type of the resource. Always + compute#publicAdvertisedPrefix for public advertised + prefixes. + name (str): + Name of the resource. Provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. + public_delegated_prefixs (Sequence[google.cloud.compute_v1.types.PublicAdvertisedPrefixPublicDelegatedPrefix]): + [Output Only] The list of public delegated prefixes that + exist for this public advertised prefix. + self_link (str): + [Output Only] Server-defined URL for the resource. + shared_secret (str): + [Output Only] The shared secret to be used for reverse DNS + verification. + status (google.cloud.compute_v1.types.PublicAdvertisedPrefix.Status): + The status of the public advertised prefix. """ - initial_node_count = proto.Field(proto.INT32, number=71951469,) - node_group_resource = proto.Field( - proto.MESSAGE, number=505321899, message="NodeGroup", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + class Status(proto.Enum): + r"""The status of the public advertised prefix.""" + UNDEFINED_STATUS = 0 + INITIAL = 518841124 + PREFIX_CONFIGURATION_COMPLETE = 480889551 + PREFIX_CONFIGURATION_IN_PROGRESS = 378550961 + PREFIX_REMOVAL_IN_PROGRESS = 284375783 + PTR_CONFIGURED = 513497167 + REVERSE_DNS_LOOKUP_FAILED = 295755183 + VALIDATED = 66197998 + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + dns_verification_ip = proto.Field(proto.STRING, number=241011381, optional=True,) + fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + ip_cidr_range = proto.Field(proto.STRING, number=98117322, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + public_delegated_prefixs = proto.RepeatedField( + proto.MESSAGE, + number=425811723, + message="PublicAdvertisedPrefixPublicDelegatedPrefix", + ) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + shared_secret = proto.Field(proto.STRING, number=381932490, optional=True,) + status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) -class ListNodeGroupsRequest(proto.Message): - r"""A request message for NodeGroups.List. See the method - description for details. +class PublicAdvertisedPrefixList(proto.Message): + r""" Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.PublicAdvertisedPrefix]): + A list of PublicAdvertisedPrefix resources. + kind (str): + [Output Only] Type of the resource. Always + compute#publicAdvertisedPrefix for public advertised + prefixes. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. + """ - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + @property + def raw_page(self): + return self - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="PublicAdvertisedPrefix", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. +class PublicAdvertisedPrefixPublicDelegatedPrefix(proto.Message): + r"""Represents a CIDR range which can be used to assign + addresses. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. + Attributes: + ip_range (str): + The IP address range of the public delegated + prefix + name (str): + The name of the public delegated prefix project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. - zone (str): - The name of the zone for this request. + The project number of the public delegated + prefix + region (str): + The region of the public delegated prefix if + it is regional. If absent, the prefix is global. + status (str): + The status of the public delegated prefix. + Possible values are: INITIALIZING: The public + delegated prefix is being initialized and + addresses cannot be created yet. ANNOUNCED: The + public delegated prefix is active. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + ip_range = proto.Field(proto.STRING, number=145092645, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + project = proto.Field(proto.STRING, number=227560217, optional=True,) + region = proto.Field(proto.STRING, number=138946292, optional=True,) + status = proto.Field(proto.STRING, number=181260274, optional=True,) -class ListNodesNodeGroupsRequest(proto.Message): - r"""A request message for NodeGroups.ListNodes. See the method - description for details. +class PublicDelegatedPrefix(proto.Message): + r"""A PublicDelegatedPrefix resource represents an IP block + within a PublicAdvertisedPrefix that is configured within a + single cloud scope (global or region). IPs in the block can be + allocated to resources within that scope. Public delegated + prefixes may be further broken up into smaller IP blocks in the + same scope as the parent block. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - node_group (str): - Name of the NodeGroup resource whose nodes - you want to list. - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. - zone (str): - The name of the zone for this request. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + fingerprint (str): + Fingerprint of this resource. A hash of the + contents stored in this object. This field is + used in optimistic locking. This field will be + ignored when inserting a new + PublicDelegatedPrefix. An up-to-date fingerprint + must be provided in order to update the + PublicDelegatedPrefix, otherwise the request + will fail with error 412 conditionNotMet. To see + the latest fingerprint, make a get() request to + retrieve a PublicDelegatedPrefix. + id (int): + [Output Only] The unique identifier for the resource type. + The server generates this identifier. + ip_cidr_range (str): + The IPv4 address range, in CIDR format, + represented by this public delegated prefix. + is_live_migration (bool): + If true, the prefix will be live migrated. + kind (str): + [Output Only] Type of the resource. Always + compute#publicDelegatedPrefix for public delegated prefixes. + name (str): + Name of the resource. Provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. + parent_prefix (str): + The URL of parent prefix. Either + PublicAdvertisedPrefix or PublicDelegatedPrefix. + public_delegated_sub_prefixs (Sequence[google.cloud.compute_v1.types.PublicDelegatedPrefixPublicDelegatedSubPrefix]): + The list of sub public delegated prefixes + that exist for this public delegated prefix. + region (str): + [Output Only] URL of the region where the public delegated + prefix resides. This field applies only to the region + resource. You must specify this field as part of the HTTP + request URL. It is not settable as a field in the request + body. + self_link (str): + [Output Only] Server-defined URL for the resource. + status (google.cloud.compute_v1.types.PublicDelegatedPrefix.Status): + [Output Only] The status of the public delegated prefix. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - node_group = proto.Field(proto.STRING, number=469958146,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + class Status(proto.Enum): + r"""[Output Only] The status of the public delegated prefix.""" + UNDEFINED_STATUS = 0 + ANNOUNCED = 365103355 + DELETING = 528602024 + INITIALIZING = 306588749 + READY_TO_ANNOUNCE = 64641265 + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + ip_cidr_range = proto.Field(proto.STRING, number=98117322, optional=True,) + is_live_migration = proto.Field(proto.BOOL, number=511823856, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + parent_prefix = proto.Field(proto.STRING, number=15233991, optional=True,) + public_delegated_sub_prefixs = proto.RepeatedField( + proto.MESSAGE, + number=188940044, + message="PublicDelegatedPrefixPublicDelegatedSubPrefix", + ) + region = proto.Field(proto.STRING, number=138946292, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) -class PatchNodeGroupRequest(proto.Message): - r"""A request message for NodeGroups.Patch. See the method - description for details. +class PublicDelegatedPrefixAggregatedList(proto.Message): + r""" Attributes: - node_group (str): - Name of the NodeGroup resource to update. - node_group_resource (google.cloud.compute_v1.types.NodeGroup): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.PublicDelegatedPrefixAggregatedList.ItemsEntry]): + A list of PublicDelegatedPrefixesScopedList + resources. + kind (str): + [Output Only] Type of the resource. Always + compute#publicDelegatedPrefixAggregatedList for aggregated + lists of public delegated prefixes. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - node_group = proto.Field(proto.STRING, number=469958146,) - node_group_resource = proto.Field( - proto.MESSAGE, number=505321899, message="NodeGroup", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.MapField( + proto.STRING, + proto.MESSAGE, + number=100526016, + message="PublicDelegatedPrefixesScopedList", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class SetIamPolicyNodeGroupRequest(proto.Message): - r"""A request message for NodeGroups.SetIamPolicy. See the method - description for details. +class PublicDelegatedPrefixList(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - resource (str): - Name or id of the resource for this request. - zone (str): - The name of the zone for this request. - zone_set_policy_request_resource (google.cloud.compute_v1.types.ZoneSetPolicyRequest): - The body resource for this request + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.PublicDelegatedPrefix]): + A list of PublicDelegatedPrefix resources. + kind (str): + [Output Only] Type of the resource. Always + compute#publicDelegatedPrefixList for public delegated + prefixes. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) - zone = proto.Field(proto.STRING, number=3744684,) - zone_set_policy_request_resource = proto.Field( - proto.MESSAGE, number=382082107, message="ZoneSetPolicyRequest", - ) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="PublicDelegatedPrefix", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class SetNodeTemplateNodeGroupRequest(proto.Message): - r"""A request message for NodeGroups.SetNodeTemplate. See the - method description for details. +class PublicDelegatedPrefixPublicDelegatedSubPrefix(proto.Message): + r"""Represents a sub PublicDelegatedPrefix. Attributes: - node_group (str): - Name of the NodeGroup resource to update. - node_groups_set_node_template_request_resource (google.cloud.compute_v1.types.NodeGroupsSetNodeTemplateRequest): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - zone (str): - The name of the zone for this request. + delegatee_project (str): + Name of the project scoping this + PublicDelegatedSubPrefix. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + ip_cidr_range (str): + The IPv4 address range, in CIDR format, + represented by this sub public delegated prefix. + is_address (bool): + Whether the sub prefix is delegated to create + Address resources in the delegatee project. + name (str): + The name of the sub public delegated prefix. + region (str): + [Output Only] The region of the sub public delegated prefix + if it is regional. If absent, the sub prefix is global. + status (google.cloud.compute_v1.types.PublicDelegatedPrefixPublicDelegatedSubPrefix.Status): + [Output Only] The status of the sub public delegated prefix. """ - node_group = proto.Field(proto.STRING, number=469958146,) - node_groups_set_node_template_request_resource = proto.Field( - proto.MESSAGE, number=117382321, message="NodeGroupsSetNodeTemplateRequest", - ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + class Status(proto.Enum): + r"""[Output Only] The status of the sub public delegated prefix.""" + UNDEFINED_STATUS = 0 + ACTIVE = 314733318 + INACTIVE = 270421099 + delegatee_project = proto.Field(proto.STRING, number=414860634, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + ip_cidr_range = proto.Field(proto.STRING, number=98117322, optional=True,) + is_address = proto.Field(proto.BOOL, number=352617951, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + region = proto.Field(proto.STRING, number=138946292, optional=True,) + status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) -class TestIamPermissionsNodeGroupRequest(proto.Message): - r"""A request message for NodeGroups.TestIamPermissions. See the - method description for details. +class PublicDelegatedPrefixesScopedList(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - resource (str): - Name or id of the resource for this request. - test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): - The body resource for this request - zone (str): - The name of the zone for this request. + public_delegated_prefixes (Sequence[google.cloud.compute_v1.types.PublicDelegatedPrefix]): + [Output Only] A list of PublicDelegatedPrefixes contained in + this scope. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning which replaces the list + of public delegated prefixes when the list is empty. """ - project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) - test_permissions_request_resource = proto.Field( - proto.MESSAGE, number=439214758, message="TestPermissionsRequest", + public_delegated_prefixes = proto.RepeatedField( + proto.MESSAGE, number=315261206, message="PublicDelegatedPrefix", + ) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", ) - zone = proto.Field(proto.STRING, number=3744684,) - -class AggregatedListNodeTemplatesRequest(proto.Message): - r"""A request message for NodeTemplates.AggregatedList. See the - method description for details. +class Quota(proto.Message): + r"""A quotas entry. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + limit (float): + [Output Only] Quota limit for this metric. + metric (google.cloud.compute_v1.types.Quota.Metric): + [Output Only] Name of the quota metric. + owner (str): + [Output Only] Owning resource. This is the resource on which + this quota is applied. + usage (float): + [Output Only] Current usage of this metric. + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + class Metric(proto.Enum): + r"""[Output Only] Name of the quota metric.""" + UNDEFINED_METRIC = 0 + A2_CPUS = 153206585 + AFFINITY_GROUPS = 108303563 + AUTOSCALERS = 471248988 + BACKEND_BUCKETS = 137626846 + BACKEND_SERVICES = 269623753 + C2D_CPUS = 508182517 + C2_CPUS = 317601211 + C3_CPUS = 346230362 + COMMITMENTS = 456141790 + COMMITTED_A2_CPUS = 59330902 + COMMITTED_C2D_CPUS = 282390904 + COMMITTED_C2_CPUS = 223725528 + COMMITTED_C3_CPUS = 252354679 + COMMITTED_CPUS = 292394702 + COMMITTED_E2_CPUS = 388120154 + COMMITTED_LICENSES = 357606869 + COMMITTED_LOCAL_SSD_TOTAL_GB = 308393480 + COMMITTED_MEMORY_OPTIMIZED_CPUS = 489057886 + COMMITTED_N2A_CPUS = 40064304 + COMMITTED_N2D_CPUS = 125951757 + COMMITTED_N2_CPUS = 322589603 + COMMITTED_NVIDIA_A100_GPUS = 375799445 + COMMITTED_NVIDIA_K80_GPUS = 3857188 + COMMITTED_NVIDIA_P100_GPUS = 107528100 + COMMITTED_NVIDIA_P4_GPUS = 347952897 + COMMITTED_NVIDIA_T4_GPUS = 139871237 + COMMITTED_NVIDIA_V100_GPUS = 219562 + COMMITTED_T2D_CPUS = 382266439 + CPUS = 2075595 + CPUS_ALL_REGIONS = 470911149 + DISKS_TOTAL_GB = 353520543 + E2_CPUS = 481995837 + EXTERNAL_NETWORK_LB_FORWARDING_RULES = 374298265 + EXTERNAL_PROTOCOL_FORWARDING_RULES = 63478888 + EXTERNAL_VPN_GATEWAYS = 272457134 + FIREWALLS = 374485843 + FORWARDING_RULES = 432668949 + GLOBAL_INTERNAL_ADDRESSES = 42738332 + GPUS_ALL_REGIONS = 39387177 + HEALTH_CHECKS = 289347502 + IMAGES = 15562360 + INSTANCES = 131337822 + INSTANCE_GROUPS = 355919038 + INSTANCE_GROUP_MANAGERS = 101798192 + INSTANCE_TEMPLATES = 226188271 + INTERCONNECTS = 415204741 + INTERCONNECT_ATTACHMENTS_PER_REGION = 159968086 + INTERCONNECT_ATTACHMENTS_TOTAL_MBPS = 425090419 + INTERCONNECT_TOTAL_GBPS = 285341866 + INTERNAL_ADDRESSES = 197899392 + INTERNAL_TRAFFIC_DIRECTOR_FORWARDING_RULES = 266433668 + IN_PLACE_SNAPSHOTS = 151359133 + IN_USE_ADDRESSES = 402125072 + IN_USE_BACKUP_SCHEDULES = 32786705 + IN_USE_SNAPSHOT_SCHEDULES = 462104083 + LOCAL_SSD_TOTAL_GB = 330878021 + M1_CPUS = 37203366 + M2_CPUS = 65832517 + MACHINE_IMAGES = 446986640 + N2A_CPUS = 265855917 + N2D_CPUS = 351743370 + N2_CPUS = 416465286 + NETWORKS = 485481477 + NETWORK_ENDPOINT_GROUPS = 102144909 + NETWORK_FIREWALL_POLICIES = 101117374 + NODE_GROUPS = 24624817 + NODE_TEMPLATES = 474896668 + NVIDIA_A100_GPUS = 504872978 + NVIDIA_K80_GPUS = 163886599 + NVIDIA_P100_GPUS = 236601633 + NVIDIA_P100_VWS_GPUS = 213970574 + NVIDIA_P4_GPUS = 283841470 + NVIDIA_P4_VWS_GPUS = 528296619 + NVIDIA_T4_GPUS = 75759810 + NVIDIA_T4_VWS_GPUS = 319813039 + NVIDIA_V100_GPUS = 129293095 + PACKET_MIRRORINGS = 15578407 + PD_EXTREME_TOTAL_PROVISIONED_IOPS = 69593965 + PREEMPTIBLE_CPUS = 251184841 + PREEMPTIBLE_LOCAL_SSD_GB = 260819336 + PREEMPTIBLE_NVIDIA_A100_GPUS = 68832784 + PREEMPTIBLE_NVIDIA_K80_GPUS = 374960201 + PREEMPTIBLE_NVIDIA_P100_GPUS = 337432351 + PREEMPTIBLE_NVIDIA_P100_VWS_GPUS = 313544076 + PREEMPTIBLE_NVIDIA_P4_GPUS = 429197628 + PREEMPTIBLE_NVIDIA_P4_VWS_GPUS = 252981545 + PREEMPTIBLE_NVIDIA_T4_GPUS = 221115968 + PREEMPTIBLE_NVIDIA_T4_VWS_GPUS = 44497965 + PREEMPTIBLE_NVIDIA_V100_GPUS = 230123813 + PSC_ILB_CONSUMER_FORWARDING_RULES_PER_PRODUCER_NETWORK = 231164291 + PSC_INTERNAL_LB_FORWARDING_RULES = 169005435 + PUBLIC_ADVERTISED_PREFIXES = 471371980 + PUBLIC_DELEGATED_PREFIXES = 532465974 + REGIONAL_AUTOSCALERS = 29363772 + REGIONAL_INSTANCE_GROUP_MANAGERS = 37543696 + RESERVATIONS = 32644647 + RESOURCE_POLICIES = 83955297 + ROUTERS = 493018666 + ROUTES = 275680074 + SECURITY_POLICIES = 189518703 + SECURITY_POLICIES_PER_REGION = 249041734 + SECURITY_POLICY_CEVAL_RULES = 470815689 + SECURITY_POLICY_RULES = 203549225 + SECURITY_POLICY_RULES_PER_REGION = 126510156 + SERVICE_ATTACHMENTS = 471521510 + SNAPSHOTS = 343405327 + SSD_TOTAL_GB = 161732561 + SSL_CERTIFICATES = 378372399 + STATIC_ADDRESSES = 93624049 + STATIC_BYOIP_ADDRESSES = 275809649 + SUBNETWORKS = 421330469 + T2D_CPUS = 71187140 + TARGET_HTTPS_PROXIES = 219522506 + TARGET_HTTP_PROXIES = 164117155 + TARGET_INSTANCES = 284519728 + TARGET_POOLS = 348261257 + TARGET_SSL_PROXIES = 159216235 + TARGET_TCP_PROXIES = 182243136 + TARGET_VPN_GATEWAYS = 75029928 + URL_MAPS = 378660743 + VPN_GATEWAYS = 35620282 + VPN_TUNNELS = 104327296 + XPN_SERVICE_PROJECTS = 95191981 - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. + limit = proto.Field(proto.DOUBLE, number=102976443, optional=True,) + metric = proto.Field(proto.ENUM, number=533067184, optional=True, enum=Metric,) + owner = proto.Field(proto.STRING, number=106164915, optional=True,) + usage = proto.Field(proto.DOUBLE, number=111574433, optional=True,) - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. +class RawDisk(proto.Message): + r"""The parameters of the raw disk image. + Attributes: + container_type (google.cloud.compute_v1.types.RawDisk.ContainerType): + The format used to encode and transmit the + block device, which should be TAR. This is just + a container and transmission format and not a + runtime format. Provided by the client when the + disk image is created. + sha1_checksum (str): + [Deprecated] This field is deprecated. An optional SHA1 + checksum of the disk image before unpackaging provided by + the client when the disk image is created. + source (str): + The full Google Cloud Storage URL where the raw disk image + archive is stored. The following are valid formats for the + URL: - + https://storage.googleapis.com/bucket_name/image_archive_name + - https://storage.googleapis.com/bucket_name/folder_name/ + image_archive_name In order to create an image, you must + provide the full or partial URL of one of the following: - + The rawDisk.source URL - The sourceDisk URL - The + sourceImage URL - The sourceSnapshot URL """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + class ContainerType(proto.Enum): + r"""The format used to encode and transmit the block device, + which should be TAR. This is just a container and transmission + format and not a runtime format. Provided by the client when the + disk image is created. + """ + UNDEFINED_CONTAINER_TYPE = 0 + TAR = 82821 + container_type = proto.Field( + proto.ENUM, number=318809144, optional=True, enum=ContainerType, + ) + sha1_checksum = proto.Field(proto.STRING, number=314444349, optional=True,) + source = proto.Field(proto.STRING, number=177235995, optional=True,) -class DeleteNodeTemplateRequest(proto.Message): - r"""A request message for NodeTemplates.Delete. See the method + +class RecreateInstancesInstanceGroupManagerRequest(proto.Message): + r"""A request message for + InstanceGroupManagers.RecreateInstances. See the method description for details. Attributes: - node_template (str): - Name of the NodeTemplate resource to delete. + instance_group_manager (str): + The name of the managed instance group. + instance_group_managers_recreate_instances_request_resource (google.cloud.compute_v1.types.InstanceGroupManagersRecreateInstancesRequest): + The body resource for this request project (str): Project ID for this request. - region (str): - The name of the region for this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - node_template = proto.Field(proto.STRING, number=323154455,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class GetNodeTemplateRequest(proto.Message): - r"""A request message for NodeTemplates.Get. See the method - description for details. - - Attributes: - node_template (str): - Name of the node template to return. - project (str): - Project ID for this request. - region (str): - The name of the region for this request. - """ - - node_template = proto.Field(proto.STRING, number=323154455,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - - -class GetIamPolicyNodeTemplateRequest(proto.Message): - r"""A request message for NodeTemplates.GetIamPolicy. See the - method description for details. - - Attributes: - options_requested_policy_version (int): - Requested IAM Policy version. - project (str): - Project ID for this request. - region (str): - The name of the region for this request. - resource (str): - Name or id of the resource for this request. + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone where the managed + instance group is located. """ - options_requested_policy_version = proto.Field( - proto.INT32, number=499220029, optional=True, + instance_group_manager = proto.Field(proto.STRING, number=249363395,) + instance_group_managers_recreate_instances_request_resource = proto.Field( + proto.MESSAGE, + number=21405952, + message="InstanceGroupManagersRecreateInstancesRequest", ) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - resource = proto.Field(proto.STRING, number=195806222,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class InsertNodeTemplateRequest(proto.Message): - r"""A request message for NodeTemplates.Insert. See the method +class RecreateInstancesRegionInstanceGroupManagerRequest(proto.Message): + r"""A request message for + RegionInstanceGroupManagers.RecreateInstances. See the method description for details. Attributes: - node_template_resource (google.cloud.compute_v1.types.NodeTemplate): - The body resource for this request + instance_group_manager (str): + Name of the managed instance group. project (str): Project ID for this request. region (str): - The name of the region for this request. + Name of the region scoping this request. + region_instance_group_managers_recreate_request_resource (google.cloud.compute_v1.types.RegionInstanceGroupManagersRecreateRequest): + The body resource for this request request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - node_template_resource = proto.Field( - proto.MESSAGE, number=127364406, message="NodeTemplate", - ) + instance_group_manager = proto.Field(proto.STRING, number=249363395,) project = proto.Field(proto.STRING, number=227560217,) region = proto.Field(proto.STRING, number=138946292,) + region_instance_group_managers_recreate_request_resource = proto.Field( + proto.MESSAGE, + number=170999316, + message="RegionInstanceGroupManagersRecreateRequest", + ) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class ListNodeTemplatesRequest(proto.Message): - r"""A request message for NodeTemplates.List. See the method - description for details. - +class Reference(proto.Message): + r"""Represents a reference to a resource. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + kind (str): + [Output Only] Type of the resource. Always compute#reference + for references. + reference_type (str): + A description of the reference type with no implied + semantics. Possible values include: 1. MEMBER_OF + referrer (str): + URL of the resource which refers to the + target. + target (str): + URL of the resource to which this reference + points. + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + reference_type = proto.Field(proto.STRING, number=247521198, optional=True,) + referrer = proto.Field(proto.STRING, number=351173663, optional=True,) + target = proto.Field(proto.STRING, number=192835985, optional=True,) - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. +class Region(proto.Message): + r"""Represents a Region resource. A region is a geographical area + where a resource is located. For more information, read Regions + and Zones. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - region (str): - The name of the region for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + Attributes: + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + deprecated (google.cloud.compute_v1.types.DeprecationStatus): + [Output Only] The deprecation status associated with this + region. + description (str): + [Output Only] Textual description of the resource. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + kind (str): + [Output Only] Type of the resource. Always compute#region + for regions. + name (str): + [Output Only] Name of the resource. + quotas (Sequence[google.cloud.compute_v1.types.Quota]): + [Output Only] Quotas assigned to this region. + self_link (str): + [Output Only] Server-defined URL for the resource. + status (google.cloud.compute_v1.types.Region.Status): + [Output Only] Status of the region, either UP or DOWN. + supports_pzs (bool): + [Output Only] Reserved for future use. + zones (Sequence[str]): + [Output Only] A list of zones available in this region, in + the form of resource URLs. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + class Status(proto.Enum): + r"""[Output Only] Status of the region, either UP or DOWN.""" + UNDEFINED_STATUS = 0 + DOWN = 2104482 + UP = 2715 + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + deprecated = proto.Field( + proto.MESSAGE, number=515138995, optional=True, message="DeprecationStatus", + ) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + quotas = proto.RepeatedField(proto.MESSAGE, number=125341947, message="Quota",) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) + supports_pzs = proto.Field(proto.BOOL, number=83983214, optional=True,) + zones = proto.RepeatedField(proto.STRING, number=116085319,) -class SetIamPolicyNodeTemplateRequest(proto.Message): - r"""A request message for NodeTemplates.SetIamPolicy. See the - method description for details. +class RegionAutoscalerList(proto.Message): + r"""Contains a list of autoscalers. Attributes: - project (str): - Project ID for this request. - region (str): - The name of the region for this request. - region_set_policy_request_resource (google.cloud.compute_v1.types.RegionSetPolicyRequest): - The body resource for this request - resource (str): - Name or id of the resource for this request. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.Autoscaler]): + A list of Autoscaler resources. + kind (str): + Type of resource. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - region_set_policy_request_resource = proto.Field( - proto.MESSAGE, number=276489091, message="RegionSetPolicyRequest", - ) - resource = proto.Field(proto.STRING, number=195806222,) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Autoscaler",) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class TestIamPermissionsNodeTemplateRequest(proto.Message): - r"""A request message for NodeTemplates.TestIamPermissions. See - the method description for details. +class RegionDiskTypeList(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - region (str): - The name of the region for this request. - resource (str): - Name or id of the resource for this request. - test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): - The body resource for this request + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.DiskType]): + A list of DiskType resources. + kind (str): + [Output Only] Type of resource. Always + compute#regionDiskTypeList for region disk types. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - resource = proto.Field(proto.STRING, number=195806222,) - test_permissions_request_resource = proto.Field( - proto.MESSAGE, number=439214758, message="TestPermissionsRequest", - ) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="DiskType",) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class AggregatedListNodeTypesRequest(proto.Message): - r"""A request message for NodeTypes.AggregatedList. See the - method description for details. +class RegionDisksAddResourcePoliciesRequest(proto.Message): + r""" Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + resource_policies (Sequence[str]): + Resource policies to be added to this disk. + """ - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. + resource_policies = proto.RepeatedField(proto.STRING, number=22220385,) - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. +class RegionDisksRemoveResourcePoliciesRequest(proto.Message): + r""" + Attributes: + resource_policies (Sequence[str]): + Resource policies to be removed from this + disk. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - + resource_policies = proto.RepeatedField(proto.STRING, number=22220385,) -class GetNodeTypeRequest(proto.Message): - r"""A request message for NodeTypes.Get. See the method - description for details. +class RegionDisksResizeRequest(proto.Message): + r""" Attributes: - node_type (str): - Name of the node type to return. - project (str): - Project ID for this request. - zone (str): - The name of the zone for this request. + size_gb (int): + The new size of the regional persistent disk, + which is specified in GB. """ - node_type = proto.Field(proto.STRING, number=465832791,) - project = proto.Field(proto.STRING, number=227560217,) - zone = proto.Field(proto.STRING, number=3744684,) - + size_gb = proto.Field(proto.INT64, number=494929369, optional=True,) -class ListNodeTypesRequest(proto.Message): - r"""A request message for NodeTypes.List. See the method - description for details. +class RegionInstanceGroupList(proto.Message): + r"""Contains a list of InstanceGroup resources. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.InstanceGroup]): + A list of InstanceGroup resources. + kind (str): + The resource type. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + @property + def raw_page(self): + return self - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="InstanceGroup", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. - zone (str): - The name of the zone for this request. +class RegionInstanceGroupManagerDeleteInstanceConfigReq(proto.Message): + r"""RegionInstanceGroupManagers.deletePerInstanceConfigs + Attributes: + names (Sequence[str]): + The list of instance names for which we want + to delete per-instance configs on this managed + instance group. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) - + names = proto.RepeatedField(proto.STRING, number=104585032,) -class AggregatedListPacketMirroringsRequest(proto.Message): - r"""A request message for PacketMirrorings.AggregatedList. See - the method description for details. +class RegionInstanceGroupManagerList(proto.Message): + r"""Contains a list of managed instance groups. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.InstanceGroupManager]): + A list of InstanceGroupManager resources. + kind (str): + [Output Only] The resource type, which is always + compute#instanceGroupManagerList for a list of managed + instance groups that exist in th regional scope. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + @property + def raw_page(self): + return self - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="InstanceGroupManager", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. +class RegionInstanceGroupManagerPatchInstanceConfigReq(proto.Message): + r"""RegionInstanceGroupManagers.patchPerInstanceConfigs + Attributes: + per_instance_configs (Sequence[google.cloud.compute_v1.types.PerInstanceConfig]): + The list of per-instance configs to insert or + patch on this managed instance group. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - + per_instance_configs = proto.RepeatedField( + proto.MESSAGE, number=526265001, message="PerInstanceConfig", + ) -class DeletePacketMirroringRequest(proto.Message): - r"""A request message for PacketMirrorings.Delete. See the method - description for details. +class RegionInstanceGroupManagerUpdateInstanceConfigReq(proto.Message): + r"""RegionInstanceGroupManagers.updatePerInstanceConfigs Attributes: - packet_mirroring (str): - Name of the PacketMirroring resource to - delete. - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + per_instance_configs (Sequence[google.cloud.compute_v1.types.PerInstanceConfig]): + The list of per-instance configs to insert or + patch on this managed instance group. """ - packet_mirroring = proto.Field(proto.STRING, number=22305996,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - + per_instance_configs = proto.RepeatedField( + proto.MESSAGE, number=526265001, message="PerInstanceConfig", + ) -class GetPacketMirroringRequest(proto.Message): - r"""A request message for PacketMirrorings.Get. See the method - description for details. +class RegionInstanceGroupManagersAbandonInstancesRequest(proto.Message): + r""" Attributes: - packet_mirroring (str): - Name of the PacketMirroring resource to - return. - project (str): - Project ID for this request. - region (str): - Name of the region for this request. + instances (Sequence[str]): + The URLs of one or more instances to abandon. This can be a + full URL or a partial URL, such as + zones/[ZONE]/instances/[INSTANCE_NAME]. """ - packet_mirroring = proto.Field(proto.STRING, number=22305996,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - + instances = proto.RepeatedField(proto.STRING, number=29097598,) -class InsertPacketMirroringRequest(proto.Message): - r"""A request message for PacketMirrorings.Insert. See the method - description for details. +class RegionInstanceGroupManagersApplyUpdatesRequest(proto.Message): + r"""RegionInstanceGroupManagers.applyUpdatesToInstances Attributes: - packet_mirroring_resource (google.cloud.compute_v1.types.PacketMirroring): - The body resource for this request - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + all_instances (bool): + Flag to update all instances instead of + specified list of ���instances���. If the flag + is set to true then the instances may not be + specified in the request. + instances (Sequence[str]): + The list of URLs of one or more instances for which you want + to apply updates. Each URL can be a full URL or a partial + URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + minimal_action (str): + The minimal action that you want to perform + on each instance during the update: - REPLACE: + At minimum, delete the instance and create it + again. - RESTART: Stop the instance and start it + again. - REFRESH: Do not stop the instance. - + NONE: Do not disrupt the instance at all. By + default, the minimum action is NONE. If your + update requires a more disruptive action than + you set with this flag, the necessary action is + performed to execute the update. + most_disruptive_allowed_action (str): + The most disruptive action that you want to + perform on each instance during the update: - + REPLACE: Delete the instance and create it + again. - RESTART: Stop the instance and start it + again. - REFRESH: Do not stop the instance. - + NONE: Do not disrupt the instance at all. By + default, the most disruptive allowed action is + REPLACE. If your update requires a more + disruptive action than you set with this flag, + the update request will fail. """ - packet_mirroring_resource = proto.Field( - proto.MESSAGE, number=493501985, message="PacketMirroring", + all_instances = proto.Field(proto.BOOL, number=403676512, optional=True,) + instances = proto.RepeatedField(proto.STRING, number=29097598,) + minimal_action = proto.Field(proto.STRING, number=270567060, optional=True,) + most_disruptive_allowed_action = proto.Field( + proto.STRING, number=66103053, optional=True, ) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - -class ListPacketMirroringsRequest(proto.Message): - r"""A request message for PacketMirrorings.List. See the method - description for details. +class RegionInstanceGroupManagersCreateInstancesRequest(proto.Message): + r"""RegionInstanceGroupManagers.createInstances Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. + instances (Sequence[google.cloud.compute_v1.types.PerInstanceConfig]): + [Required] List of specifications of per-instance configs. + """ - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + instances = proto.RepeatedField( + proto.MESSAGE, number=29097598, message="PerInstanceConfig", + ) - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. +class RegionInstanceGroupManagersDeleteInstancesRequest(proto.Message): + r""" + Attributes: + instances (Sequence[str]): + The URLs of one or more instances to delete. This can be a + full URL or a partial URL, such as + zones/[ZONE]/instances/[INSTANCE_NAME]. + skip_instances_on_validation_error (bool): + Specifies whether the request should proceed despite the + inclusion of instances that are not members of the group or + that are already in the process of being deleted or + abandoned. If this field is set to ``false`` and such an + instance is specified in the request, the operation fails. + The operation always fails if the request contains a + malformed instance URL or a reference to an instance that + exists in a zone or region other than the group's zone or + region. + """ - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. + instances = proto.RepeatedField(proto.STRING, number=29097598,) + skip_instances_on_validation_error = proto.Field( + proto.BOOL, number=40631073, optional=True, + ) - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + +class RegionInstanceGroupManagersListErrorsResponse(proto.Message): + r""" + Attributes: + items (Sequence[google.cloud.compute_v1.types.InstanceManagedByIgmError]): + [Output Only] The list of errors of the managed instance + group. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + @property + def raw_page(self): + return self + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="InstanceManagedByIgmError", + ) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) -class PatchPacketMirroringRequest(proto.Message): - r"""A request message for PacketMirrorings.Patch. See the method - description for details. +class RegionInstanceGroupManagersListInstanceConfigsResp(proto.Message): + r""" Attributes: - packet_mirroring (str): - Name of the PacketMirroring resource to - patch. - packet_mirroring_resource (google.cloud.compute_v1.types.PacketMirroring): - The body resource for this request - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + items (Sequence[google.cloud.compute_v1.types.PerInstanceConfig]): + [Output Only] The list of PerInstanceConfig. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - packet_mirroring = proto.Field(proto.STRING, number=22305996,) - packet_mirroring_resource = proto.Field( - proto.MESSAGE, number=493501985, message="PacketMirroring", - ) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + @property + def raw_page(self): + return self + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="PerInstanceConfig", + ) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class TestIamPermissionsPacketMirroringRequest(proto.Message): - r"""A request message for PacketMirrorings.TestIamPermissions. - See the method description for details. +class RegionInstanceGroupManagersListInstancesResponse(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - region (str): - The name of the region for this request. - resource (str): - Name or id of the resource for this request. - test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): - The body resource for this request + managed_instances (Sequence[google.cloud.compute_v1.types.ManagedInstance]): + A list of managed instances. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - resource = proto.Field(proto.STRING, number=195806222,) - test_permissions_request_resource = proto.Field( - proto.MESSAGE, number=439214758, message="TestPermissionsRequest", + @property + def raw_page(self): + return self + + managed_instances = proto.RepeatedField( + proto.MESSAGE, number=336219614, message="ManagedInstance", ) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) -class DisableXpnHostProjectRequest(proto.Message): - r"""A request message for Projects.DisableXpnHost. See the method - description for details. +class RegionInstanceGroupManagersRecreateRequest(proto.Message): + r""" + Attributes: + instances (Sequence[str]): + The URLs of one or more instances to recreate. This can be a + full URL or a partial URL, such as + zones/[ZONE]/instances/[INSTANCE_NAME]. + """ + + instances = proto.RepeatedField(proto.STRING, number=29097598,) + +class RegionInstanceGroupManagersSetTargetPoolsRequest(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + fingerprint (str): + Fingerprint of the target pools information, + which is a hash of the contents. This field is + used for optimistic locking when you update the + target pool entries. This field is optional. + target_pools (Sequence[str]): + The URL of all TargetPool resources to which + instances in the instanceGroup field are added. + The target pools automatically apply to all of + the instances in the managed instance group. """ - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) + target_pools = proto.RepeatedField(proto.STRING, number=336072617,) -class DisableXpnResourceProjectRequest(proto.Message): - r"""A request message for Projects.DisableXpnResource. See the - method description for details. +class RegionInstanceGroupManagersSetTemplateRequest(proto.Message): + r""" + Attributes: + instance_template (str): + URL of the InstanceTemplate resource from + which all new instances will be created. + """ + instance_template = proto.Field(proto.STRING, number=309248228, optional=True,) + + +class RegionInstanceGroupsListInstances(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - projects_disable_xpn_resource_request_resource (google.cloud.compute_v1.types.ProjectsDisableXpnResourceRequest): - The body resource for this request - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.InstanceWithNamedPorts]): + A list of InstanceWithNamedPorts resources. + kind (str): + The resource type. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - project = proto.Field(proto.STRING, number=227560217,) - projects_disable_xpn_resource_request_resource = proto.Field( - proto.MESSAGE, number=209136170, message="ProjectsDisableXpnResourceRequest", - ) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="InstanceWithNamedPorts", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class EnableXpnHostProjectRequest(proto.Message): - r"""A request message for Projects.EnableXpnHost. See the method - description for details. +class RegionInstanceGroupsListInstancesRequest(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + instance_state (google.cloud.compute_v1.types.RegionInstanceGroupsListInstancesRequest.InstanceState): + Instances in which state should be returned. + Valid options are: 'ALL', 'RUNNING'. By default, + it lists all instances. + port_name (str): + Name of port user is interested in. It is + optional. If it is set, only information about + this ports will be returned. If it is not set, + all the named ports will be returned. Always + lists all instances. """ - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + class InstanceState(proto.Enum): + r"""Instances in which state should be returned. Valid options + are: 'ALL', 'RUNNING'. By default, it lists all instances. + """ + UNDEFINED_INSTANCE_STATE = 0 + ALL = 64897 + RUNNING = 121282975 + + instance_state = proto.Field( + proto.ENUM, number=92223591, optional=True, enum=InstanceState, + ) + port_name = proto.Field(proto.STRING, number=41534345, optional=True,) -class EnableXpnResourceProjectRequest(proto.Message): - r"""A request message for Projects.EnableXpnResource. See the - method description for details. +class RegionInstanceGroupsSetNamedPortsRequest(proto.Message): + r""" + Attributes: + fingerprint (str): + The fingerprint of the named ports + information for this instance group. Use this + optional property to prevent conflicts when + multiple users change the named ports settings + concurrently. Obtain the fingerprint with the + instanceGroups.get method. Then, include the + fingerprint in your request to ensure that you + do not overwrite changes that were applied from + another concurrent request. + named_ports (Sequence[google.cloud.compute_v1.types.NamedPort]): + The list of named ports to set for this + instance group. + """ + + fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) + named_ports = proto.RepeatedField( + proto.MESSAGE, number=427598732, message="NamedPort", + ) + +class RegionList(proto.Message): + r"""Contains a list of region resources. Attributes: - project (str): - Project ID for this request. - projects_enable_xpn_resource_request_resource (google.cloud.compute_v1.types.ProjectsEnableXpnResourceRequest): - The body resource for this request - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.Region]): + A list of Region resources. + kind (str): + [Output Only] Type of resource. Always compute#regionList + for lists of regions. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - project = proto.Field(proto.STRING, number=227560217,) - projects_enable_xpn_resource_request_resource = proto.Field( - proto.MESSAGE, number=421980207, message="ProjectsEnableXpnResourceRequest", - ) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Region",) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class GetProjectRequest(proto.Message): - r"""A request message for Projects.Get. See the method - description for details. +class RegionSetLabelsRequest(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. + label_fingerprint (str): + The fingerprint of the previous set of labels + for this resource, used to detect conflicts. The + fingerprint is initially generated by Compute + Engine and changes after every request to modify + or update labels. You must always provide an up- + to-date fingerprint hash in order to update or + change labels. Make a get() request to the + resource to get the latest fingerprint. + labels (Sequence[google.cloud.compute_v1.types.RegionSetLabelsRequest.LabelsEntry]): + The labels to set for this resource. """ - project = proto.Field(proto.STRING, number=227560217,) - + label_fingerprint = proto.Field(proto.STRING, number=178124825, optional=True,) + labels = proto.MapField(proto.STRING, proto.STRING, number=500195327,) -class GetXpnHostProjectRequest(proto.Message): - r"""A request message for Projects.GetXpnHost. See the method - description for details. +class RegionSetPolicyRequest(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. + bindings (Sequence[google.cloud.compute_v1.types.Binding]): + Flatten Policy to create a backwacd + compatible wire-format. Deprecated. Use 'policy' + to specify bindings. + etag (str): + Flatten Policy to create a backward + compatible wire-format. Deprecated. Use 'policy' + to specify the etag. + policy (google.cloud.compute_v1.types.Policy): + REQUIRED: The complete policy to be applied + to the 'resource'. The size of the policy is + limited to a few 10s of KB. An empty policy is + in general a valid policy but certain services + (like Projects) might reject them. """ - project = proto.Field(proto.STRING, number=227560217,) - + bindings = proto.RepeatedField(proto.MESSAGE, number=403251854, message="Binding",) + etag = proto.Field(proto.STRING, number=3123477, optional=True,) + policy = proto.Field( + proto.MESSAGE, number=91071794, optional=True, message="Policy", + ) -class GetXpnResourcesProjectsRequest(proto.Message): - r"""A request message for Projects.GetXpnResources. See the - method description for details. +class RegionTargetHttpsProxiesSetSslCertificatesRequest(proto.Message): + r""" Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + ssl_certificates (Sequence[str]): + New set of SslCertificate resources to + associate with this TargetHttpsProxy resource. + Currently exactly one SslCertificate resource + must be specified. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - + ssl_certificates = proto.RepeatedField(proto.STRING, number=366006543,) -class ListXpnHostsProjectsRequest(proto.Message): - r"""A request message for Projects.ListXpnHosts. See the method - description for details. +class RegionUrlMapsValidateRequest(proto.Message): + r""" Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - projects_list_xpn_hosts_request_resource (google.cloud.compute_v1.types.ProjectsListXpnHostsRequest): - The body resource for this request - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + resource (google.cloud.compute_v1.types.UrlMap): + Content of the UrlMap to be validated. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - projects_list_xpn_hosts_request_resource = proto.Field( - proto.MESSAGE, number=238266391, message="ProjectsListXpnHostsRequest", + resource = proto.Field( + proto.MESSAGE, number=195806222, optional=True, message="UrlMap", ) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class MoveDiskProjectRequest(proto.Message): - r"""A request message for Projects.MoveDisk. See the method - description for details. +class RemoveAssociationFirewallPolicyRequest(proto.Message): + r"""A request message for FirewallPolicies.RemoveAssociation. See + the method description for details. Attributes: - disk_move_request_resource (google.cloud.compute_v1.types.DiskMoveRequest): - The body resource for this request - project (str): - Project ID for this request. + firewall_policy (str): + Name of the firewall policy to update. + name (str): + Name for the attachment that will be removed. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - disk_move_request_resource = proto.Field( - proto.MESSAGE, number=313008458, message="DiskMoveRequest", - ) - project = proto.Field(proto.STRING, number=227560217,) + firewall_policy = proto.Field(proto.STRING, number=498173265,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class MoveInstanceProjectRequest(proto.Message): - r"""A request message for Projects.MoveInstance. See the method - description for details. +class RemoveHealthCheckTargetPoolRequest(proto.Message): + r"""A request message for TargetPools.RemoveHealthCheck. See the + method description for details. Attributes: - instance_move_request_resource (google.cloud.compute_v1.types.InstanceMoveRequest): - The body resource for this request project (str): Project ID for this request. + region (str): + Name of the region for this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_pool (str): + Name of the target pool to remove health + checks from. + target_pools_remove_health_check_request_resource (google.cloud.compute_v1.types.TargetPoolsRemoveHealthCheckRequest): + The body resource for this request """ - instance_move_request_resource = proto.Field( - proto.MESSAGE, number=311664194, message="InstanceMoveRequest", - ) project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_pool = proto.Field(proto.STRING, number=62796298,) + target_pools_remove_health_check_request_resource = proto.Field( + proto.MESSAGE, number=304985011, message="TargetPoolsRemoveHealthCheckRequest", + ) -class SetCommonInstanceMetadataProjectRequest(proto.Message): - r"""A request message for Projects.SetCommonInstanceMetadata. See - the method description for details. +class RemoveInstanceTargetPoolRequest(proto.Message): + r"""A request message for TargetPools.RemoveInstance. See the + method description for details. Attributes: - metadata_resource (google.cloud.compute_v1.types.Metadata): - The body resource for this request project (str): Project ID for this request. + region (str): + Name of the region scoping this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_pool (str): + Name of the TargetPool resource to remove + instances from. + target_pools_remove_instance_request_resource (google.cloud.compute_v1.types.TargetPoolsRemoveInstanceRequest): + The body resource for this request """ - metadata_resource = proto.Field( - proto.MESSAGE, number=291086110, message="Metadata", - ) project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_pool = proto.Field(proto.STRING, number=62796298,) + target_pools_remove_instance_request_resource = proto.Field( + proto.MESSAGE, number=29548547, message="TargetPoolsRemoveInstanceRequest", + ) -class SetDefaultNetworkTierProjectRequest(proto.Message): - r"""A request message for Projects.SetDefaultNetworkTier. See the +class RemoveInstancesInstanceGroupRequest(proto.Message): + r"""A request message for InstanceGroups.RemoveInstances. See the method description for details. Attributes: + instance_group (str): + The name of the instance group where the + specified instances will be removed. + instance_groups_remove_instances_request_resource (google.cloud.compute_v1.types.InstanceGroupsRemoveInstancesRequest): + The body resource for this request project (str): Project ID for this request. - projects_set_default_network_tier_request_resource (google.cloud.compute_v1.types.ProjectsSetDefaultNetworkTierRequest): - The body resource for this request request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone where the instance group + is located. """ - project = proto.Field(proto.STRING, number=227560217,) - projects_set_default_network_tier_request_resource = proto.Field( - proto.MESSAGE, number=126410762, message="ProjectsSetDefaultNetworkTierRequest", + instance_group = proto.Field(proto.STRING, number=81095253,) + instance_groups_remove_instances_request_resource = proto.Field( + proto.MESSAGE, number=390981817, message="InstanceGroupsRemoveInstancesRequest", ) + project = proto.Field(proto.STRING, number=227560217,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class SetUsageExportBucketProjectRequest(proto.Message): - r"""A request message for Projects.SetUsageExportBucket. See the - method description for details. +class RemovePeeringNetworkRequest(proto.Message): + r"""A request message for Networks.RemovePeering. See the method + description for details. Attributes: + network (str): + Name of the network resource to remove + peering from. + networks_remove_peering_request_resource (google.cloud.compute_v1.types.NetworksRemovePeeringRequest): + The body resource for this request project (str): Project ID for this request. request_id (str): @@ -37958,727 +37010,620 @@ class SetUsageExportBucketProjectRequest(proto.Message): Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - usage_export_location_resource (google.cloud.compute_v1.types.UsageExportLocation): - The body resource for this request + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ + network = proto.Field(proto.STRING, number=232872494,) + networks_remove_peering_request_resource = proto.Field( + proto.MESSAGE, number=421162494, message="NetworksRemovePeeringRequest", + ) project = proto.Field(proto.STRING, number=227560217,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - usage_export_location_resource = proto.Field( - proto.MESSAGE, number=20260459, message="UsageExportLocation", - ) -class DeletePublicAdvertisedPrefixeRequest(proto.Message): - r"""A request message for PublicAdvertisedPrefixes.Delete. See - the method description for details. +class RemoveResourcePoliciesDiskRequest(proto.Message): + r"""A request message for Disks.RemoveResourcePolicies. See the + method description for details. Attributes: + disk (str): + The disk name for this request. + disks_remove_resource_policies_request_resource (google.cloud.compute_v1.types.DisksRemoveResourcePoliciesRequest): + The body resource for this request project (str): Project ID for this request. - public_advertised_prefix (str): - Name of the PublicAdvertisedPrefix resource - to delete. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. """ + disk = proto.Field(proto.STRING, number=3083677,) + disks_remove_resource_policies_request_resource = proto.Field( + proto.MESSAGE, number=436756718, message="DisksRemoveResourcePoliciesRequest", + ) project = proto.Field(proto.STRING, number=227560217,) - public_advertised_prefix = proto.Field(proto.STRING, number=101874590,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class GetPublicAdvertisedPrefixeRequest(proto.Message): - r"""A request message for PublicAdvertisedPrefixes.Get. See the - method description for details. - - Attributes: - project (str): - Project ID for this request. - public_advertised_prefix (str): - Name of the PublicAdvertisedPrefix resource - to return. - """ - - project = proto.Field(proto.STRING, number=227560217,) - public_advertised_prefix = proto.Field(proto.STRING, number=101874590,) - - -class InsertPublicAdvertisedPrefixeRequest(proto.Message): - r"""A request message for PublicAdvertisedPrefixes.Insert. See +class RemoveResourcePoliciesInstanceRequest(proto.Message): + r"""A request message for Instances.RemoveResourcePolicies. See the method description for details. Attributes: + instance (str): + The instance name for this request. + instances_remove_resource_policies_request_resource (google.cloud.compute_v1.types.InstancesRemoveResourcePoliciesRequest): + The body resource for this request project (str): Project ID for this request. - public_advertised_prefix_resource (google.cloud.compute_v1.types.PublicAdvertisedPrefix): - The body resource for this request request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. """ - project = proto.Field(proto.STRING, number=227560217,) - public_advertised_prefix_resource = proto.Field( - proto.MESSAGE, number=233614223, message="PublicAdvertisedPrefix", + instance = proto.Field(proto.STRING, number=18257045,) + instances_remove_resource_policies_request_resource = proto.Field( + proto.MESSAGE, + number=49229558, + message="InstancesRemoveResourcePoliciesRequest", ) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - - -class ListPublicAdvertisedPrefixesRequest(proto.Message): - r"""A request message for PublicAdvertisedPrefixes.List. See the - method description for details. - - Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. - """ - - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class PatchPublicAdvertisedPrefixeRequest(proto.Message): - r"""A request message for PublicAdvertisedPrefixes.Patch. See the - method description for details. +class RemoveResourcePoliciesRegionDiskRequest(proto.Message): + r"""A request message for RegionDisks.RemoveResourcePolicies. See + the method description for details. Attributes: + disk (str): + The disk name for this request. project (str): Project ID for this request. - public_advertised_prefix (str): - Name of the PublicAdvertisedPrefix resource - to patch. - public_advertised_prefix_resource (google.cloud.compute_v1.types.PublicAdvertisedPrefix): + region (str): + The name of the region for this request. + region_disks_remove_resource_policies_request_resource (google.cloud.compute_v1.types.RegionDisksRemoveResourcePoliciesRequest): The body resource for this request request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ + disk = proto.Field(proto.STRING, number=3083677,) project = proto.Field(proto.STRING, number=227560217,) - public_advertised_prefix = proto.Field(proto.STRING, number=101874590,) - public_advertised_prefix_resource = proto.Field( - proto.MESSAGE, number=233614223, message="PublicAdvertisedPrefix", + region = proto.Field(proto.STRING, number=138946292,) + region_disks_remove_resource_policies_request_resource = proto.Field( + proto.MESSAGE, + number=8741283, + message="RegionDisksRemoveResourcePoliciesRequest", ) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class AggregatedListPublicDelegatedPrefixesRequest(proto.Message): - r"""A request message for PublicDelegatedPrefixes.AggregatedList. - See the method description for details. - - Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Name of the project scoping this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. - """ - - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - - -class DeletePublicDelegatedPrefixeRequest(proto.Message): - r"""A request message for PublicDelegatedPrefixes.Delete. See the +class RemoveRuleFirewallPolicyRequest(proto.Message): + r"""A request message for FirewallPolicies.RemoveRule. See the method description for details. - Attributes: - project (str): - Project ID for this request. - public_delegated_prefix (str): - Name of the PublicDelegatedPrefix resource to - delete. - region (str): - Name of the region of this request. + Attributes: + firewall_policy (str): + Name of the firewall policy to update. + priority (int): + The priority of the rule to remove from the + firewall policy. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - project = proto.Field(proto.STRING, number=227560217,) - public_delegated_prefix = proto.Field(proto.STRING, number=204238440,) - region = proto.Field(proto.STRING, number=138946292,) + firewall_policy = proto.Field(proto.STRING, number=498173265,) + priority = proto.Field(proto.INT32, number=445151652, optional=True,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class GetPublicDelegatedPrefixeRequest(proto.Message): - r"""A request message for PublicDelegatedPrefixes.Get. See the +class RemoveRuleSecurityPolicyRequest(proto.Message): + r"""A request message for SecurityPolicies.RemoveRule. See the method description for details. Attributes: + priority (int): + The priority of the rule to remove from the + security policy. project (str): Project ID for this request. - public_delegated_prefix (str): - Name of the PublicDelegatedPrefix resource to - return. - region (str): - Name of the region of this request. + security_policy (str): + Name of the security policy to update. """ + priority = proto.Field(proto.INT32, number=445151652, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - public_delegated_prefix = proto.Field(proto.STRING, number=204238440,) - region = proto.Field(proto.STRING, number=138946292,) + security_policy = proto.Field(proto.STRING, number=171082513,) -class InsertPublicDelegatedPrefixeRequest(proto.Message): - r"""A request message for PublicDelegatedPrefixes.Insert. See the - method description for details. +class RequestMirrorPolicy(proto.Message): + r"""A policy that specifies how requests intended for the route's + backends are shadowed to a separate mirrored backend service. + Loadbalancer does not wait for responses from the shadow + service. Prior to sending traffic to the shadow service, the + host / authority header is suffixed with -shadow. Attributes: - project (str): - Project ID for this request. - public_delegated_prefix_resource (google.cloud.compute_v1.types.PublicDelegatedPrefix): - The body resource for this request - region (str): - Name of the region of this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + backend_service (str): + The full or partial URL to the BackendService + resource being mirrored to. """ - project = proto.Field(proto.STRING, number=227560217,) - public_delegated_prefix_resource = proto.Field( - proto.MESSAGE, number=47594501, message="PublicDelegatedPrefix", + backend_service = proto.Field(proto.STRING, number=306946058, optional=True,) + + +class Reservation(proto.Message): + r"""Represents a reservation resource. A reservation ensures that + capacity is held in a specific zone even if the reserved VMs are + not running. For more information, read Reserving zonal + resources. + + Attributes: + commitment (str): + [Output Only] Full or partial URL to a parent commitment. + This field displays for reservations that are tied to a + commitment. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + kind (str): + [Output Only] Type of the resource. Always + compute#reservations for reservations. + name (str): + The name of the resource, provided by the client when + initially creating the resource. The resource name must be + 1-63 characters long, and comply with RFC1035. Specifically, + the name must be 1-63 characters long and match the regular + expression ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the + first character must be a lowercase letter, and all + following characters must be a dash, lowercase letter, or + digit, except the last character, which cannot be a dash. + satisfies_pzs (bool): + [Output Only] Reserved for future use. + self_link (str): + [Output Only] Server-defined fully-qualified URL for this + resource. + specific_reservation (google.cloud.compute_v1.types.AllocationSpecificSKUReservation): + Reservation for instances with specific + machine shapes. + specific_reservation_required (bool): + Indicates whether the reservation can be + consumed by VMs with affinity for "any" + reservation. If the field is set, then only VMs + that target the reservation by name can consume + from this reservation. + status (google.cloud.compute_v1.types.Reservation.Status): + [Output Only] The status of the reservation. + zone (str): + Zone in which the reservation resides. A zone + must be provided if the reservation is created + within a commitment. + """ + + class Status(proto.Enum): + r"""[Output Only] The status of the reservation.""" + UNDEFINED_STATUS = 0 + CREATING = 455564985 + DELETING = 528602024 + INVALID = 530283991 + READY = 77848963 + UPDATING = 494614342 + + commitment = proto.Field(proto.STRING, number=482134805, optional=True,) + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + satisfies_pzs = proto.Field(proto.BOOL, number=480964267, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + specific_reservation = proto.Field( + proto.MESSAGE, + number=404901951, + optional=True, + message="AllocationSpecificSKUReservation", ) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + specific_reservation_required = proto.Field( + proto.BOOL, number=226550687, optional=True, + ) + status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) + zone = proto.Field(proto.STRING, number=3744684, optional=True,) -class ListPublicDelegatedPrefixesRequest(proto.Message): - r"""A request message for PublicDelegatedPrefixes.List. See the - method description for details. +class ReservationAffinity(proto.Message): + r"""Specifies the reservations that this instance can consume + from. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. + consume_reservation_type (google.cloud.compute_v1.types.ReservationAffinity.ConsumeReservationType): + Specifies the type of reservation from which this instance + can consume resources: ANY_RESERVATION (default), + SPECIFIC_RESERVATION, or NO_RESERVATION. See Consuming + reserved instances for examples. + key (str): + Corresponds to the label key of a reservation resource. To + target a SPECIFIC_RESERVATION by name, specify + googleapis.com/reservation-name as the key and specify the + name of your reservation as its value. + values (Sequence[str]): + Corresponds to the label values of a + reservation resource. This can be either a name + to a reservation in the same project or + "projects/different-project/reservations/some- + reservation-name" to target a shared reservation + in the same zone but in a different project. + """ - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + class ConsumeReservationType(proto.Enum): + r"""Specifies the type of reservation from which this instance can + consume resources: ANY_RESERVATION (default), SPECIFIC_RESERVATION, + or NO_RESERVATION. See Consuming reserved instances for examples. + """ + UNDEFINED_CONSUME_RESERVATION_TYPE = 0 + ANY_RESERVATION = 200008121 + NO_RESERVATION = 169322030 + SPECIFIC_RESERVATION = 229889055 + UNSPECIFIED = 526786327 - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + consume_reservation_type = proto.Field( + proto.ENUM, number=300736944, optional=True, enum=ConsumeReservationType, + ) + key = proto.Field(proto.STRING, number=106079, optional=True,) + values = proto.RepeatedField(proto.STRING, number=249928994,) - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. +class ReservationAggregatedList(proto.Message): + r"""Contains a list of reservations. + Attributes: + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.ReservationAggregatedList.ItemsEntry]): + A list of Allocation resources. + kind (str): + Type of resource. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. + """ - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - region (str): - Name of the region of this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + @property + def raw_page(self): + return self + + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.MapField( + proto.STRING, proto.MESSAGE, number=100526016, message="ReservationsScopedList", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) + + +class ReservationList(proto.Message): + r""" + Attributes: + id (str): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + items (Sequence[google.cloud.compute_v1.types.Reservation]): + [Output Only] A list of Allocation resources. + kind (str): + [Output Only] Type of resource.Always + compute#reservationsList for listsof reservations + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + @property + def raw_page(self): + return self + + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Reservation",) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class PatchPublicDelegatedPrefixeRequest(proto.Message): - r"""A request message for PublicDelegatedPrefixes.Patch. See the - method description for details. +class ReservationsResizeRequest(proto.Message): + r""" + Attributes: + specific_sku_count (int): + Number of allocated resources can be resized + with minimum = 1 and maximum = 1000. + """ + + specific_sku_count = proto.Field(proto.INT64, number=13890720, optional=True,) + + +class ReservationsScopedList(proto.Message): + r""" + Attributes: + reservations (Sequence[google.cloud.compute_v1.types.Reservation]): + A list of reservations contained in this + scope. + warning (google.cloud.compute_v1.types.Warning): + Informational warning which replaces the list + of reservations when the list is empty. + """ + + reservations = proto.RepeatedField( + proto.MESSAGE, number=399717927, message="Reservation", + ) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) + + +class ResetInstanceRequest(proto.Message): + r"""A request message for Instances.Reset. See the method + description for details. Attributes: + instance (str): + Name of the instance scoping this request. project (str): Project ID for this request. - public_delegated_prefix (str): - Name of the PublicDelegatedPrefix resource to - patch. - public_delegated_prefix_resource (google.cloud.compute_v1.types.PublicDelegatedPrefix): - The body resource for this request - region (str): - Name of the region for this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. """ + instance = proto.Field(proto.STRING, number=18257045,) project = proto.Field(proto.STRING, number=227560217,) - public_delegated_prefix = proto.Field(proto.STRING, number=204238440,) - public_delegated_prefix_resource = proto.Field( - proto.MESSAGE, number=47594501, message="PublicDelegatedPrefix", - ) - region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class DeleteRegionAutoscalerRequest(proto.Message): - r"""A request message for RegionAutoscalers.Delete. See the - method description for details. +class ResizeDiskRequest(proto.Message): + r"""A request message for Disks.Resize. See the method + description for details. Attributes: - autoscaler (str): - Name of the autoscaler to delete. + disk (str): + The name of the persistent disk. + disks_resize_request_resource (google.cloud.compute_v1.types.DisksResizeRequest): + The body resource for this request project (str): Project ID for this request. - region (str): - Name of the region scoping this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. """ - autoscaler = proto.Field(proto.STRING, number=517258967,) + disk = proto.Field(proto.STRING, number=3083677,) + disks_resize_request_resource = proto.Field( + proto.MESSAGE, number=78307616, message="DisksResizeRequest", + ) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class GetRegionAutoscalerRequest(proto.Message): - r"""A request message for RegionAutoscalers.Get. See the method - description for details. - - Attributes: - autoscaler (str): - Name of the autoscaler to return. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - """ - - autoscaler = proto.Field(proto.STRING, number=517258967,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - - -class InsertRegionAutoscalerRequest(proto.Message): - r"""A request message for RegionAutoscalers.Insert. See the +class ResizeInstanceGroupManagerRequest(proto.Message): + r"""A request message for InstanceGroupManagers.Resize. See the method description for details. Attributes: - autoscaler_resource (google.cloud.compute_v1.types.Autoscaler): - The body resource for this request + instance_group_manager (str): + The name of the managed instance group. project (str): Project ID for this request. - region (str): - Name of the region scoping this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + size (int): + The number of running instances that the + managed instance group should maintain at any + given time. The group automatically adds or + removes instances to maintain the number of + instances specified by this parameter. + zone (str): + The name of the zone where the managed + instance group is located. """ - autoscaler_resource = proto.Field( - proto.MESSAGE, number=207616118, message="Autoscaler", - ) + instance_group_manager = proto.Field(proto.STRING, number=249363395,) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + size = proto.Field(proto.INT32, number=3530753,) + zone = proto.Field(proto.STRING, number=3744684,) -class ListRegionAutoscalersRequest(proto.Message): - r"""A request message for RegionAutoscalers.List. See the method +class ResizeRegionDiskRequest(proto.Message): + r"""A request message for RegionDisks.Resize. See the method description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. + disk (str): + Name of the regional persistent disk. project (str): - Project ID for this request. + The project ID for this request. region (str): - Name of the region scoping this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. - """ - - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - - -class PatchRegionAutoscalerRequest(proto.Message): - r"""A request message for RegionAutoscalers.Patch. See the method - description for details. - - Attributes: - autoscaler (str): - Name of the autoscaler to patch. - autoscaler_resource (google.cloud.compute_v1.types.Autoscaler): + Name of the region for this request. + region_disks_resize_request_resource (google.cloud.compute_v1.types.RegionDisksResizeRequest): The body resource for this request - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - autoscaler = proto.Field(proto.STRING, number=517258967, optional=True,) - autoscaler_resource = proto.Field( - proto.MESSAGE, number=207616118, message="Autoscaler", - ) + disk = proto.Field(proto.STRING, number=3083677,) project = proto.Field(proto.STRING, number=227560217,) region = proto.Field(proto.STRING, number=138946292,) + region_disks_resize_request_resource = proto.Field( + proto.MESSAGE, number=446633237, message="RegionDisksResizeRequest", + ) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class UpdateRegionAutoscalerRequest(proto.Message): - r"""A request message for RegionAutoscalers.Update. See the - method description for details. - - Attributes: - autoscaler (str): - Name of the autoscaler to update. - autoscaler_resource (google.cloud.compute_v1.types.Autoscaler): - The body resource for this request +class ResizeRegionInstanceGroupManagerRequest(proto.Message): + r"""A request message for RegionInstanceGroupManagers.Resize. See + the method description for details. + + Attributes: + instance_group_manager (str): + Name of the managed instance group. project (str): Project ID for this request. region (str): @@ -38688,4149 +37633,4272 @@ class UpdateRegionAutoscalerRequest(proto.Message): Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + size (int): + Number of instances that should exist in this + instance group manager. """ - autoscaler = proto.Field(proto.STRING, number=517258967, optional=True,) - autoscaler_resource = proto.Field( - proto.MESSAGE, number=207616118, message="Autoscaler", - ) + instance_group_manager = proto.Field(proto.STRING, number=249363395,) project = proto.Field(proto.STRING, number=227560217,) region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + size = proto.Field(proto.INT32, number=3530753,) -class DeleteRegionBackendServiceRequest(proto.Message): - r"""A request message for RegionBackendServices.Delete. See the - method description for details. +class ResizeReservationRequest(proto.Message): + r"""A request message for Reservations.Resize. See the method + description for details. Attributes: - backend_service (str): - Name of the BackendService resource to - delete. project (str): Project ID for this request. - region (str): - Name of the region scoping this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + reservation (str): + Name of the reservation to update. + reservations_resize_request_resource (google.cloud.compute_v1.types.ReservationsResizeRequest): + The body resource for this request + zone (str): + Name of the zone for this request. """ - backend_service = proto.Field(proto.STRING, number=306946058,) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + reservation = proto.Field(proto.STRING, number=47530956,) + reservations_resize_request_resource = proto.Field( + proto.MESSAGE, number=389262801, message="ReservationsResizeRequest", + ) + zone = proto.Field(proto.STRING, number=3744684,) -class GetRegionBackendServiceRequest(proto.Message): - r"""A request message for RegionBackendServices.Get. See the - method description for details. +class ResourceCommitment(proto.Message): + r"""Commitment for a particular resource (a Commitment is + composed of one or more of these). Attributes: - backend_service (str): - Name of the BackendService resource to - return. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. + accelerator_type (str): + Name of the accelerator type resource. + Applicable only when the type is ACCELERATOR. + amount (int): + The amount of the resource purchased (in a + type-dependent unit, such as bytes). For vCPUs, + this can just be an integer. For memory, this + must be provided in MB. Memory must be a + multiple of 256 MB, with up to 6.5GB of memory + per every vCPU. + type_ (google.cloud.compute_v1.types.ResourceCommitment.Type): + Type of resource for which this commitment + applies. Possible values are VCPU and MEMORY """ - backend_service = proto.Field(proto.STRING, number=306946058,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) + class Type(proto.Enum): + r"""Type of resource for which this commitment applies. Possible + values are VCPU and MEMORY + """ + UNDEFINED_TYPE = 0 + ACCELERATOR = 429815371 + LOCAL_SSD = 508934896 + MEMORY = 123056385 + UNSPECIFIED = 526786327 + VCPU = 2628978 + accelerator_type = proto.Field(proto.STRING, number=138031246, optional=True,) + amount = proto.Field(proto.INT64, number=196759640, optional=True,) + type_ = proto.Field(proto.ENUM, number=3575610, optional=True, enum=Type,) -class GetHealthRegionBackendServiceRequest(proto.Message): - r"""A request message for RegionBackendServices.GetHealth. See - the method description for details. +class ResourceGroupReference(proto.Message): + r""" Attributes: - backend_service (str): - Name of the BackendService resource for which - to get health. - project (str): - - region (str): - Name of the region scoping this request. - resource_group_reference_resource (google.cloud.compute_v1.types.ResourceGroupReference): - The body resource for this request + group (str): + A URI referencing one of the instance groups + or network endpoint groups listed in the backend + service. """ - backend_service = proto.Field(proto.STRING, number=306946058,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - resource_group_reference_resource = proto.Field( - proto.MESSAGE, number=112951123, message="ResourceGroupReference", - ) - + group = proto.Field(proto.STRING, number=98629247, optional=True,) -class InsertRegionBackendServiceRequest(proto.Message): - r"""A request message for RegionBackendServices.Insert. See the - method description for details. +class ResourcePoliciesScopedList(proto.Message): + r""" Attributes: - backend_service_resource (google.cloud.compute_v1.types.BackendService): - The body resource for this request - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + resource_policies (Sequence[google.cloud.compute_v1.types.ResourcePolicy]): + A list of resourcePolicies contained in this + scope. + warning (google.cloud.compute_v1.types.Warning): + Informational warning which replaces the list + of resourcePolicies when the list is empty. """ - backend_service_resource = proto.Field( - proto.MESSAGE, number=347586723, message="BackendService", + resource_policies = proto.RepeatedField( + proto.MESSAGE, number=22220385, message="ResourcePolicy", + ) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", ) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class ListRegionBackendServicesRequest(proto.Message): - r"""A request message for RegionBackendServices.List. See the - method description for details. +class ResourcePolicy(proto.Message): + r"""Represents a Resource Policy resource. You can use resource + policies to schedule actions for some Compute Engine resources. + For example, you can use them to schedule persistent disk + snapshots. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + group_placement_policy (google.cloud.compute_v1.types.ResourcePolicyGroupPlacementPolicy): + Resource policy for instances for placement + configuration. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + instance_schedule_policy (google.cloud.compute_v1.types.ResourcePolicyInstanceSchedulePolicy): + Resource policy for scheduling instance + operations. + kind (str): + [Output Only] Type of the resource. Always + compute#resource_policies for resource policies. + name (str): + The name of the resource, provided by the client when + initially creating the resource. The resource name must be + 1-63 characters long, and comply with RFC1035. Specifically, + the name must be 1-63 characters long and match the regular + expression ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the + first character must be a lowercase letter, and all + following characters must be a dash, lowercase letter, or + digit, except the last character, which cannot be a dash. + region (str): - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + resource_status (google.cloud.compute_v1.types.ResourcePolicyResourceStatus): + [Output Only] The system status of the resource policy. + self_link (str): + [Output Only] Server-defined fully-qualified URL for this + resource. + snapshot_schedule_policy (google.cloud.compute_v1.types.ResourcePolicySnapshotSchedulePolicy): + Resource policy for persistent disks for + creating snapshots. + status (google.cloud.compute_v1.types.ResourcePolicy.Status): + [Output Only] The status of resource policy creation. + """ - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. + class Status(proto.Enum): + r"""[Output Only] The status of resource policy creation.""" + UNDEFINED_STATUS = 0 + CREATING = 455564985 + DELETING = 528602024 + EXPIRED = 482489093 + INVALID = 530283991 + READY = 77848963 - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + group_placement_policy = proto.Field( + proto.MESSAGE, + number=10931596, + optional=True, + message="ResourcePolicyGroupPlacementPolicy", + ) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + instance_schedule_policy = proto.Field( + proto.MESSAGE, + number=344877104, + optional=True, + message="ResourcePolicyInstanceSchedulePolicy", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + region = proto.Field(proto.STRING, number=138946292, optional=True,) + resource_status = proto.Field( + proto.MESSAGE, + number=249429315, + optional=True, + message="ResourcePolicyResourceStatus", + ) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + snapshot_schedule_policy = proto.Field( + proto.MESSAGE, + number=218131295, + optional=True, + message="ResourcePolicySnapshotSchedulePolicy", + ) + status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + +class ResourcePolicyAggregatedList(proto.Message): + r"""Contains a list of resourcePolicies. + Attributes: + etag (str): + + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.ResourcePolicyAggregatedList.ItemsEntry]): + A list of ResourcePolicy resources. + kind (str): + Type of resource. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + @property + def raw_page(self): + return self + etag = proto.Field(proto.STRING, number=3123477, optional=True,) + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.MapField( + proto.STRING, + proto.MESSAGE, + number=100526016, + message="ResourcePoliciesScopedList", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class PatchRegionBackendServiceRequest(proto.Message): - r"""A request message for RegionBackendServices.Patch. See the - method description for details. +class ResourcePolicyDailyCycle(proto.Message): + r"""Time window specified for daily operations. Attributes: - backend_service (str): - Name of the BackendService resource to patch. - backend_service_resource (google.cloud.compute_v1.types.BackendService): - The body resource for this request - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + days_in_cycle (int): + Defines a schedule with units measured in + months. The value determines how many months + pass between the start of each cycle. + duration (str): + [Output only] A predetermined duration for the window, + automatically chosen to be the smallest possible in the + given scenario. + start_time (str): + Start time of the window. This must be in UTC + format that resolves to one of 00:00, 04:00, + 08:00, 12:00, 16:00, or 20:00. For example, both + 13:00-5 and 08:00 are valid. """ - backend_service = proto.Field(proto.STRING, number=306946058,) - backend_service_resource = proto.Field( - proto.MESSAGE, number=347586723, message="BackendService", - ) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + days_in_cycle = proto.Field(proto.INT32, number=369790004, optional=True,) + duration = proto.Field(proto.STRING, number=155471252, optional=True,) + start_time = proto.Field(proto.STRING, number=37467274, optional=True,) -class UpdateRegionBackendServiceRequest(proto.Message): - r"""A request message for RegionBackendServices.Update. See the - method description for details. +class ResourcePolicyGroupPlacementPolicy(proto.Message): + r"""A GroupPlacementPolicy specifies resource placement + configuration. It specifies the failure bucket separation as + well as network locality Attributes: - backend_service (str): - Name of the BackendService resource to - update. - backend_service_resource (google.cloud.compute_v1.types.BackendService): - The body resource for this request - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + availability_domain_count (int): + The number of availability domains instances + will be spread across. If two instances are in + different availability domain, they will not be + put in the same low latency network + collocation (google.cloud.compute_v1.types.ResourcePolicyGroupPlacementPolicy.Collocation): + Specifies network collocation + vm_count (int): + Number of vms in this placement group """ - backend_service = proto.Field(proto.STRING, number=306946058,) - backend_service_resource = proto.Field( - proto.MESSAGE, number=347586723, message="BackendService", - ) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + class Collocation(proto.Enum): + r"""Specifies network collocation""" + UNDEFINED_COLLOCATION = 0 + COLLOCATED = 103257554 + UNSPECIFIED_COLLOCATION = 464308205 + availability_domain_count = proto.Field( + proto.INT32, number=12453432, optional=True, + ) + collocation = proto.Field( + proto.ENUM, number=511156533, optional=True, enum=Collocation, + ) + vm_count = proto.Field(proto.INT32, number=261463431, optional=True,) -class AggregatedListRegionCommitmentsRequest(proto.Message): - r"""A request message for RegionCommitments.AggregatedList. See - the method description for details. +class ResourcePolicyHourlyCycle(proto.Message): + r"""Time window specified for hourly operations. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + duration (str): + [Output only] Duration of the time window, automatically + chosen to be smallest possible in the given scenario. + hours_in_cycle (int): + Defines a schedule with units measured in + hours. The value determines how many hours pass + between the start of each cycle. + start_time (str): + Time within the window to start the operations. It must be + in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT. + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + duration = proto.Field(proto.STRING, number=155471252, optional=True,) + hours_in_cycle = proto.Field(proto.INT32, number=526763132, optional=True,) + start_time = proto.Field(proto.STRING, number=37467274, optional=True,) - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. +class ResourcePolicyInstanceSchedulePolicy(proto.Message): + r"""An InstanceSchedulePolicy specifies when and how frequent + certain operations are performed on the instance. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + Attributes: + expiration_time (str): + The expiration time of the schedule. The + timestamp is an RFC3339 string. + start_time (str): + The start time of the schedule. The timestamp + is an RFC3339 string. + time_zone (str): + Specifies the time zone to be used in interpreting + Schedule.schedule. The value of this field must be a time + zone name from the tz database: + http://en.wikipedia.org/wiki/Tz_database. + vm_start_schedule (google.cloud.compute_v1.types.ResourcePolicyInstanceSchedulePolicySchedule): + Specifies the schedule for starting + instances. + vm_stop_schedule (google.cloud.compute_v1.types.ResourcePolicyInstanceSchedulePolicySchedule): + Specifies the schedule for stopping + instances. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + expiration_time = proto.Field(proto.STRING, number=230299229, optional=True,) + start_time = proto.Field(proto.STRING, number=37467274, optional=True,) + time_zone = proto.Field(proto.STRING, number=36848094, optional=True,) + vm_start_schedule = proto.Field( + proto.MESSAGE, + number=17762396, + optional=True, + message="ResourcePolicyInstanceSchedulePolicySchedule", + ) + vm_stop_schedule = proto.Field( + proto.MESSAGE, + number=426242732, + optional=True, + message="ResourcePolicyInstanceSchedulePolicySchedule", + ) + + +class ResourcePolicyInstanceSchedulePolicySchedule(proto.Message): + r"""Schedule for an instance operation. + Attributes: + schedule (str): + Specifies the frequency for the operation, + using the unix-cron format. + """ + schedule = proto.Field(proto.STRING, number=375820951, optional=True,) -class GetRegionCommitmentRequest(proto.Message): - r"""A request message for RegionCommitments.Get. See the method - description for details. +class ResourcePolicyList(proto.Message): + r""" Attributes: - commitment (str): - Name of the commitment to return. - project (str): - Project ID for this request. - region (str): - Name of the region for this request. + etag (str): + + id (str): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + items (Sequence[google.cloud.compute_v1.types.ResourcePolicy]): + [Output Only] A list of ResourcePolicy resources. + kind (str): + [Output Only] Type of resource.Always + compute#resourcePoliciesList for listsof resourcePolicies + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - commitment = proto.Field(proto.STRING, number=482134805,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) + @property + def raw_page(self): + return self + + etag = proto.Field(proto.STRING, number=3123477, optional=True,) + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="ResourcePolicy", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class InsertRegionCommitmentRequest(proto.Message): - r"""A request message for RegionCommitments.Insert. See the - method description for details. +class ResourcePolicyResourceStatus(proto.Message): + r"""Contains output only fields. Use this sub-message for all + output fields set on ResourcePolicy. The internal structure of + this "status" field should mimic the structure of ResourcePolicy + proto specification. Attributes: - commitment_resource (google.cloud.compute_v1.types.Commitment): - The body resource for this request - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + instance_schedule_policy (google.cloud.compute_v1.types.ResourcePolicyResourceStatusInstanceSchedulePolicyStatus): + [Output Only] Specifies a set of output values reffering to + the instance_schedule_policy system status. This field + should have the same name as corresponding policy field. """ - commitment_resource = proto.Field( - proto.MESSAGE, number=244240888, message="Commitment", + instance_schedule_policy = proto.Field( + proto.MESSAGE, + number=344877104, + optional=True, + message="ResourcePolicyResourceStatusInstanceSchedulePolicyStatus", ) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - -class ListRegionCommitmentsRequest(proto.Message): - r"""A request message for RegionCommitments.List. See the method - description for details. +class ResourcePolicyResourceStatusInstanceSchedulePolicyStatus(proto.Message): + r""" Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + last_run_start_time (str): + [Output Only] The last time the schedule successfully ran. + The timestamp is an RFC3339 string. + next_run_start_time (str): + [Output Only] The next time the schedule is planned to run. + The actual time might be slightly different. The timestamp + is an RFC3339 string. + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + last_run_start_time = proto.Field(proto.STRING, number=303069063, optional=True,) + next_run_start_time = proto.Field(proto.STRING, number=318642570, optional=True,) - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. +class ResourcePolicySnapshotSchedulePolicy(proto.Message): + r"""A snapshot schedule policy specifies when and how frequently + snapshots are to be created for the target disk. Also specifies + how many and how long these scheduled snapshots should be + retained. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + Attributes: + retention_policy (google.cloud.compute_v1.types.ResourcePolicySnapshotSchedulePolicyRetentionPolicy): + Retention policy applied to snapshots created + by this resource policy. + schedule (google.cloud.compute_v1.types.ResourcePolicySnapshotSchedulePolicySchedule): + A Vm Maintenance Policy specifies what kind + of infrastructure maintenance we are allowed to + perform on this VM and when. Schedule that is + applied to disks covered by this policy. + snapshot_properties (google.cloud.compute_v1.types.ResourcePolicySnapshotSchedulePolicySnapshotProperties): + Properties with which snapshots are created + such as labels, encryption keys. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - + retention_policy = proto.Field( + proto.MESSAGE, + number=68625779, + optional=True, + message="ResourcePolicySnapshotSchedulePolicyRetentionPolicy", + ) + schedule = proto.Field( + proto.MESSAGE, + number=375820951, + optional=True, + message="ResourcePolicySnapshotSchedulePolicySchedule", + ) + snapshot_properties = proto.Field( + proto.MESSAGE, + number=185371278, + optional=True, + message="ResourcePolicySnapshotSchedulePolicySnapshotProperties", + ) -class GetRegionDiskTypeRequest(proto.Message): - r"""A request message for RegionDiskTypes.Get. See the method - description for details. +class ResourcePolicySnapshotSchedulePolicyRetentionPolicy(proto.Message): + r"""Policy for retention of scheduled snapshots. Attributes: - disk_type (str): - Name of the disk type to return. - project (str): - Project ID for this request. - region (str): - The name of the region for this request. + max_retention_days (int): + Maximum age of the snapshot that is allowed + to be kept. + on_source_disk_delete (google.cloud.compute_v1.types.ResourcePolicySnapshotSchedulePolicyRetentionPolicy.OnSourceDiskDelete): + Specifies the behavior to apply to scheduled + snapshots when the source disk is deleted. """ - disk_type = proto.Field(proto.STRING, number=93009052,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) + class OnSourceDiskDelete(proto.Enum): + r"""Specifies the behavior to apply to scheduled snapshots when + the source disk is deleted. + """ + UNDEFINED_ON_SOURCE_DISK_DELETE = 0 + APPLY_RETENTION_POLICY = 535071332 + KEEP_AUTO_SNAPSHOTS = 258925689 + UNSPECIFIED_ON_SOURCE_DISK_DELETE = 239140769 + + max_retention_days = proto.Field(proto.INT32, number=324296979, optional=True,) + on_source_disk_delete = proto.Field( + proto.ENUM, number=321955529, optional=True, enum=OnSourceDiskDelete, + ) -class ListRegionDiskTypesRequest(proto.Message): - r"""A request message for RegionDiskTypes.List. See the method - description for details. +class ResourcePolicySnapshotSchedulePolicySchedule(proto.Message): + r"""A schedule for disks where the schedueled operations are + performed. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. + daily_schedule (google.cloud.compute_v1.types.ResourcePolicyDailyCycle): + + hourly_schedule (google.cloud.compute_v1.types.ResourcePolicyHourlyCycle): - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + weekly_schedule (google.cloud.compute_v1.types.ResourcePolicyWeeklyCycle): - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + """ - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. + daily_schedule = proto.Field( + proto.MESSAGE, + number=86159869, + optional=True, + message="ResourcePolicyDailyCycle", + ) + hourly_schedule = proto.Field( + proto.MESSAGE, + number=38328485, + optional=True, + message="ResourcePolicyHourlyCycle", + ) + weekly_schedule = proto.Field( + proto.MESSAGE, + number=359548053, + optional=True, + message="ResourcePolicyWeeklyCycle", + ) - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - region (str): - The name of the region for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. - """ +class ResourcePolicySnapshotSchedulePolicySnapshotProperties(proto.Message): + r"""Specified snapshot properties for scheduled snapshots created + by this policy. - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + Attributes: + chain_name (str): + Chain name that the snapshot is created in. + guest_flush (bool): + Indication to perform a 'guest aware' + snapshot. + labels (Sequence[google.cloud.compute_v1.types.ResourcePolicySnapshotSchedulePolicySnapshotProperties.LabelsEntry]): + Labels to apply to scheduled snapshots. These + can be later modified by the setLabels method. + Label values may be empty. + storage_locations (Sequence[str]): + Cloud Storage bucket storage location of the + auto snapshot (regional or multi-regional). + """ + chain_name = proto.Field(proto.STRING, number=68644169, optional=True,) + guest_flush = proto.Field(proto.BOOL, number=385550813, optional=True,) + labels = proto.MapField(proto.STRING, proto.STRING, number=500195327,) + storage_locations = proto.RepeatedField(proto.STRING, number=328005274,) -class AddResourcePoliciesRegionDiskRequest(proto.Message): - r"""A request message for RegionDisks.AddResourcePolicies. See - the method description for details. +class ResourcePolicyWeeklyCycle(proto.Message): + r"""Time window specified for weekly operations. Attributes: - disk (str): - The disk name for this request. - project (str): - Project ID for this request. - region (str): - The name of the region for this request. - region_disks_add_resource_policies_request_resource (google.cloud.compute_v1.types.RegionDisksAddResourcePoliciesRequest): - The body resource for this request - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + day_of_weeks (Sequence[google.cloud.compute_v1.types.ResourcePolicyWeeklyCycleDayOfWeek]): + Up to 7 intervals/windows, one for each day + of the week. """ - disk = proto.Field(proto.STRING, number=3083677,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - region_disks_add_resource_policies_request_resource = proto.Field( - proto.MESSAGE, - number=284196750, - message="RegionDisksAddResourcePoliciesRequest", + day_of_weeks = proto.RepeatedField( + proto.MESSAGE, number=257871834, message="ResourcePolicyWeeklyCycleDayOfWeek", ) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - -class CreateSnapshotRegionDiskRequest(proto.Message): - r"""A request message for RegionDisks.CreateSnapshot. See the - method description for details. +class ResourcePolicyWeeklyCycleDayOfWeek(proto.Message): + r""" Attributes: - disk (str): - Name of the regional persistent disk to - snapshot. - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - snapshot_resource (google.cloud.compute_v1.types.Snapshot): - The body resource for this request + day (google.cloud.compute_v1.types.ResourcePolicyWeeklyCycleDayOfWeek.Day): + Defines a schedule that runs on specific days + of the week. Specify one or more days. The + following options are available: MONDAY, + TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, + SUNDAY. + duration (str): + [Output only] Duration of the time window, automatically + chosen to be smallest possible in the given scenario. + start_time (str): + Time within the window to start the operations. It must be + in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT. """ - disk = proto.Field(proto.STRING, number=3083677,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - snapshot_resource = proto.Field( - proto.MESSAGE, number=481319977, message="Snapshot", - ) + class Day(proto.Enum): + r"""Defines a schedule that runs on specific days of the week. + Specify one or more days. The following options are available: + MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY. + """ + UNDEFINED_DAY = 0 + FRIDAY = 471398751 + INVALID = 530283991 + MONDAY = 132310288 + SATURDAY = 279037881 + SUNDAY = 309626320 + THURSDAY = 207198682 + TUESDAY = 277509677 + WEDNESDAY = 422029110 + + day = proto.Field(proto.ENUM, number=99228, optional=True, enum=Day,) + duration = proto.Field(proto.STRING, number=155471252, optional=True,) + start_time = proto.Field(proto.STRING, number=37467274, optional=True,) + + +class Route(proto.Message): + r"""Represents a Route resource. A route defines a path from VM + instances in the VPC network to a specific destination. This + destination can be inside or outside the VPC network. For more + information, read the Routes overview. + + Attributes: + as_paths (Sequence[google.cloud.compute_v1.types.RouteAsPath]): + [Output Only] AS path. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + An optional description of this resource. + Provide this field when you create the resource. + dest_range (str): + The destination range of outgoing packets + that this route applies to. Both IPv4 and IPv6 + are supported. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + kind (str): + [Output Only] Type of this resource. Always compute#routes + for Route resources. + name (str): + Name of the resource. Provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?``. The first character must be + a lowercase letter, and all following characters (except for + the last character) must be a dash, lowercase letter, or + digit. The last character must be a lowercase letter or + digit. + network (str): + Fully-qualified URL of the network that this + route applies to. + next_hop_gateway (str): + The URL to a gateway that should handle + matching packets. You can only specify the + internet gateway using a full or partial valid + URL: projects/ project/global/gateways/default- + internet-gateway + next_hop_ilb (str): + The URL to a forwarding rule of type + loadBalancingScheme=INTERNAL that should handle + matching packets or the IP address of the + forwarding Rule. For example, the following are + all valid URLs: - 10.128.0.56 - + https://www.googleapis.com/compute/v1/projects/project/regions/region + /forwardingRules/forwardingRule - + regions/region/forwardingRules/forwardingRule + next_hop_instance (str): + The URL to an instance that should handle + matching packets. You can specify this as a full + or partial URL. For example: + https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/ + next_hop_ip (str): + The network IP address of an instance that + should handle matching packets. Only IPv4 is + supported. + next_hop_network (str): + The URL of the local network if it should + handle matching packets. + next_hop_peering (str): + [Output Only] The network peering name that should handle + matching packets, which should conform to RFC1035. + next_hop_vpn_tunnel (str): + The URL to a VpnTunnel that should handle + matching packets. + priority (int): + The priority of this route. Priority is used to break ties + in cases where there is more than one matching route of + equal prefix length. In cases where multiple routes have + equal prefix length, the one with the lowest-numbered + priority value wins. The default value is ``1000``. The + priority value must be from ``0`` to ``65535``, inclusive. + route_type (google.cloud.compute_v1.types.Route.RouteType): + [Output Only] The type of this route, which can be one of + the following values: - 'TRANSIT' for a transit route that + this router learned from another Cloud Router and will + readvertise to one of its BGP peers - 'SUBNET' for a route + from a subnet of the VPC - 'BGP' for a route learned from a + BGP peer of this router - 'STATIC' for a static route + self_link (str): + [Output Only] Server-defined fully-qualified URL for this + resource. + tags (Sequence[str]): + A list of instance tags to which this route + applies. + warnings (Sequence[google.cloud.compute_v1.types.Warnings]): + [Output Only] If potential misconfigurations are detected + for this route, this field will be populated with warning + messages. + """ + class RouteType(proto.Enum): + r"""[Output Only] The type of this route, which can be one of the + following values: - 'TRANSIT' for a transit route that this router + learned from another Cloud Router and will readvertise to one of its + BGP peers - 'SUBNET' for a route from a subnet of the VPC - 'BGP' + for a route learned from a BGP peer of this router - 'STATIC' for a + static route + """ + UNDEFINED_ROUTE_TYPE = 0 + BGP = 65707 + STATIC = 308331118 + SUBNET = 309278557 + TRANSIT = 187793843 -class DeleteRegionDiskRequest(proto.Message): - r"""A request message for RegionDisks.Delete. See the method - description for details. + as_paths = proto.RepeatedField( + proto.MESSAGE, number=137568929, message="RouteAsPath", + ) + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + dest_range = proto.Field(proto.STRING, number=381327712, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + network = proto.Field(proto.STRING, number=232872494, optional=True,) + next_hop_gateway = proto.Field(proto.STRING, number=377175298, optional=True,) + next_hop_ilb = proto.Field(proto.STRING, number=198679901, optional=True,) + next_hop_instance = proto.Field(proto.STRING, number=393508247, optional=True,) + next_hop_ip = proto.Field(proto.STRING, number=110319529, optional=True,) + next_hop_network = proto.Field(proto.STRING, number=262295788, optional=True,) + next_hop_peering = proto.Field(proto.STRING, number=412682750, optional=True,) + next_hop_vpn_tunnel = proto.Field(proto.STRING, number=519844501, optional=True,) + priority = proto.Field(proto.UINT32, number=445151652, optional=True,) + route_type = proto.Field( + proto.ENUM, number=375888752, optional=True, enum=RouteType, + ) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + tags = proto.RepeatedField(proto.STRING, number=3552281,) + warnings = proto.RepeatedField(proto.MESSAGE, number=498091095, message="Warnings",) - Attributes: - disk (str): - Name of the regional persistent disk to - delete. - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - disk = proto.Field(proto.STRING, number=3083677,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) +class RouteAsPath(proto.Message): + r""" + Attributes: + as_lists (Sequence[int]): + [Output Only] The AS numbers of the AS Path. + path_segment_type (google.cloud.compute_v1.types.RouteAsPath.PathSegmentType): + [Output Only] The type of the AS Path, which can be one of + the following values: - 'AS_SET': unordered set of + autonomous systems that the route in has traversed - + 'AS_SEQUENCE': ordered set of autonomous systems that the + route has traversed - 'AS_CONFED_SEQUENCE': ordered set of + Member Autonomous Systems in the local confederation that + the route has traversed - 'AS_CONFED_SET': unordered set of + Member Autonomous Systems in the local confederation that + the route has traversed + """ + + class PathSegmentType(proto.Enum): + r"""[Output Only] The type of the AS Path, which can be one of the + following values: - 'AS_SET': unordered set of autonomous systems + that the route in has traversed - 'AS_SEQUENCE': ordered set of + autonomous systems that the route has traversed - + 'AS_CONFED_SEQUENCE': ordered set of Member Autonomous Systems in + the local confederation that the route has traversed - + 'AS_CONFED_SET': unordered set of Member Autonomous Systems in the + local confederation that the route has traversed + """ + UNDEFINED_PATH_SEGMENT_TYPE = 0 + AS_CONFED_SEQUENCE = 222152624 + AS_CONFED_SET = 374040307 + AS_SEQUENCE = 106735918 + AS_SET = 329846453 + as_lists = proto.RepeatedField(proto.UINT32, number=134112584,) + path_segment_type = proto.Field( + proto.ENUM, number=513464992, optional=True, enum=PathSegmentType, + ) -class GetRegionDiskRequest(proto.Message): - r"""A request message for RegionDisks.Get. See the method - description for details. +class RouteList(proto.Message): + r"""Contains a list of Route resources. Attributes: - disk (str): - Name of the regional persistent disk to - return. - project (str): - Project ID for this request. - region (str): - Name of the region for this request. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.Route]): + A list of Route resources. + kind (str): + Type of resource. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - disk = proto.Field(proto.STRING, number=3083677,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) + @property + def raw_page(self): + return self + + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Route",) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class GetIamPolicyRegionDiskRequest(proto.Message): - r"""A request message for RegionDisks.GetIamPolicy. See the - method description for details. +class Router(proto.Message): + r"""Represents a Cloud Router resource. For more information + about Cloud Router, read the Cloud Router overview. Attributes: - options_requested_policy_version (int): - Requested IAM Policy version. - project (str): - Project ID for this request. + bgp (google.cloud.compute_v1.types.RouterBgp): + BGP information specific to this router. + bgp_peers (Sequence[google.cloud.compute_v1.types.RouterBgpPeer]): + BGP information that must be configured into + the routing stack to establish BGP peering. This + information must specify the peer ASN and either + the interface name, IP address, or peer IP + address. Please refer to RFC4273. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + encrypted_interconnect_router (bool): + Indicates if a router is dedicated for use + with encrypted VLAN attachments + (interconnectAttachments). Not currently + available publicly. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + interfaces (Sequence[google.cloud.compute_v1.types.RouterInterface]): + Router interfaces. Each interface requires + either one linked resource, (for example, + linkedVpnTunnel), or IP address and IP address + range (for example, ipRange), or both. + kind (str): + [Output Only] Type of resource. Always compute#router for + routers. + name (str): + Name of the resource. Provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. + nats (Sequence[google.cloud.compute_v1.types.RouterNat]): + A list of NAT services created in this + router. + network (str): + URI of the network to which this router + belongs. region (str): - The name of the region for this request. - resource (str): - Name or id of the resource for this request. + [Output Only] URI of the region where the router resides. + You must specify this field as part of the HTTP request URL. + It is not settable as a field in the request body. + self_link (str): + [Output Only] Server-defined URL for the resource. """ - options_requested_policy_version = proto.Field( - proto.INT32, number=499220029, optional=True, + bgp = proto.Field(proto.MESSAGE, number=97483, optional=True, message="RouterBgp",) + bgp_peers = proto.RepeatedField( + proto.MESSAGE, number=452695773, message="RouterBgpPeer", ) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - resource = proto.Field(proto.STRING, number=195806222,) - + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + encrypted_interconnect_router = proto.Field( + proto.BOOL, number=297996575, optional=True, + ) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + interfaces = proto.RepeatedField( + proto.MESSAGE, number=12073562, message="RouterInterface", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + nats = proto.RepeatedField(proto.MESSAGE, number=3373938, message="RouterNat",) + network = proto.Field(proto.STRING, number=232872494, optional=True,) + region = proto.Field(proto.STRING, number=138946292, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) -class InsertRegionDiskRequest(proto.Message): - r"""A request message for RegionDisks.Insert. See the method - description for details. +class RouterAdvertisedIpRange(proto.Message): + r"""Description-tagged IP ranges for the router to advertise. Attributes: - disk_resource (google.cloud.compute_v1.types.Disk): - The body resource for this request - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - source_image (str): - Source image to restore onto a disk. This - field is optional. + description (str): + User-specified description for the IP range. + range_ (str): + The IP range to advertise. The value must be + a CIDR-formatted string. """ - disk_resource = proto.Field(proto.MESSAGE, number=25880688, message="Disk",) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - source_image = proto.Field(proto.STRING, number=50443319, optional=True,) - + description = proto.Field(proto.STRING, number=422937596, optional=True,) + range_ = proto.Field(proto.STRING, number=108280125, optional=True,) -class ListRegionDisksRequest(proto.Message): - r"""A request message for RegionDisks.List. See the method - description for details. +class RouterAggregatedList(proto.Message): + r"""Contains a list of routers. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.RouterAggregatedList.ItemsEntry]): + A list of Router resources. + kind (str): + Type of resource. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.MapField( + proto.STRING, proto.MESSAGE, number=100526016, message="RoutersScopedList", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class RemoveResourcePoliciesRegionDiskRequest(proto.Message): - r"""A request message for RegionDisks.RemoveResourcePolicies. See - the method description for details. +class RouterBgp(proto.Message): + r""" Attributes: - disk (str): - The disk name for this request. - project (str): - Project ID for this request. - region (str): - The name of the region for this request. - region_disks_remove_resource_policies_request_resource (google.cloud.compute_v1.types.RegionDisksRemoveResourcePoliciesRequest): - The body resource for this request - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + advertise_mode (google.cloud.compute_v1.types.RouterBgp.AdvertiseMode): + User-specified flag to indicate which mode to + use for advertisement. The options are DEFAULT + or CUSTOM. + advertised_groups (Sequence[google.cloud.compute_v1.types.RouterBgp.AdvertisedGroups]): + User-specified list of prefix groups to advertise in custom + mode. This field can only be populated if advertise_mode is + CUSTOM and is advertised to all peers of the router. These + groups will be advertised in addition to any specified + prefixes. Leave this field blank to advertise no custom + groups. + advertised_ip_ranges (Sequence[google.cloud.compute_v1.types.RouterAdvertisedIpRange]): + User-specified list of individual IP ranges to advertise in + custom mode. This field can only be populated if + advertise_mode is CUSTOM and is advertised to all peers of + the router. These IP ranges will be advertised in addition + to any specified groups. Leave this field blank to advertise + no custom IP ranges. + asn (int): + Local BGP Autonomous System Number (ASN). + Must be an RFC6996 private ASN, either 16-bit or + 32-bit. The value will be fixed for this router + resource. All VPN tunnels that link to this + router will have the same local ASN. + keepalive_interval (int): + The interval in seconds between BGP keepalive + messages that are sent to the peer. Hold time is + three times the interval at which keepalive + messages are sent, and the hold time is the + maximum number of seconds allowed to elapse + between successive keepalive messages that BGP + receives from a peer. BGP will use the smaller + of either the local hold time value or the + peer's hold time value as the hold time for the + BGP connection between the two peers. If set, + this value must be between 20 and 60. The + default is 20. """ - disk = proto.Field(proto.STRING, number=3083677,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - region_disks_remove_resource_policies_request_resource = proto.Field( - proto.MESSAGE, - number=8741283, - message="RegionDisksRemoveResourcePoliciesRequest", - ) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + class AdvertiseMode(proto.Enum): + r"""User-specified flag to indicate which mode to use for + advertisement. The options are DEFAULT or CUSTOM. + """ + UNDEFINED_ADVERTISE_MODE = 0 + CUSTOM = 388595569 + DEFAULT = 115302945 + class AdvertisedGroups(proto.Enum): + r"""""" + UNDEFINED_ADVERTISED_GROUPS = 0 + ALL_SUBNETS = 3622872 -class ResizeRegionDiskRequest(proto.Message): - r"""A request message for RegionDisks.Resize. See the method - description for details. + advertise_mode = proto.Field( + proto.ENUM, number=312134331, optional=True, enum=AdvertiseMode, + ) + advertised_groups = proto.RepeatedField( + proto.ENUM, number=21065526, enum=AdvertisedGroups, + ) + advertised_ip_ranges = proto.RepeatedField( + proto.MESSAGE, number=35449932, message="RouterAdvertisedIpRange", + ) + asn = proto.Field(proto.UINT32, number=96892, optional=True,) + keepalive_interval = proto.Field(proto.UINT32, number=276771516, optional=True,) + +class RouterBgpPeer(proto.Message): + r""" Attributes: - disk (str): - Name of the regional persistent disk. - project (str): - The project ID for this request. - region (str): - Name of the region for this request. - region_disks_resize_request_resource (google.cloud.compute_v1.types.RegionDisksResizeRequest): - The body resource for this request - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + advertise_mode (google.cloud.compute_v1.types.RouterBgpPeer.AdvertiseMode): + User-specified flag to indicate which mode to + use for advertisement. + advertised_groups (Sequence[google.cloud.compute_v1.types.RouterBgpPeer.AdvertisedGroups]): + User-specified list of prefix groups to advertise in custom + mode, which can take one of the following options: - + ALL_SUBNETS: Advertises all available subnets, including + peer VPC subnets. - ALL_VPC_SUBNETS: Advertises the router's + own VPC subnets. Note that this field can only be populated + if advertise_mode is CUSTOM and overrides the list defined + for the router (in the "bgp" message). These groups are + advertised in addition to any specified prefixes. Leave this + field blank to advertise no custom groups. + advertised_ip_ranges (Sequence[google.cloud.compute_v1.types.RouterAdvertisedIpRange]): + User-specified list of individual IP ranges to advertise in + custom mode. This field can only be populated if + advertise_mode is CUSTOM and overrides the list defined for + the router (in the "bgp" message). These IP ranges are + advertised in addition to any specified groups. Leave this + field blank to advertise no custom IP ranges. + advertised_route_priority (int): + The priority of routes advertised to this BGP + peer. Where there is more than one matching + route of maximum length, the routes with the + lowest priority value win. + bfd (google.cloud.compute_v1.types.RouterBgpPeerBfd): + BFD configuration for the BGP peering. + enable (google.cloud.compute_v1.types.RouterBgpPeer.Enable): + The status of the BGP peer connection. If set + to FALSE, any active session with the peer is + terminated and all associated routing + information is removed. If set to TRUE, the peer + connection can be established with routing + information. The default is TRUE. + interface_name (str): + Name of the interface the BGP peer is + associated with. + ip_address (str): + IP address of the interface inside Google + Cloud Platform. Only IPv4 is supported. + management_type (google.cloud.compute_v1.types.RouterBgpPeer.ManagementType): + [Output Only] The resource that configures and manages this + BGP peer. - MANAGED_BY_USER is the default value and can be + managed by you or other users - MANAGED_BY_ATTACHMENT is a + BGP peer that is configured and managed by Cloud + Interconnect, specifically by an InterconnectAttachment of + type PARTNER. Google automatically creates, updates, and + deletes this type of BGP peer when the PARTNER + InterconnectAttachment is created, updated, or deleted. + name (str): + Name of this BGP peer. The name must be 1-63 characters + long, and comply with RFC1035. Specifically, the name must + be 1-63 characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. + peer_asn (int): + Peer BGP Autonomous System Number (ASN). Each + BGP interface may use a different value. + peer_ip_address (str): + IP address of the BGP interface outside + Google Cloud Platform. Only IPv4 is supported. + router_appliance_instance (str): + URI of the VM instance that is used as third- + arty router appliances such as Next Gen + Firewalls, Virtual Routers, or Router + Appliances. The VM instance must be located in + zones contained in the same region as this Cloud + Router. The VM instance is the peer side of the + BGP session. """ - disk = proto.Field(proto.STRING, number=3083677,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - region_disks_resize_request_resource = proto.Field( - proto.MESSAGE, number=446633237, message="RegionDisksResizeRequest", - ) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + class AdvertiseMode(proto.Enum): + r"""User-specified flag to indicate which mode to use for + advertisement. + """ + UNDEFINED_ADVERTISE_MODE = 0 + CUSTOM = 388595569 + DEFAULT = 115302945 + class AdvertisedGroups(proto.Enum): + r"""""" + UNDEFINED_ADVERTISED_GROUPS = 0 + ALL_SUBNETS = 3622872 -class SetIamPolicyRegionDiskRequest(proto.Message): - r"""A request message for RegionDisks.SetIamPolicy. See the - method description for details. + class Enable(proto.Enum): + r"""The status of the BGP peer connection. If set to FALSE, any + active session with the peer is terminated and all associated + routing information is removed. If set to TRUE, the peer + connection can be established with routing information. The + default is TRUE. + """ + UNDEFINED_ENABLE = 0 + FALSE = 66658563 + TRUE = 2583950 - Attributes: - project (str): - Project ID for this request. - region (str): - The name of the region for this request. - region_set_policy_request_resource (google.cloud.compute_v1.types.RegionSetPolicyRequest): - The body resource for this request - resource (str): - Name or id of the resource for this request. - """ + class ManagementType(proto.Enum): + r"""[Output Only] The resource that configures and manages this BGP + peer. - MANAGED_BY_USER is the default value and can be managed by + you or other users - MANAGED_BY_ATTACHMENT is a BGP peer that is + configured and managed by Cloud Interconnect, specifically by an + InterconnectAttachment of type PARTNER. Google automatically + creates, updates, and deletes this type of BGP peer when the PARTNER + InterconnectAttachment is created, updated, or deleted. + """ + UNDEFINED_MANAGEMENT_TYPE = 0 + MANAGED_BY_ATTACHMENT = 458926411 + MANAGED_BY_USER = 317294067 - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - region_set_policy_request_resource = proto.Field( - proto.MESSAGE, number=276489091, message="RegionSetPolicyRequest", + advertise_mode = proto.Field( + proto.ENUM, number=312134331, optional=True, enum=AdvertiseMode, + ) + advertised_groups = proto.RepeatedField( + proto.ENUM, number=21065526, enum=AdvertisedGroups, + ) + advertised_ip_ranges = proto.RepeatedField( + proto.MESSAGE, number=35449932, message="RouterAdvertisedIpRange", + ) + advertised_route_priority = proto.Field( + proto.UINT32, number=186486332, optional=True, + ) + bfd = proto.Field( + proto.MESSAGE, number=97440, optional=True, message="RouterBgpPeerBfd", + ) + enable = proto.Field(proto.ENUM, number=311764355, optional=True, enum=Enable,) + interface_name = proto.Field(proto.STRING, number=437854673, optional=True,) + ip_address = proto.Field(proto.STRING, number=406272220, optional=True,) + management_type = proto.Field( + proto.ENUM, number=173703606, optional=True, enum=ManagementType, ) - resource = proto.Field(proto.STRING, number=195806222,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + peer_asn = proto.Field(proto.UINT32, number=69573151, optional=True,) + peer_ip_address = proto.Field(proto.STRING, number=207735769, optional=True,) + router_appliance_instance = proto.Field( + proto.STRING, number=468312989, optional=True, + ) + + +class RouterBgpPeerBfd(proto.Message): + r""" + Attributes: + min_receive_interval (int): + The minimum interval, in milliseconds, + between BFD control packets received from the + peer router. The actual value is negotiated + between the two routers and is equal to the + greater of this value and the transmit interval + of the other router. If set, this value must be + between 1000 and 30000. The default is 1000. + min_transmit_interval (int): + The minimum interval, in milliseconds, + between BFD control packets transmitted to the + peer router. The actual value is negotiated + between the two routers and is equal to the + greater of this value and the corresponding + receive interval of the other router. If set, + this value must be between 1000 and 30000. The + default is 1000. + multiplier (int): + The number of consecutive BFD packets that + must be missed before BFD declares that a peer + is unavailable. If set, the value must be a + value between 5 and 16. The default is 5. + session_initialization_mode (google.cloud.compute_v1.types.RouterBgpPeerBfd.SessionInitializationMode): + The BFD session initialization mode for this + BGP peer. If set to ACTIVE, the Cloud Router + will initiate the BFD session for this BGP peer. + If set to PASSIVE, the Cloud Router will wait + for the peer router to initiate the BFD session + for this BGP peer. If set to DISABLED, BFD is + disabled for this BGP peer. The default is + PASSIVE. + """ + + class SessionInitializationMode(proto.Enum): + r"""The BFD session initialization mode for this BGP peer. If set + to ACTIVE, the Cloud Router will initiate the BFD session for + this BGP peer. If set to PASSIVE, the Cloud Router will wait for + the peer router to initiate the BFD session for this BGP peer. + If set to DISABLED, BFD is disabled for this BGP peer. The + default is PASSIVE. + """ + UNDEFINED_SESSION_INITIALIZATION_MODE = 0 + ACTIVE = 314733318 + DISABLED = 516696700 + PASSIVE = 462813959 + min_receive_interval = proto.Field(proto.UINT32, number=186981614, optional=True,) + min_transmit_interval = proto.Field(proto.UINT32, number=523282631, optional=True,) + multiplier = proto.Field(proto.UINT32, number=191331777, optional=True,) + session_initialization_mode = proto.Field( + proto.ENUM, number=105957049, optional=True, enum=SessionInitializationMode, + ) -class SetLabelsRegionDiskRequest(proto.Message): - r"""A request message for RegionDisks.SetLabels. See the method - description for details. +class RouterInterface(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - region (str): - The region for this request. - region_set_labels_request_resource (google.cloud.compute_v1.types.RegionSetLabelsRequest): - The body resource for this request - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - resource (str): - Name or id of the resource for this request. + ip_range (str): + IP address and range of the interface. The IP + range must be in the RFC3927 link-local IP + address space. The value must be a CIDR- + formatted string, for example: 169.254.0.1/30. + NOTE: Do not truncate the address as it + represents the IP address of the interface. + linked_interconnect_attachment (str): + URI of the linked Interconnect attachment. It + must be in the same region as the router. Each + interface can have one linked resource, which + can be a VPN tunnel, an Interconnect attachment, + or a virtual machine instance. + linked_vpn_tunnel (str): + URI of the linked VPN tunnel, which must be + in the same region as the router. Each interface + can have one linked resource, which can be a VPN + tunnel, an Interconnect attachment, or a virtual + machine instance. + management_type (google.cloud.compute_v1.types.RouterInterface.ManagementType): + [Output Only] The resource that configures and manages this + interface. - MANAGED_BY_USER is the default value and can be + managed directly by users. - MANAGED_BY_ATTACHMENT is an + interface that is configured and managed by Cloud + Interconnect, specifically, by an InterconnectAttachment of + type PARTNER. Google automatically creates, updates, and + deletes this type of interface when the PARTNER + InterconnectAttachment is created, updated, or deleted. + name (str): + Name of this interface entry. The name must be 1-63 + characters long, and comply with RFC1035. Specifically, the + name must be 1-63 characters long and match the regular + expression ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the + first character must be a lowercase letter, and all + following characters must be a dash, lowercase letter, or + digit, except the last character, which cannot be a dash. + private_ip_address (str): + The regional private internal IP address that + is used to establish BGP sessions to a VM + instance acting as a third-party Router + Appliance, such as a Next Gen Firewall, a + Virtual Router, or an SD-WAN VM. + redundant_interface (str): + Name of the interface that will be redundant with the + current interface you are creating. The redundantInterface + must belong to the same Cloud Router as the interface here. + To establish the BGP session to a Router Appliance VM, you + must create two BGP peers. The two BGP peers must be + attached to two separate interfaces that are redundant with + each other. The redundant_interface must be 1-63 characters + long, and comply with RFC1035. Specifically, the + redundant_interface must be 1-63 characters long and match + the regular expression ``[a-z]([-a-z0-9]*[a-z0-9])?`` which + means the first character must be a lowercase letter, and + all following characters must be a dash, lowercase letter, + or digit, except the last character, which cannot be a dash. + subnetwork (str): + The URI of the subnetwork resource that this + interface belongs to, which must be in the same + region as the Cloud Router. When you establish a + BGP session to a VM instance using this + interface, the VM instance must belong to the + same subnetwork as the subnetwork specified + here. """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - region_set_labels_request_resource = proto.Field( - proto.MESSAGE, number=259357782, message="RegionSetLabelsRequest", - ) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - resource = proto.Field(proto.STRING, number=195806222,) + class ManagementType(proto.Enum): + r"""[Output Only] The resource that configures and manages this + interface. - MANAGED_BY_USER is the default value and can be managed + directly by users. - MANAGED_BY_ATTACHMENT is an interface that is + configured and managed by Cloud Interconnect, specifically, by an + InterconnectAttachment of type PARTNER. Google automatically + creates, updates, and deletes this type of interface when the + PARTNER InterconnectAttachment is created, updated, or deleted. + """ + UNDEFINED_MANAGEMENT_TYPE = 0 + MANAGED_BY_ATTACHMENT = 458926411 + MANAGED_BY_USER = 317294067 + ip_range = proto.Field(proto.STRING, number=145092645, optional=True,) + linked_interconnect_attachment = proto.Field( + proto.STRING, number=501085518, optional=True, + ) + linked_vpn_tunnel = proto.Field(proto.STRING, number=352296953, optional=True,) + management_type = proto.Field( + proto.ENUM, number=173703606, optional=True, enum=ManagementType, + ) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + private_ip_address = proto.Field(proto.STRING, number=100854040, optional=True,) + redundant_interface = proto.Field(proto.STRING, number=523187303, optional=True,) + subnetwork = proto.Field(proto.STRING, number=307827694, optional=True,) -class TestIamPermissionsRegionDiskRequest(proto.Message): - r"""A request message for RegionDisks.TestIamPermissions. See the - method description for details. +class RouterList(proto.Message): + r"""Contains a list of Router resources. Attributes: - project (str): - Project ID for this request. - region (str): - The name of the region for this request. - resource (str): - Name or id of the resource for this request. - test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): - The body resource for this request + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.Router]): + A list of Router resources. + kind (str): + [Output Only] Type of resource. Always compute#router for + routers. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - resource = proto.Field(proto.STRING, number=195806222,) - test_permissions_request_resource = proto.Field( - proto.MESSAGE, number=439214758, message="TestPermissionsRequest", + @property + def raw_page(self): + return self + + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Router",) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", ) -class DeleteRegionHealthCheckServiceRequest(proto.Message): - r"""A request message for RegionHealthCheckServices.Delete. See - the method description for details. +class RouterNat(proto.Message): + r"""Represents a Nat resource. It enables the VMs within the + specified subnetworks to access Internet without external IP + addresses. It specifies a list of subnetworks (and the ranges + within) that want to use NAT. Customers can also provide the + external IPs that would be used for NAT. GCP would auto-allocate + ephemeral IPs if no external IPs are provided. Attributes: - health_check_service (str): - Name of the HealthCheckService to delete. The - name must be 1-63 characters long, and comply - with RFC1035. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + drain_nat_ips (Sequence[str]): + A list of URLs of the IP resources to be + drained. These IPs must be valid static external + IPs that have been assigned to the NAT. These + IPs should be used for updating/patching a NAT + only. + enable_endpoint_independent_mapping (bool): + + icmp_idle_timeout_sec (int): + Timeout (in seconds) for ICMP connections. + Defaults to 30s if not set. + log_config (google.cloud.compute_v1.types.RouterNatLogConfig): + Configure logging on this NAT. + min_ports_per_vm (int): + Minimum number of ports allocated to a VM + from this NAT config. If not set, a default + number of ports is allocated to a VM. This is + rounded up to the nearest power of 2. For + example, if the value of this field is 50, at + least 64 ports are allocated to a VM. + name (str): + Unique name of this Nat service. The name + must be 1-63 characters long and comply with + RFC1035. + nat_ip_allocate_option (google.cloud.compute_v1.types.RouterNat.NatIpAllocateOption): + Specify the NatIpAllocateOption, which can take one of the + following values: - MANUAL_ONLY: Uses only Nat IP addresses + provided by customers. When there are not enough specified + Nat IPs, the Nat service fails for new VMs. - AUTO_ONLY: Nat + IPs are allocated by Google Cloud Platform; customers can't + specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip + should be empty. + nat_ips (Sequence[str]): + A list of URLs of the IP resources used for + this Nat service. These IP addresses must be + valid static external IP addresses assigned to + the project. + rules (Sequence[google.cloud.compute_v1.types.RouterNatRule]): + A list of rules associated with this NAT. + source_subnetwork_ip_ranges_to_nat (google.cloud.compute_v1.types.RouterNat.SourceSubnetworkIpRangesToNat): + Specify the Nat option, which can take one of the following + values: - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP + ranges in every Subnetwork are allowed to Nat. - + ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP + ranges in every Subnetwork are allowed to Nat. - + LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to + Nat (specified in the field subnetwork below) The default is + SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED. Note that if + this field contains ALL_SUBNETWORKS_ALL_IP_RANGES or + ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES, then there should not + be any other Router.Nat section in any Router for this + network in this region. + subnetworks (Sequence[google.cloud.compute_v1.types.RouterNatSubnetworkToNat]): + A list of Subnetwork resources whose traffic should be + translated by NAT Gateway. It is used only when + LIST_OF_SUBNETWORKS is selected for the + SubnetworkIpRangeToNatOption above. + tcp_established_idle_timeout_sec (int): + Timeout (in seconds) for TCP established + connections. Defaults to 1200s if not set. + tcp_time_wait_timeout_sec (int): + Timeout (in seconds) for TCP connections that are in + TIME_WAIT state. Defaults to 120s if not set. + tcp_transitory_idle_timeout_sec (int): + Timeout (in seconds) for TCP transitory + connections. Defaults to 30s if not set. + udp_idle_timeout_sec (int): + Timeout (in seconds) for UDP connections. + Defaults to 30s if not set. """ - health_check_service = proto.Field(proto.STRING, number=408374747,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + class NatIpAllocateOption(proto.Enum): + r"""Specify the NatIpAllocateOption, which can take one of the following + values: - MANUAL_ONLY: Uses only Nat IP addresses provided by + customers. When there are not enough specified Nat IPs, the Nat + service fails for new VMs. - AUTO_ONLY: Nat IPs are allocated by + Google Cloud Platform; customers can't specify any Nat IPs. When + choosing AUTO_ONLY, then nat_ip should be empty. + """ + UNDEFINED_NAT_IP_ALLOCATE_OPTION = 0 + AUTO_ONLY = 182333500 + MANUAL_ONLY = 261251205 + class SourceSubnetworkIpRangesToNat(proto.Enum): + r"""Specify the Nat option, which can take one of the following values: + - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every + Subnetwork are allowed to Nat. - + ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP ranges + in every Subnetwork are allowed to Nat. - LIST_OF_SUBNETWORKS: A + list of Subnetworks are allowed to Nat (specified in the field + subnetwork below) The default is + SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED. Note that if this + field contains ALL_SUBNETWORKS_ALL_IP_RANGES or + ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES, then there should not be any + other Router.Nat section in any Router for this network in this + region. + """ + UNDEFINED_SOURCE_SUBNETWORK_IP_RANGES_TO_NAT = 0 + ALL_SUBNETWORKS_ALL_IP_RANGES = 179964376 + ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES = 185573819 + LIST_OF_SUBNETWORKS = 517542270 -class GetRegionHealthCheckServiceRequest(proto.Message): - r"""A request message for RegionHealthCheckServices.Get. See the - method description for details. + drain_nat_ips = proto.RepeatedField(proto.STRING, number=504078535,) + enable_endpoint_independent_mapping = proto.Field( + proto.BOOL, number=259441819, optional=True, + ) + icmp_idle_timeout_sec = proto.Field(proto.INT32, number=3647562, optional=True,) + log_config = proto.Field( + proto.MESSAGE, number=351299741, optional=True, message="RouterNatLogConfig", + ) + min_ports_per_vm = proto.Field(proto.INT32, number=186193587, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + nat_ip_allocate_option = proto.Field( + proto.ENUM, number=429726845, optional=True, enum=NatIpAllocateOption, + ) + nat_ips = proto.RepeatedField(proto.STRING, number=117635086,) + rules = proto.RepeatedField( + proto.MESSAGE, number=108873975, message="RouterNatRule", + ) + source_subnetwork_ip_ranges_to_nat = proto.Field( + proto.ENUM, number=252213211, optional=True, enum=SourceSubnetworkIpRangesToNat, + ) + subnetworks = proto.RepeatedField( + proto.MESSAGE, number=415853125, message="RouterNatSubnetworkToNat", + ) + tcp_established_idle_timeout_sec = proto.Field( + proto.INT32, number=223098349, optional=True, + ) + tcp_time_wait_timeout_sec = proto.Field( + proto.INT32, number=513596925, optional=True, + ) + tcp_transitory_idle_timeout_sec = proto.Field( + proto.INT32, number=205028774, optional=True, + ) + udp_idle_timeout_sec = proto.Field(proto.INT32, number=64919878, optional=True,) + +class RouterNatLogConfig(proto.Message): + r"""Configuration of logging on a NAT. Attributes: - health_check_service (str): - Name of the HealthCheckService to update. The - name must be 1-63 characters long, and comply - with RFC1035. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. + enable (bool): + Indicates whether or not to export logs. This + is false by default. + filter (google.cloud.compute_v1.types.RouterNatLogConfig.Filter): + Specify the desired filtering of logs on this NAT. If + unspecified, logs are exported for all connections handled + by this NAT. This option can take one of the following + values: - ERRORS_ONLY: Export logs only for connection + failures. - TRANSLATIONS_ONLY: Export logs only for + successful connections. - ALL: Export logs for all + connections, successful and unsuccessful. """ - health_check_service = proto.Field(proto.STRING, number=408374747,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) + class Filter(proto.Enum): + r"""Specify the desired filtering of logs on this NAT. If unspecified, + logs are exported for all connections handled by this NAT. This + option can take one of the following values: - ERRORS_ONLY: Export + logs only for connection failures. - TRANSLATIONS_ONLY: Export logs + only for successful connections. - ALL: Export logs for all + connections, successful and unsuccessful. + """ + UNDEFINED_FILTER = 0 + ALL = 64897 + ERRORS_ONLY = 307484672 + TRANSLATIONS_ONLY = 357212649 + enable = proto.Field(proto.BOOL, number=311764355, optional=True,) + filter = proto.Field(proto.ENUM, number=336120696, optional=True, enum=Filter,) -class InsertRegionHealthCheckServiceRequest(proto.Message): - r"""A request message for RegionHealthCheckServices.Insert. See - the method description for details. +class RouterNatRule(proto.Message): + r""" Attributes: - health_check_service_resource (google.cloud.compute_v1.types.HealthCheckService): - The body resource for this request - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - """ - - health_check_service_resource = proto.Field( - proto.MESSAGE, number=477367794, message="HealthCheckService", + action (google.cloud.compute_v1.types.RouterNatRuleAction): + The action to be enforced for traffic that + matches this rule. + description (str): + An optional description of this rule. + match (str): + CEL expression that specifies the match condition that + egress traffic from a VM is evaluated against. If it + evaluates to true, the corresponding ``action`` is enforced. + The following examples are valid match expressions for + public NAT: "inIpRange(destination.ip, '1.1.0.0/16') \|\| + inIpRange(destination.ip, '2.2.0.0/16')" "destination.ip == + '1.1.0.1' \|\| destination.ip == '8.8.8.8'" The following + example is a valid match expression for private NAT: + "nexthop.hub == '/projects/my-project/global/hub/hub-1'". + rule_number (int): + An integer uniquely identifying a rule in the + list. The rule number must be a positive value + between 0 and 65000, and must be unique among + rules within a NAT. + """ + + action = proto.Field( + proto.MESSAGE, number=187661878, optional=True, message="RouterNatRuleAction", ) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - + description = proto.Field(proto.STRING, number=422937596, optional=True,) + match = proto.Field(proto.STRING, number=103668165, optional=True,) + rule_number = proto.Field(proto.UINT32, number=535211500, optional=True,) -class ListRegionHealthCheckServicesRequest(proto.Message): - r"""A request message for RegionHealthCheckServices.List. See the - method description for details. +class RouterNatRuleAction(proto.Message): + r""" Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + source_nat_active_ips (Sequence[str]): + A list of URLs of the IP resources used for + this NAT rule. These IP addresses must be valid + static external IP addresses assigned to the + project. This field is used for public NAT. + source_nat_drain_ips (Sequence[str]): + A list of URLs of the IP resources to be + drained. These IPs must be valid static external + IPs that have been assigned to the NAT. These + IPs should be used for updating/patching a NAT + rule only. This field is used for public NAT. + """ - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. + source_nat_active_ips = proto.RepeatedField(proto.STRING, number=210378229,) + source_nat_drain_ips = proto.RepeatedField(proto.STRING, number=340812451,) - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. +class RouterNatSubnetworkToNat(proto.Message): + r"""Defines the IP ranges that want to use NAT for a subnetwork. + Attributes: + name (str): + URL for the subnetwork resource that will use + NAT. + secondary_ip_range_names (Sequence[str]): + A list of the secondary ranges of the Subnetwork that are + allowed to use NAT. This can be populated only if + "LIST_OF_SECONDARY_IP_RANGES" is one of the values in + source_ip_ranges_to_nat. + source_ip_ranges_to_nat (Sequence[google.cloud.compute_v1.types.RouterNatSubnetworkToNat.SourceIpRangesToNat]): + Specify the options for NAT ranges in the Subnetwork. All + options of a single value are valid except + NAT_IP_RANGE_OPTION_UNSPECIFIED. The only valid option with + multiple values is: ["PRIMARY_IP_RANGE", + "LIST_OF_SECONDARY_IP_RANGES"] Default: [ALL_IP_RANGES] """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + class SourceIpRangesToNat(proto.Enum): + r"""""" + UNDEFINED_SOURCE_IP_RANGES_TO_NAT = 0 + ALL_IP_RANGES = 35608496 + LIST_OF_SECONDARY_IP_RANGES = 192289308 + PRIMARY_IP_RANGE = 297109954 + name = proto.Field(proto.STRING, number=3373707, optional=True,) + secondary_ip_range_names = proto.RepeatedField(proto.STRING, number=264315097,) + source_ip_ranges_to_nat = proto.RepeatedField( + proto.ENUM, number=388310386, enum=SourceIpRangesToNat, + ) -class PatchRegionHealthCheckServiceRequest(proto.Message): - r"""A request message for RegionHealthCheckServices.Patch. See - the method description for details. +class RouterStatus(proto.Message): + r""" Attributes: - health_check_service (str): - Name of the HealthCheckService to update. The - name must be 1-63 characters long, and comply - with RFC1035. - health_check_service_resource (google.cloud.compute_v1.types.HealthCheckService): - The body resource for this request - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + best_routes (Sequence[google.cloud.compute_v1.types.Route]): + Best routes for this router's network. + best_routes_for_router (Sequence[google.cloud.compute_v1.types.Route]): + Best routes learned by this router. + bgp_peer_status (Sequence[google.cloud.compute_v1.types.RouterStatusBgpPeerStatus]): + + nat_status (Sequence[google.cloud.compute_v1.types.RouterStatusNatStatus]): + + network (str): + URI of the network to which this router + belongs. """ - health_check_service = proto.Field(proto.STRING, number=408374747,) - health_check_service_resource = proto.Field( - proto.MESSAGE, number=477367794, message="HealthCheckService", + best_routes = proto.RepeatedField(proto.MESSAGE, number=395826693, message="Route",) + best_routes_for_router = proto.RepeatedField( + proto.MESSAGE, number=119389689, message="Route", ) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - + bgp_peer_status = proto.RepeatedField( + proto.MESSAGE, number=218459131, message="RouterStatusBgpPeerStatus", + ) + nat_status = proto.RepeatedField( + proto.MESSAGE, number=63098064, message="RouterStatusNatStatus", + ) + network = proto.Field(proto.STRING, number=232872494, optional=True,) -class DeleteRegionHealthCheckRequest(proto.Message): - r"""A request message for RegionHealthChecks.Delete. See the - method description for details. +class RouterStatusBgpPeerStatus(proto.Message): + r""" Attributes: - health_check (str): - Name of the HealthCheck resource to delete. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + advertised_routes (Sequence[google.cloud.compute_v1.types.Route]): + Routes that were advertised to the remote BGP + peer + ip_address (str): + IP address of the local BGP interface. + linked_vpn_tunnel (str): + URL of the VPN tunnel that this BGP peer + controls. + name (str): + Name of this BGP peer. Unique within the + Routers resource. + num_learned_routes (int): + Number of routes learned from the remote BGP + Peer. + peer_ip_address (str): + IP address of the remote BGP interface. + router_appliance_instance (str): + [Output only] URI of the VM instance that is used as + third-party router appliances such as Next Gen Firewalls, + Virtual Routers, or Router Appliances. The VM instance is + the peer side of the BGP session. + state (str): + BGP state as specified in RFC1771. + status (google.cloud.compute_v1.types.RouterStatusBgpPeerStatus.Status): + Status of the BGP peer: {UP, DOWN} + uptime (str): + Time this session has been up. Format: 14 + years, 51 weeks, 6 days, 23 hours, 59 minutes, + 59 seconds + uptime_seconds (str): + Time this session has been up, in seconds. + Format: 145 """ - health_check = proto.Field(proto.STRING, number=308876645,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + class Status(proto.Enum): + r"""Status of the BGP peer: {UP, DOWN}""" + UNDEFINED_STATUS = 0 + DOWN = 2104482 + UNKNOWN = 433141802 + UP = 2715 + advertised_routes = proto.RepeatedField( + proto.MESSAGE, number=333393068, message="Route", + ) + ip_address = proto.Field(proto.STRING, number=406272220, optional=True,) + linked_vpn_tunnel = proto.Field(proto.STRING, number=352296953, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + num_learned_routes = proto.Field(proto.UINT32, number=135457535, optional=True,) + peer_ip_address = proto.Field(proto.STRING, number=207735769, optional=True,) + router_appliance_instance = proto.Field( + proto.STRING, number=468312989, optional=True, + ) + state = proto.Field(proto.STRING, number=109757585, optional=True,) + status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) + uptime = proto.Field(proto.STRING, number=235379688, optional=True,) + uptime_seconds = proto.Field(proto.STRING, number=104736040, optional=True,) -class GetRegionHealthCheckRequest(proto.Message): - r"""A request message for RegionHealthChecks.Get. See the method - description for details. +class RouterStatusNatStatus(proto.Message): + r"""Status of a NAT contained in this router. Attributes: - health_check (str): - Name of the HealthCheck resource to return. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. + auto_allocated_nat_ips (Sequence[str]): + A list of IPs auto-allocated for NAT. Example: ["1.1.1.1", + "129.2.16.89"] + drain_auto_allocated_nat_ips (Sequence[str]): + A list of IPs auto-allocated for NAT that are in drain mode. + Example: ["1.1.1.1", "179.12.26.133"]. + drain_user_allocated_nat_ips (Sequence[str]): + A list of IPs user-allocated for NAT that are in drain mode. + Example: ["1.1.1.1", "179.12.26.133"]. + min_extra_nat_ips_needed (int): + The number of extra IPs to allocate. This will be greater + than 0 only if user-specified IPs are NOT enough to allow + all configured VMs to use NAT. This value is meaningful only + when auto-allocation of NAT IPs is *not* used. + name (str): + Unique name of this NAT. + num_vm_endpoints_with_nat_mappings (int): + Number of VM endpoints (i.e., Nics) that can + use NAT. + rule_status (Sequence[google.cloud.compute_v1.types.RouterStatusNatStatusNatRuleStatus]): + Status of rules in this NAT. + user_allocated_nat_ip_resources (Sequence[str]): + A list of fully qualified URLs of reserved IP + address resources. + user_allocated_nat_ips (Sequence[str]): + A list of IPs user-allocated for NAT. They + will be raw IP strings like "179.12.26.133". """ - health_check = proto.Field(proto.STRING, number=308876645,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - + auto_allocated_nat_ips = proto.RepeatedField(proto.STRING, number=510794246,) + drain_auto_allocated_nat_ips = proto.RepeatedField(proto.STRING, number=309184557,) + drain_user_allocated_nat_ips = proto.RepeatedField(proto.STRING, number=305268553,) + min_extra_nat_ips_needed = proto.Field( + proto.INT32, number=365786338, optional=True, + ) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + num_vm_endpoints_with_nat_mappings = proto.Field( + proto.INT32, number=512367468, optional=True, + ) + rule_status = proto.RepeatedField( + proto.MESSAGE, number=140223125, message="RouterStatusNatStatusNatRuleStatus", + ) + user_allocated_nat_ip_resources = proto.RepeatedField( + proto.STRING, number=212776151, + ) + user_allocated_nat_ips = proto.RepeatedField(proto.STRING, number=506878242,) -class InsertRegionHealthCheckRequest(proto.Message): - r"""A request message for RegionHealthChecks.Insert. See the - method description for details. +class RouterStatusNatStatusNatRuleStatus(proto.Message): + r"""Status of a NAT Rule contained in this NAT. Attributes: - health_check_resource (google.cloud.compute_v1.types.HealthCheck): - The body resource for this request - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + active_nat_ips (Sequence[str]): + A list of active IPs for NAT. Example: ["1.1.1.1", + "179.12.26.133"]. + drain_nat_ips (Sequence[str]): + A list of IPs for NAT that are in drain mode. Example: + ["1.1.1.1", "179.12.26.133"]. + min_extra_ips_needed (int): + The number of extra IPs to allocate. This + will be greater than 0 only if the existing IPs + in this NAT Rule are NOT enough to allow all + configured VMs to use NAT. + num_vm_endpoints_with_nat_mappings (int): + Number of VM endpoints (i.e., NICs) that have + NAT Mappings from this NAT Rule. + rule_number (int): + Rule number of the rule. """ - health_check_resource = proto.Field( - proto.MESSAGE, number=201925032, message="HealthCheck", + active_nat_ips = proto.RepeatedField(proto.STRING, number=208517077,) + drain_nat_ips = proto.RepeatedField(proto.STRING, number=504078535,) + min_extra_ips_needed = proto.Field(proto.INT32, number=353002756, optional=True,) + num_vm_endpoints_with_nat_mappings = proto.Field( + proto.INT32, number=512367468, optional=True, ) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + rule_number = proto.Field(proto.INT32, number=535211500, optional=True,) -class ListRegionHealthChecksRequest(proto.Message): - r"""A request message for RegionHealthChecks.List. See the method - description for details. - +class RouterStatusResponse(proto.Message): + r""" Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. + kind (str): + Type of resource. + result (google.cloud.compute_v1.types.RouterStatus): - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + result = proto.Field( + proto.MESSAGE, number=139315229, optional=True, message="RouterStatus", + ) -class PatchRegionHealthCheckRequest(proto.Message): - r"""A request message for RegionHealthChecks.Patch. See the - method description for details. +class RoutersPreviewResponse(proto.Message): + r""" Attributes: - health_check (str): - Name of the HealthCheck resource to patch. - health_check_resource (google.cloud.compute_v1.types.HealthCheck): - The body resource for this request - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + resource (google.cloud.compute_v1.types.Router): + Preview of given router. """ - health_check = proto.Field(proto.STRING, number=308876645,) - health_check_resource = proto.Field( - proto.MESSAGE, number=201925032, message="HealthCheck", + resource = proto.Field( + proto.MESSAGE, number=195806222, optional=True, message="Router", ) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - -class UpdateRegionHealthCheckRequest(proto.Message): - r"""A request message for RegionHealthChecks.Update. See the - method description for details. +class RoutersScopedList(proto.Message): + r""" Attributes: - health_check (str): - Name of the HealthCheck resource to update. - health_check_resource (google.cloud.compute_v1.types.HealthCheck): - The body resource for this request - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + routers (Sequence[google.cloud.compute_v1.types.Router]): + A list of routers contained in this scope. + warning (google.cloud.compute_v1.types.Warning): + Informational warning which replaces the list + of routers when the list is empty. """ - health_check = proto.Field(proto.STRING, number=308876645,) - health_check_resource = proto.Field( - proto.MESSAGE, number=201925032, message="HealthCheck", + routers = proto.RepeatedField(proto.MESSAGE, number=311906890, message="Router",) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", ) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class AbandonInstancesRegionInstanceGroupManagerRequest(proto.Message): - r"""A request message for - RegionInstanceGroupManagers.AbandonInstances. See the method - description for details. - +class Rule(proto.Message): + r"""This is deprecated and has no effect. Do not use. Attributes: - instance_group_manager (str): - Name of the managed instance group. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - region_instance_group_managers_abandon_instances_request_resource (google.cloud.compute_v1.types.RegionInstanceGroupManagersAbandonInstancesRequest): - The body resource for this request - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + action (google.cloud.compute_v1.types.Rule.Action): + This is deprecated and has no effect. Do not + use. + conditions (Sequence[google.cloud.compute_v1.types.Condition]): + This is deprecated and has no effect. Do not + use. + description (str): + This is deprecated and has no effect. Do not + use. + ins (Sequence[str]): + This is deprecated and has no effect. Do not + use. + log_configs (Sequence[google.cloud.compute_v1.types.LogConfig]): + This is deprecated and has no effect. Do not + use. + not_ins (Sequence[str]): + This is deprecated and has no effect. Do not + use. + permissions (Sequence[str]): + This is deprecated and has no effect. Do not + use. """ - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - region_instance_group_managers_abandon_instances_request_resource = proto.Field( - proto.MESSAGE, - number=488499491, - message="RegionInstanceGroupManagersAbandonInstancesRequest", - ) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + class Action(proto.Enum): + r"""This is deprecated and has no effect. Do not use.""" + UNDEFINED_ACTION = 0 + ALLOW = 62368553 + ALLOW_WITH_LOG = 76034177 + DENY = 2094604 + DENY_WITH_LOG = 351433982 + LOG = 75556 + NO_ACTION = 260643444 + action = proto.Field(proto.ENUM, number=187661878, optional=True, enum=Action,) + conditions = proto.RepeatedField( + proto.MESSAGE, number=142882488, message="Condition", + ) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + ins = proto.RepeatedField(proto.STRING, number=104430,) + log_configs = proto.RepeatedField( + proto.MESSAGE, number=152873846, message="LogConfig", + ) + not_ins = proto.RepeatedField(proto.STRING, number=518443138,) + permissions = proto.RepeatedField(proto.STRING, number=59962500,) -class ApplyUpdatesToInstancesRegionInstanceGroupManagerRequest(proto.Message): - r"""A request message for - RegionInstanceGroupManagers.ApplyUpdatesToInstances. See the - method description for details. +class SSLHealthCheck(proto.Message): + r""" Attributes: - instance_group_manager (str): - The name of the managed instance group, - should conform to RFC1035. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request, - should conform to RFC1035. - region_instance_group_managers_apply_updates_request_resource (google.cloud.compute_v1.types.RegionInstanceGroupManagersApplyUpdatesRequest): - The body resource for this request + port (int): + The TCP port number for the health check + request. The default value is 443. Valid values + are 1 through 65535. + port_name (str): + Port name as defined in InstanceGroup#NamedPort#name. If + both port and port_name are defined, port takes precedence. + port_specification (google.cloud.compute_v1.types.SSLHealthCheck.PortSpecification): + Specifies how port is selected for health checking, can be + one of following values: USE_FIXED_PORT: The port number in + port is used for health checking. USE_NAMED_PORT: The + portName is used for health checking. USE_SERVING_PORT: For + NetworkEndpointGroup, the port specified for each network + endpoint is used for health checking. For other backends, + the port or named port specified in the Backend Service is + used for health checking. If not specified, SSL health check + follows behavior specified in port and portName fields. + proxy_header (google.cloud.compute_v1.types.SSLHealthCheck.ProxyHeader): + Specifies the type of proxy header to append before sending + data to the backend, either NONE or PROXY_V1. The default is + NONE. + request (str): + The application data to send once the SSL + connection has been established (default value + is empty). If both request and response are + empty, the connection establishment alone will + indicate health. The request data can only be + ASCII. + response (str): + The bytes to match against the beginning of + the response data. If left empty (the default + value), any response will indicate health. The + response data can only be ASCII. """ - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - region_instance_group_managers_apply_updates_request_resource = proto.Field( - proto.MESSAGE, - number=76248318, - message="RegionInstanceGroupManagersApplyUpdatesRequest", - ) + class PortSpecification(proto.Enum): + r"""Specifies how port is selected for health checking, can be one of + following values: USE_FIXED_PORT: The port number in port is used + for health checking. USE_NAMED_PORT: The portName is used for health + checking. USE_SERVING_PORT: For NetworkEndpointGroup, the port + specified for each network endpoint is used for health checking. For + other backends, the port or named port specified in the Backend + Service is used for health checking. If not specified, SSL health + check follows behavior specified in port and portName fields. + """ + UNDEFINED_PORT_SPECIFICATION = 0 + USE_FIXED_PORT = 190235748 + USE_NAMED_PORT = 349300671 + USE_SERVING_PORT = 362637516 + class ProxyHeader(proto.Enum): + r"""Specifies the type of proxy header to append before sending data to + the backend, either NONE or PROXY_V1. The default is NONE. + """ + UNDEFINED_PROXY_HEADER = 0 + NONE = 2402104 + PROXY_V1 = 334352940 -class CreateInstancesRegionInstanceGroupManagerRequest(proto.Message): - r"""A request message for - RegionInstanceGroupManagers.CreateInstances. See the method - description for details. + port = proto.Field(proto.INT32, number=3446913, optional=True,) + port_name = proto.Field(proto.STRING, number=41534345, optional=True,) + port_specification = proto.Field( + proto.ENUM, number=51590597, optional=True, enum=PortSpecification, + ) + proxy_header = proto.Field( + proto.ENUM, number=160374142, optional=True, enum=ProxyHeader, + ) + request = proto.Field(proto.STRING, number=21951119, optional=True,) + response = proto.Field(proto.STRING, number=196547649, optional=True,) + +class ScalingScheduleStatus(proto.Message): + r""" Attributes: - instance_group_manager (str): - The name of the managed instance group. It - should conform to RFC1035. - project (str): - Project ID for this request. - region (str): - The name of the region where the managed - instance group is located. It should conform to - RFC1035. - region_instance_group_managers_create_instances_request_resource (google.cloud.compute_v1.types.RegionInstanceGroupManagersCreateInstancesRequest): - The body resource for this request - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + last_start_time (str): + [Output Only] The last time the scaling schedule became + active. Note: this is a timestamp when a schedule actually + became active, not when it was planned to do so. The + timestamp is in RFC3339 text format. + next_start_time (str): + [Output Only] The next time the scaling schedule is to + become active. Note: this is a timestamp when a schedule is + planned to run, but the actual time might be slightly + different. The timestamp is in RFC3339 text format. + state (google.cloud.compute_v1.types.ScalingScheduleStatus.State): + [Output Only] The current state of a scaling schedule. """ - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - region_instance_group_managers_create_instances_request_resource = proto.Field( - proto.MESSAGE, - number=359014280, - message="RegionInstanceGroupManagersCreateInstancesRequest", - ) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + class State(proto.Enum): + r"""[Output Only] The current state of a scaling schedule.""" + UNDEFINED_STATE = 0 + ACTIVE = 314733318 + DISABLED = 516696700 + OBSOLETE = 66532761 + READY = 77848963 + last_start_time = proto.Field(proto.STRING, number=34545107, optional=True,) + next_start_time = proto.Field(proto.STRING, number=97270102, optional=True,) + state = proto.Field(proto.ENUM, number=109757585, optional=True, enum=State,) -class DeleteRegionInstanceGroupManagerRequest(proto.Message): - r"""A request message for RegionInstanceGroupManagers.Delete. See - the method description for details. +class Scheduling(proto.Message): + r"""Sets the scheduling options for an Instance. NextID: 21 Attributes: - instance_group_manager (str): - Name of the managed instance group to delete. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + automatic_restart (bool): + Specifies whether the instance should be + automatically restarted if it is terminated by + Compute Engine (not terminated by a user). You + can only set the automatic restart option for + standard instances. Preemptible instances cannot + be automatically restarted. By default, this is + set to true so an instance is automatically + restarted if it is terminated by Compute Engine. + location_hint (str): + An opaque location hint used to place the + instance close to other resources. This field is + for use by internal tools that use the public + API. + min_node_cpus (int): + The minimum number of virtual CPUs this + instance will consume when running on a sole- + tenant node. + node_affinities (Sequence[google.cloud.compute_v1.types.SchedulingNodeAffinity]): + A set of node affinity and anti-affinity + configurations. Refer to Configuring node + affinity for more information. Overrides + reservationAffinity. + on_host_maintenance (google.cloud.compute_v1.types.Scheduling.OnHostMaintenance): + Defines the maintenance behavior for this + instance. For standard instances, the default + behavior is MIGRATE. For preemptible instances, + the default and only possible behavior is + TERMINATE. For more information, see Setting + Instance Scheduling Options. + preemptible (bool): + Defines whether the instance is preemptible. This can only + be set during instance creation or while the instance is + stopped and therefore, in a ``TERMINATED`` state. See + Instance Life Cycle for more information on the possible + instance states. """ - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + class OnHostMaintenance(proto.Enum): + r"""Defines the maintenance behavior for this instance. For + standard instances, the default behavior is MIGRATE. For + preemptible instances, the default and only possible behavior is + TERMINATE. For more information, see Setting Instance Scheduling + Options. + """ + UNDEFINED_ON_HOST_MAINTENANCE = 0 + MIGRATE = 165699979 + TERMINATE = 527617601 + + automatic_restart = proto.Field(proto.BOOL, number=350821371, optional=True,) + location_hint = proto.Field(proto.STRING, number=350519505, optional=True,) + min_node_cpus = proto.Field(proto.INT32, number=317231675, optional=True,) + node_affinities = proto.RepeatedField( + proto.MESSAGE, number=461799971, message="SchedulingNodeAffinity", + ) + on_host_maintenance = proto.Field( + proto.ENUM, number=64616796, optional=True, enum=OnHostMaintenance, + ) + preemptible = proto.Field(proto.BOOL, number=324203169, optional=True,) -class DeleteInstancesRegionInstanceGroupManagerRequest(proto.Message): - r"""A request message for - RegionInstanceGroupManagers.DeleteInstances. See the method - description for details. +class SchedulingNodeAffinity(proto.Message): + r"""Node Affinity: the configuration of desired nodes onto which + this Instance could be scheduled. Attributes: - instance_group_manager (str): - Name of the managed instance group. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - region_instance_group_managers_delete_instances_request_resource (google.cloud.compute_v1.types.RegionInstanceGroupManagersDeleteInstancesRequest): - The body resource for this request - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + key (str): + Corresponds to the label key of Node + resource. + operator (google.cloud.compute_v1.types.SchedulingNodeAffinity.Operator): + Defines the operation of node selection. Valid operators are + IN for affinity and NOT_IN for anti-affinity. + values (Sequence[str]): + Corresponds to the label values of Node + resource. """ - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - region_instance_group_managers_delete_instances_request_resource = proto.Field( - proto.MESSAGE, - number=500876665, - message="RegionInstanceGroupManagersDeleteInstancesRequest", - ) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + class Operator(proto.Enum): + r"""Defines the operation of node selection. Valid operators are IN for + affinity and NOT_IN for anti-affinity. + """ + UNDEFINED_OPERATOR = 0 + IN = 2341 + NOT_IN = 161144369 + OPERATOR_UNSPECIFIED = 128892924 + key = proto.Field(proto.STRING, number=106079, optional=True,) + operator = proto.Field(proto.ENUM, number=36317348, optional=True, enum=Operator,) + values = proto.RepeatedField(proto.STRING, number=249928994,) -class DeletePerInstanceConfigsRegionInstanceGroupManagerRequest(proto.Message): - r"""A request message for - RegionInstanceGroupManagers.DeletePerInstanceConfigs. See the - method description for details. +class ScratchDisks(proto.Message): + r""" Attributes: - instance_group_manager (str): - The name of the managed instance group. It - should conform to RFC1035. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request, - should conform to RFC1035. - region_instance_group_manager_delete_instance_config_req_resource (google.cloud.compute_v1.types.RegionInstanceGroupManagerDeleteInstanceConfigReq): - The body resource for this request + disk_gb (int): + Size of the scratch disk, defined in GB. """ - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - region_instance_group_manager_delete_instance_config_req_resource = proto.Field( - proto.MESSAGE, - number=740741, - message="RegionInstanceGroupManagerDeleteInstanceConfigReq", - ) - + disk_gb = proto.Field(proto.INT32, number=60990141, optional=True,) -class GetRegionInstanceGroupManagerRequest(proto.Message): - r"""A request message for RegionInstanceGroupManagers.Get. See - the method description for details. +class Screenshot(proto.Message): + r"""An instance's screenshot. Attributes: - instance_group_manager (str): - Name of the managed instance group to return. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. + contents (str): + [Output Only] The Base64-encoded screenshot data. + kind (str): + [Output Only] Type of the resource. Always + compute#screenshot for the screenshots. """ - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - + contents = proto.Field(proto.STRING, number=506419994, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) -class InsertRegionInstanceGroupManagerRequest(proto.Message): - r"""A request message for RegionInstanceGroupManagers.Insert. See - the method description for details. +class SecurityPoliciesListPreconfiguredExpressionSetsResponse(proto.Message): + r""" Attributes: - instance_group_manager_resource (google.cloud.compute_v1.types.InstanceGroupManager): - The body resource for this request - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + preconfigured_expression_sets (google.cloud.compute_v1.types.SecurityPoliciesWafConfig): + """ - instance_group_manager_resource = proto.Field( - proto.MESSAGE, number=261063946, message="InstanceGroupManager", + preconfigured_expression_sets = proto.Field( + proto.MESSAGE, + number=536200826, + optional=True, + message="SecurityPoliciesWafConfig", ) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class ListRegionInstanceGroupManagersRequest(proto.Message): - r"""A request message for RegionInstanceGroupManagers.List. See - the method description for details. - +class SecurityPoliciesWafConfig(proto.Message): + r""" Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. + waf_rules (google.cloud.compute_v1.types.PreconfiguredWafSet): - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + waf_rules = proto.Field( + proto.MESSAGE, number=74899924, optional=True, message="PreconfiguredWafSet", + ) - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. +class SecurityPolicy(proto.Message): + r"""Represents a Google Cloud Armor security policy resource. + Only external backend services that use load balancers can + reference a security policy. For more information, see Google + Cloud Armor security policy overview. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. - """ + Attributes: + adaptive_protection_config (google.cloud.compute_v1.types.SecurityPolicyAdaptiveProtectionConfig): - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + advanced_options_config (google.cloud.compute_v1.types.SecurityPolicyAdvancedOptionsConfig): + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + fingerprint (str): + Specifies a fingerprint for this resource, + which is essentially a hash of the metadata's + contents and used for optimistic locking. The + fingerprint is initially generated by Compute + Engine and changes after every request to modify + or update metadata. You must always provide an + up-to-date fingerprint hash in order to update + or change metadata, otherwise the request will + fail with error 412 conditionNotMet. To see the + latest fingerprint, make get() request to the + security policy. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + kind (str): + [Output only] Type of the resource. Always + compute#securityPolicyfor security policies + name (str): + Name of the resource. Provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. + rules (Sequence[google.cloud.compute_v1.types.SecurityPolicyRule]): + A list of rules that belong to this policy. There must + always be a default rule (rule with priority 2147483647 and + match "*"). If no rules are provided when creating a + security policy, a default rule with action "allow" will be + added. + self_link (str): + [Output Only] Server-defined URL for the resource. + """ -class ListErrorsRegionInstanceGroupManagersRequest(proto.Message): - r"""A request message for RegionInstanceGroupManagers.ListErrors. - See the method description for details. + adaptive_protection_config = proto.Field( + proto.MESSAGE, + number=150240735, + optional=True, + message="SecurityPolicyAdaptiveProtectionConfig", + ) + advanced_options_config = proto.Field( + proto.MESSAGE, + number=449276352, + optional=True, + message="SecurityPolicyAdvancedOptionsConfig", + ) + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + rules = proto.RepeatedField( + proto.MESSAGE, number=108873975, message="SecurityPolicyRule", + ) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) - Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. +class SecurityPolicyAdaptiveProtectionConfig(proto.Message): + r"""Configuration options for Cloud Armor Adaptive Protection + (CAAP). - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + Attributes: + layer7_ddos_defense_config (google.cloud.compute_v1.types.SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig): + If set to true, enables Cloud Armor Machine + Learning. + """ - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - instance_group_manager (str): - The name of the managed instance group. It must be a string - that meets the requirements in RFC1035, or an unsigned long - integer: must match regexp pattern: - (?:`a-z `__?)|[1-9][0-9]{0,19}. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. + layer7_ddos_defense_config = proto.Field( + proto.MESSAGE, + number=437316771, + optional=True, + message="SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig", + ) - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. This - should conform to RFC1035. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. +class SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig(proto.Message): + r"""Configuration options for L7 DDoS detection. + Attributes: + enable (bool): + If set to true, enables CAAP for L7 DDoS + detection. + rule_visibility (google.cloud.compute_v1.types.SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig.RuleVisibility): + Rule visibility can be one of the following: + STANDARD - opaque rules. (default) PREMIUM - + transparent rules. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + class RuleVisibility(proto.Enum): + r"""Rule visibility can be one of the following: STANDARD - + opaque rules. (default) PREMIUM - transparent rules. + """ + UNDEFINED_RULE_VISIBILITY = 0 + PREMIUM = 399530551 + STANDARD = 484642493 + enable = proto.Field(proto.BOOL, number=311764355, optional=True,) + rule_visibility = proto.Field( + proto.ENUM, number=453258293, optional=True, enum=RuleVisibility, + ) -class ListManagedInstancesRegionInstanceGroupManagersRequest(proto.Message): - r"""A request message for - RegionInstanceGroupManagers.ListManagedInstances. See the method - description for details. +class SecurityPolicyAdvancedOptionsConfig(proto.Message): + r""" Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. + json_parsing (google.cloud.compute_v1.types.SecurityPolicyAdvancedOptionsConfig.JsonParsing): - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + log_level (google.cloud.compute_v1.types.SecurityPolicyAdvancedOptionsConfig.LogLevel): - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + """ - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - instance_group_manager (str): - The name of the managed instance group. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. + class JsonParsing(proto.Enum): + r"""""" + UNDEFINED_JSON_PARSING = 0 + DISABLED = 516696700 + STANDARD = 484642493 - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. + class LogLevel(proto.Enum): + r"""""" + UNDEFINED_LOG_LEVEL = 0 + NORMAL = 161067239 + VERBOSE = 532219234 - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + json_parsing = proto.Field( + proto.ENUM, number=282493529, optional=True, enum=JsonParsing, + ) + log_level = proto.Field(proto.ENUM, number=140582601, optional=True, enum=LogLevel,) + + +class SecurityPolicyList(proto.Message): + r""" + Attributes: + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.SecurityPolicy]): + A list of SecurityPolicy resources. + kind (str): + [Output Only] Type of resource. Always + compute#securityPolicyList for listsof securityPolicies + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="SecurityPolicy", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class ListPerInstanceConfigsRegionInstanceGroupManagersRequest(proto.Message): - r"""A request message for - RegionInstanceGroupManagers.ListPerInstanceConfigs. See the - method description for details. +class SecurityPolicyReference(proto.Message): + r""" Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. + security_policy (str): - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + security_policy = proto.Field(proto.STRING, number=171082513, optional=True,) - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - instance_group_manager (str): - The name of the managed instance group. It - should conform to RFC1035. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. +class SecurityPolicyRule(proto.Message): + r"""Represents a rule that describes one or more match conditions + along with the action to be taken when traffic matches this + condition (allow or deny). - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request, - should conform to RFC1035. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + Attributes: + action (str): + The Action to perform when the client + connection triggers the rule. Can currently be + either "allow" or "deny()" where valid values + for status are 403, 404, and 502. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + kind (str): + [Output only] Type of the resource. Always + compute#securityPolicyRule for security policy rules + match (google.cloud.compute_v1.types.SecurityPolicyRuleMatcher): + A match condition that incoming traffic is + evaluated against. If it evaluates to true, the + corresponding 'action' is enforced. + preview (bool): + If set to true, the specified action is not + enforced. + priority (int): + An integer indicating the priority of a rule + in the list. The priority must be a positive + value between 0 and 2147483647. Rules are + evaluated from highest to lowest priority where + 0 is the highest priority and 2147483647 is the + lowest priority. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + action = proto.Field(proto.STRING, number=187661878, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + match = proto.Field( + proto.MESSAGE, + number=103668165, + optional=True, + message="SecurityPolicyRuleMatcher", + ) + preview = proto.Field(proto.BOOL, number=218686408, optional=True,) + priority = proto.Field(proto.INT32, number=445151652, optional=True,) -class PatchRegionInstanceGroupManagerRequest(proto.Message): - r"""A request message for RegionInstanceGroupManagers.Patch. See - the method description for details. +class SecurityPolicyRuleMatcher(proto.Message): + r"""Represents a match condition that incoming traffic is + evaluated against. Exactly one field must be specified. Attributes: - instance_group_manager (str): - The name of the instance group manager. - instance_group_manager_resource (google.cloud.compute_v1.types.InstanceGroupManager): - The body resource for this request - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + config (google.cloud.compute_v1.types.SecurityPolicyRuleMatcherConfig): + The configuration options available when specifying + versioned_expr. This field must be specified if + versioned_expr is specified and cannot be specified if + versioned_expr is not specified. + expr (google.cloud.compute_v1.types.Expr): + User defined CEVAL expression. A CEVAL expression is used to + specify match criteria such as origin.ip, source.region_code + and contents in the request header. + versioned_expr (google.cloud.compute_v1.types.SecurityPolicyRuleMatcher.VersionedExpr): + Preconfigured versioned expression. If this field is + specified, config must also be specified. Available + preconfigured expressions along with their requirements are: + SRC_IPS_V1 - must specify the corresponding src_ip_range + field in config. """ - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - instance_group_manager_resource = proto.Field( - proto.MESSAGE, number=261063946, message="InstanceGroupManager", - ) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + class VersionedExpr(proto.Enum): + r"""Preconfigured versioned expression. If this field is specified, + config must also be specified. Available preconfigured expressions + along with their requirements are: SRC_IPS_V1 - must specify the + corresponding src_ip_range field in config. + """ + UNDEFINED_VERSIONED_EXPR = 0 + SRC_IPS_V1 = 70925961 + config = proto.Field( + proto.MESSAGE, + number=255820610, + optional=True, + message="SecurityPolicyRuleMatcherConfig", + ) + expr = proto.Field(proto.MESSAGE, number=3127797, optional=True, message="Expr",) + versioned_expr = proto.Field( + proto.ENUM, number=322286013, optional=True, enum=VersionedExpr, + ) -class PatchPerInstanceConfigsRegionInstanceGroupManagerRequest(proto.Message): - r"""A request message for - RegionInstanceGroupManagers.PatchPerInstanceConfigs. See the - method description for details. +class SecurityPolicyRuleMatcherConfig(proto.Message): + r""" Attributes: - instance_group_manager (str): - The name of the managed instance group. It - should conform to RFC1035. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request, - should conform to RFC1035. - region_instance_group_manager_patch_instance_config_req_resource (google.cloud.compute_v1.types.RegionInstanceGroupManagerPatchInstanceConfigReq): - The body resource for this request - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + src_ip_ranges (Sequence[str]): + CIDR IP address range. Maximum number of src_ip_ranges + allowed is 10. """ - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - region_instance_group_manager_patch_instance_config_req_resource = proto.Field( - proto.MESSAGE, - number=197682890, - message="RegionInstanceGroupManagerPatchInstanceConfigReq", - ) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + src_ip_ranges = proto.RepeatedField(proto.STRING, number=432128083,) -class RecreateInstancesRegionInstanceGroupManagerRequest(proto.Message): - r"""A request message for - RegionInstanceGroupManagers.RecreateInstances. See the method - description for details. +class SecuritySettings(proto.Message): + r"""The authentication and authorization settings for a + BackendService. Attributes: - instance_group_manager (str): - Name of the managed instance group. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - region_instance_group_managers_recreate_request_resource (google.cloud.compute_v1.types.RegionInstanceGroupManagersRecreateRequest): - The body resource for this request - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + client_tls_policy (str): + Optional. A URL referring to a + networksecurity.ClientTlsPolicy resource that describes how + clients should authenticate with this service's backends. + clientTlsPolicy only applies to a global BackendService with + the loadBalancingScheme set to INTERNAL_SELF_MANAGED. If + left blank, communications are not encrypted. Note: This + field currently has no impact. + subject_alt_names (Sequence[str]): + Optional. A list of Subject Alternative Names (SANs) that + the client verifies during a mutual TLS handshake with an + server/endpoint for this BackendService. When the server + presents its X.509 certificate to the client, the client + inspects the certificate's subjectAltName field. If the + field contains one of the specified values, the + communication continues. Otherwise, it fails. This + additional check enables the client to verify that the + server is authorized to run the requested service. Note that + the contents of the server certificate's subjectAltName + field are configured by the Public Key Infrastructure which + provisions server identities. Only applies to a global + BackendService with loadBalancingScheme set to + INTERNAL_SELF_MANAGED. Only applies when BackendService has + an attached clientTlsPolicy with clientCertificate (mTLS + mode). Note: This field currently has no impact. """ - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - region_instance_group_managers_recreate_request_resource = proto.Field( - proto.MESSAGE, - number=170999316, - message="RegionInstanceGroupManagersRecreateRequest", - ) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + client_tls_policy = proto.Field(proto.STRING, number=462325226, optional=True,) + subject_alt_names = proto.RepeatedField(proto.STRING, number=330029535,) -class ResizeRegionInstanceGroupManagerRequest(proto.Message): - r"""A request message for RegionInstanceGroupManagers.Resize. See +class SendDiagnosticInterruptInstanceRequest(proto.Message): + r"""A request message for Instances.SendDiagnosticInterrupt. See the method description for details. Attributes: - instance_group_manager (str): - Name of the managed instance group. + instance (str): + Name of the instance scoping this request. project (str): Project ID for this request. - region (str): - Name of the region scoping this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - size (int): - Number of instances that should exist in this - instance group manager. + zone (str): + The name of the zone for this request. """ - instance_group_manager = proto.Field(proto.STRING, number=249363395,) + instance = proto.Field(proto.STRING, number=18257045,) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - size = proto.Field(proto.INT32, number=3530753,) + zone = proto.Field(proto.STRING, number=3744684,) -class SetInstanceTemplateRegionInstanceGroupManagerRequest(proto.Message): - r"""A request message for - RegionInstanceGroupManagers.SetInstanceTemplate. See the method - description for details. +class SendDiagnosticInterruptInstanceResponse(proto.Message): + r"""A response message for Instances.SendDiagnosticInterrupt. See + the method description for details. + """ + +class SerialPortOutput(proto.Message): + r"""An instance serial console output. Attributes: - instance_group_manager (str): - The name of the managed instance group. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - region_instance_group_managers_set_template_request_resource (google.cloud.compute_v1.types.RegionInstanceGroupManagersSetTemplateRequest): - The body resource for this request - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + contents (str): + [Output Only] The contents of the console output. + kind (str): + [Output Only] Type of the resource. Always + compute#serialPortOutput for serial port output. + next_ (int): + [Output Only] The position of the next byte of content, + regardless of whether the content exists, following the + output returned in the ``contents`` property. Use this value + in the next request as the start parameter. + self_link (str): + [Output Only] Server-defined URL for this resource. + start (int): + The starting byte position of the output that was returned. + This should match the start parameter sent with the request. + If the serial console output exceeds the size of the buffer + (1 MB), older output is overwritten by newer content. The + output start value will indicate the byte position of the + output that was returned, which might be different than the + ``start`` value that was specified in the request. """ - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - region_instance_group_managers_set_template_request_resource = proto.Field( - proto.MESSAGE, - number=187310412, - message="RegionInstanceGroupManagersSetTemplateRequest", - ) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - + contents = proto.Field(proto.STRING, number=506419994, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_ = proto.Field(proto.INT64, number=3377907, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + start = proto.Field(proto.INT64, number=109757538, optional=True,) -class SetTargetPoolsRegionInstanceGroupManagerRequest(proto.Message): - r"""A request message for - RegionInstanceGroupManagers.SetTargetPools. See the method - description for details. +class ServerBinding(proto.Message): + r""" Attributes: - instance_group_manager (str): - Name of the managed instance group. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - region_instance_group_managers_set_target_pools_request_resource (google.cloud.compute_v1.types.RegionInstanceGroupManagersSetTargetPoolsRequest): - The body resource for this request - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + type_ (google.cloud.compute_v1.types.ServerBinding.Type): + """ - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - region_instance_group_managers_set_target_pools_request_resource = proto.Field( - proto.MESSAGE, - number=78734717, - message="RegionInstanceGroupManagersSetTargetPoolsRequest", - ) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + class Type(proto.Enum): + r"""""" + UNDEFINED_TYPE = 0 + RESTART_NODE_ON_ANY_SERVER = 502950985 + RESTART_NODE_ON_MINIMAL_SERVERS = 204166495 + SERVER_BINDING_TYPE_UNSPECIFIED = 180825512 + type_ = proto.Field(proto.ENUM, number=3575610, optional=True, enum=Type,) -class UpdatePerInstanceConfigsRegionInstanceGroupManagerRequest(proto.Message): - r"""A request message for - RegionInstanceGroupManagers.UpdatePerInstanceConfigs. See the - method description for details. +class ServiceAccount(proto.Message): + r"""A service account. Attributes: - instance_group_manager (str): - The name of the managed instance group. It - should conform to RFC1035. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request, - should conform to RFC1035. - region_instance_group_manager_update_instance_config_req_resource (google.cloud.compute_v1.types.RegionInstanceGroupManagerUpdateInstanceConfigReq): - The body resource for this request - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + email (str): + Email address of the service account. + scopes (Sequence[str]): + The list of scopes to be made available for + this service account. """ - instance_group_manager = proto.Field(proto.STRING, number=249363395,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - region_instance_group_manager_update_instance_config_req_resource = proto.Field( - proto.MESSAGE, - number=89036583, - message="RegionInstanceGroupManagerUpdateInstanceConfigReq", - ) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - + email = proto.Field(proto.STRING, number=96619420, optional=True,) + scopes = proto.RepeatedField(proto.STRING, number=165973151,) -class GetRegionInstanceGroupRequest(proto.Message): - r"""A request message for RegionInstanceGroups.Get. See the - method description for details. - Attributes: - instance_group (str): - Name of the instance group resource to - return. - project (str): - Project ID for this request. +class ServiceAttachment(proto.Message): + r"""Represents a ServiceAttachment resource. A service attachment + represents a service that a producer has exposed. It + encapsulates the load balancer which fronts the service runs and + a list of NAT IP ranges that the producers uses to represent the + consumers connecting to the service. next tag = 20 + + Attributes: + connected_endpoints (Sequence[google.cloud.compute_v1.types.ServiceAttachmentConnectedEndpoint]): + [Output Only] An array of connections for all the consumers + connected to this service attachment. + connection_preference (google.cloud.compute_v1.types.ServiceAttachment.ConnectionPreference): + The connection preference of service attachment. The value + can be set to ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC service + attachment is one that always accepts the connection from + consumer forwarding rules. + consumer_accept_lists (Sequence[google.cloud.compute_v1.types.ServiceAttachmentConsumerProjectLimit]): + Projects that are allowed to connect to this + service attachment. + consumer_reject_lists (Sequence[str]): + Projects that are not allowed to connect to + this service attachment. The project can be + specified using its id or number. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + enable_proxy_protocol (bool): + If true, enable the proxy protocol which is + for supplying client TCP/IP address data in TCP + connections that traverse proxies on their way + to destination servers. + fingerprint (str): + Fingerprint of this resource. A hash of the + contents stored in this object. This field is + used in optimistic locking. This field will be + ignored when inserting a ServiceAttachment. An + up-to-date fingerprint must be provided in order + to patch/update the ServiceAttachment; + otherwise, the request will fail with error 412 + conditionNotMet. To see the latest fingerprint, + make a get() request to retrieve the + ServiceAttachment. + id (int): + [Output Only] The unique identifier for the resource type. + The server generates this identifier. + kind (str): + [Output Only] Type of the resource. Always + compute#serviceAttachment for service attachments. + name (str): + Name of the resource. Provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. + nat_subnets (Sequence[str]): + An array of URLs where each entry is the URL + of a subnet provided by the service producer to + use for NAT in this service attachment. + producer_forwarding_rule (str): + The URL of a forwarding rule with loadBalancingScheme + INTERNAL\* that is serving the endpoint identified by this + service attachment. + psc_service_attachment_id (google.cloud.compute_v1.types.Uint128): + [Output Only] An 128-bit global unique ID of the PSC service + attachment. region (str): - Name of the region scoping this request. + [Output Only] URL of the region where the service attachment + resides. This field applies only to the region resource. You + must specify this field as part of the HTTP request URL. It + is not settable as a field in the request body. + self_link (str): + [Output Only] Server-defined URL for the resource. + target_service (str): + The URL of a service serving the endpoint + identified by this service attachment. """ - instance_group = proto.Field(proto.STRING, number=81095253,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) + class ConnectionPreference(proto.Enum): + r"""The connection preference of service attachment. The value can be + set to ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC service attachment is + one that always accepts the connection from consumer forwarding + rules. + """ + UNDEFINED_CONNECTION_PREFERENCE = 0 + ACCEPT_AUTOMATIC = 75250580 + ACCEPT_MANUAL = 373061341 + CONNECTION_PREFERENCE_UNSPECIFIED = 34590772 + connected_endpoints = proto.RepeatedField( + proto.MESSAGE, number=72223688, message="ServiceAttachmentConnectedEndpoint", + ) + connection_preference = proto.Field( + proto.ENUM, number=285818076, optional=True, enum=ConnectionPreference, + ) + consumer_accept_lists = proto.RepeatedField( + proto.MESSAGE, + number=402725703, + message="ServiceAttachmentConsumerProjectLimit", + ) + consumer_reject_lists = proto.RepeatedField(proto.STRING, number=204033182,) + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + enable_proxy_protocol = proto.Field(proto.BOOL, number=363791237, optional=True,) + fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + nat_subnets = proto.RepeatedField(proto.STRING, number=374785944,) + producer_forwarding_rule = proto.Field( + proto.STRING, number=247927889, optional=True, + ) + psc_service_attachment_id = proto.Field( + proto.MESSAGE, number=527695214, optional=True, message="Uint128", + ) + region = proto.Field(proto.STRING, number=138946292, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + target_service = proto.Field(proto.STRING, number=1293831, optional=True,) -class ListRegionInstanceGroupsRequest(proto.Message): - r"""A request message for RegionInstanceGroups.List. See the - method description for details. +class ServiceAttachmentAggregatedList(proto.Message): + r"""Contains a list of ServiceAttachmentsScopedList. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.ServiceAttachmentAggregatedList.ItemsEntry]): + A list of ServiceAttachmentsScopedList + resources. + kind (str): + Type of resource. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + @property + def raw_page(self): + return self - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.MapField( + proto.STRING, + proto.MESSAGE, + number=100526016, + message="ServiceAttachmentsScopedList", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. +class ServiceAttachmentConnectedEndpoint(proto.Message): + r"""[Output Only] A connection connected to this service attachment. + Attributes: + endpoint (str): + The url of a connected endpoint. + psc_connection_id (int): + The PSC connection id of the connected + endpoint. + status (google.cloud.compute_v1.types.ServiceAttachmentConnectedEndpoint.Status): + The status of a connected endpoint to this + service attachment. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + class Status(proto.Enum): + r"""The status of a connected endpoint to this service + attachment. + """ + UNDEFINED_STATUS = 0 + ACCEPTED = 246714279 + CLOSED = 380163436 + PENDING = 35394935 + REJECTED = 174130302 + STATUS_UNSPECIFIED = 42133066 + endpoint = proto.Field(proto.STRING, number=130489749, optional=True,) + psc_connection_id = proto.Field(proto.UINT64, number=292082397, optional=True,) + status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) -class ListInstancesRegionInstanceGroupsRequest(proto.Message): - r"""A request message for RegionInstanceGroups.ListInstances. See - the method description for details. +class ServiceAttachmentConsumerProjectLimit(proto.Message): + r""" Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. + connection_limit (int): + The value of the limit to set. + project_id_or_num (str): + The project id or number for the project to + set the limit for. + """ - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + connection_limit = proto.Field(proto.UINT32, number=131403546, optional=True,) + project_id_or_num = proto.Field(proto.STRING, number=349783336, optional=True,) - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - instance_group (str): - Name of the regional instance group for which - we want to list the instances. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. +class ServiceAttachmentList(proto.Message): + r""" + Attributes: + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.ServiceAttachment]): + A list of ServiceAttachment resources. + kind (str): + [Output Only] Type of the resource. Always + compute#serviceAttachment for service attachments. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. + """ - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. + @property + def raw_page(self): + return self - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - region_instance_groups_list_instances_request_resource (google.cloud.compute_v1.types.RegionInstanceGroupsListInstancesRequest): - The body resource for this request - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="ServiceAttachment", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) + + +class ServiceAttachmentsScopedList(proto.Message): + r""" + Attributes: + service_attachments (Sequence[google.cloud.compute_v1.types.ServiceAttachment]): + A list of ServiceAttachments contained in + this scope. + warning (google.cloud.compute_v1.types.Warning): + Informational warning which replaces the list + of service attachments when the list is empty. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - instance_group = proto.Field(proto.STRING, number=81095253,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - region_instance_groups_list_instances_request_resource = proto.Field( - proto.MESSAGE, - number=48239828, - message="RegionInstanceGroupsListInstancesRequest", + service_attachments = proto.RepeatedField( + proto.MESSAGE, number=307136806, message="ServiceAttachment", + ) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", ) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class SetNamedPortsRegionInstanceGroupRequest(proto.Message): - r"""A request message for RegionInstanceGroups.SetNamedPorts. See +class SetBackendServiceTargetSslProxyRequest(proto.Message): + r"""A request message for TargetSslProxies.SetBackendService. See the method description for details. Attributes: - instance_group (str): - The name of the regional instance group where - the named ports are updated. project (str): Project ID for this request. - region (str): - Name of the region scoping this request. - region_instance_groups_set_named_ports_request_resource (google.cloud.compute_v1.types.RegionInstanceGroupsSetNamedPortsRequest): - The body resource for this request request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_ssl_proxies_set_backend_service_request_resource (google.cloud.compute_v1.types.TargetSslProxiesSetBackendServiceRequest): + The body resource for this request + target_ssl_proxy (str): + Name of the TargetSslProxy resource whose + BackendService resource is to be set. """ - instance_group = proto.Field(proto.STRING, number=81095253,) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - region_instance_groups_set_named_ports_request_resource = proto.Field( + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_ssl_proxies_set_backend_service_request_resource = proto.Field( proto.MESSAGE, - number=1574938, - message="RegionInstanceGroupsSetNamedPortsRequest", + number=139080868, + message="TargetSslProxiesSetBackendServiceRequest", ) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_ssl_proxy = proto.Field(proto.STRING, number=338795853,) -class BulkInsertRegionInstanceRequest(proto.Message): - r"""A request message for RegionInstances.BulkInsert. See the - method description for details. +class SetBackendServiceTargetTcpProxyRequest(proto.Message): + r"""A request message for TargetTcpProxies.SetBackendService. See + the method description for details. Attributes: - bulk_insert_instance_resource_resource (google.cloud.compute_v1.types.BulkInsertInstanceResource): - The body resource for this request project (str): Project ID for this request. - region (str): - The name of the region for this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_tcp_proxies_set_backend_service_request_resource (google.cloud.compute_v1.types.TargetTcpProxiesSetBackendServiceRequest): + The body resource for this request + target_tcp_proxy (str): + Name of the TargetTcpProxy resource whose + BackendService resource is to be set. """ - bulk_insert_instance_resource_resource = proto.Field( - proto.MESSAGE, number=41427278, message="BulkInsertInstanceResource", - ) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_tcp_proxies_set_backend_service_request_resource = proto.Field( + proto.MESSAGE, + number=273721583, + message="TargetTcpProxiesSetBackendServiceRequest", + ) + target_tcp_proxy = proto.Field(proto.STRING, number=503065442,) -class DeleteRegionNetworkEndpointGroupRequest(proto.Message): - r"""A request message for RegionNetworkEndpointGroups.Delete. See - the method description for details. +class SetBackupTargetPoolRequest(proto.Message): + r"""A request message for TargetPools.SetBackup. See the method + description for details. Attributes: - network_endpoint_group (str): - The name of the network endpoint group to - delete. It should comply with RFC1035. + failover_ratio (float): + New failoverRatio value for the target pool. project (str): Project ID for this request. region (str): - The name of the region where the network - endpoint group is located. It should comply with - RFC1035. + Name of the region scoping this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_pool (str): + Name of the TargetPool resource to set a + backup pool for. + target_reference_resource (google.cloud.compute_v1.types.TargetReference): + The body resource for this request """ - network_endpoint_group = proto.Field(proto.STRING, number=433907078,) + failover_ratio = proto.Field(proto.FLOAT, number=212667006, optional=True,) project = proto.Field(proto.STRING, number=227560217,) region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_pool = proto.Field(proto.STRING, number=62796298,) + target_reference_resource = proto.Field( + proto.MESSAGE, number=523721712, message="TargetReference", + ) -class GetRegionNetworkEndpointGroupRequest(proto.Message): - r"""A request message for RegionNetworkEndpointGroups.Get. See +class SetCommonInstanceMetadataProjectRequest(proto.Message): + r"""A request message for Projects.SetCommonInstanceMetadata. See the method description for details. Attributes: - network_endpoint_group (str): - The name of the network endpoint group. It - should comply with RFC1035. + metadata_resource (google.cloud.compute_v1.types.Metadata): + The body resource for this request project (str): Project ID for this request. - region (str): - The name of the region where the network - endpoint group is located. It should comply with - RFC1035. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - network_endpoint_group = proto.Field(proto.STRING, number=433907078,) + metadata_resource = proto.Field( + proto.MESSAGE, number=291086110, message="Metadata", + ) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class InsertRegionNetworkEndpointGroupRequest(proto.Message): - r"""A request message for RegionNetworkEndpointGroups.Insert. See - the method description for details. +class SetDefaultNetworkTierProjectRequest(proto.Message): + r"""A request message for Projects.SetDefaultNetworkTier. See the + method description for details. Attributes: - network_endpoint_group_resource (google.cloud.compute_v1.types.NetworkEndpointGroup): - The body resource for this request project (str): Project ID for this request. - region (str): - The name of the region where you want to - create the network endpoint group. It should - comply with RFC1035. + projects_set_default_network_tier_request_resource (google.cloud.compute_v1.types.ProjectsSetDefaultNetworkTierRequest): + The body resource for this request request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - network_endpoint_group_resource = proto.Field( - proto.MESSAGE, number=525788839, message="NetworkEndpointGroup", - ) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) + projects_set_default_network_tier_request_resource = proto.Field( + proto.MESSAGE, number=126410762, message="ProjectsSetDefaultNetworkTierRequest", + ) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class ListRegionNetworkEndpointGroupsRequest(proto.Message): - r"""A request message for RegionNetworkEndpointGroups.List. See +class SetDeletionProtectionInstanceRequest(proto.Message): + r"""A request message for Instances.SetDeletionProtection. See the method description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. + deletion_protection (bool): + Whether the resource should be protected + against deletion. project (str): Project ID for this request. - region (str): - The name of the region where the network - endpoint group is located. It should comply with - RFC1035. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + resource (str): + Name or id of the resource for this request. + zone (str): + The name of the zone for this request. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + deletion_protection = proto.Field(proto.BOOL, number=458014698, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + resource = proto.Field(proto.STRING, number=195806222,) + zone = proto.Field(proto.STRING, number=3744684,) -class DeleteRegionNotificationEndpointRequest(proto.Message): - r"""A request message for RegionNotificationEndpoints.Delete. See - the method description for details. +class SetDiskAutoDeleteInstanceRequest(proto.Message): + r"""A request message for Instances.SetDiskAutoDelete. See the + method description for details. Attributes: - notification_endpoint (str): - Name of the NotificationEndpoint resource to - delete. + auto_delete (bool): + Whether to auto-delete the disk when the + instance is deleted. + device_name (str): + The device name of the disk to modify. Make a + get() request on the instance to view currently + attached disks and device names. + instance (str): + The instance name for this request. project (str): Project ID for this request. - region (str): - Name of the region scoping this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. """ - notification_endpoint = proto.Field(proto.STRING, number=376807017,) + auto_delete = proto.Field(proto.BOOL, number=464761403,) + device_name = proto.Field(proto.STRING, number=67541716,) + instance = proto.Field(proto.STRING, number=18257045,) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class GetRegionNotificationEndpointRequest(proto.Message): - r"""A request message for RegionNotificationEndpoints.Get. See - the method description for details. +class SetIamPolicyDiskRequest(proto.Message): + r"""A request message for Disks.SetIamPolicy. See the method + description for details. Attributes: - notification_endpoint (str): - Name of the NotificationEndpoint resource to - return. project (str): Project ID for this request. - region (str): - Name of the region scoping this request. + resource (str): + Name or id of the resource for this request. + zone (str): + The name of the zone for this request. + zone_set_policy_request_resource (google.cloud.compute_v1.types.ZoneSetPolicyRequest): + The body resource for this request """ - notification_endpoint = proto.Field(proto.STRING, number=376807017,) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) + resource = proto.Field(proto.STRING, number=195806222,) + zone = proto.Field(proto.STRING, number=3744684,) + zone_set_policy_request_resource = proto.Field( + proto.MESSAGE, number=382082107, message="ZoneSetPolicyRequest", + ) -class InsertRegionNotificationEndpointRequest(proto.Message): - r"""A request message for RegionNotificationEndpoints.Insert. See - the method description for details. +class SetIamPolicyFirewallPolicyRequest(proto.Message): + r"""A request message for FirewallPolicies.SetIamPolicy. See the + method description for details. Attributes: - notification_endpoint_resource (google.cloud.compute_v1.types.NotificationEndpoint): + global_organization_set_policy_request_resource (google.cloud.compute_v1.types.GlobalOrganizationSetPolicyRequest): + The body resource for this request + resource (str): + Name or id of the resource for this request. + """ + + global_organization_set_policy_request_resource = proto.Field( + proto.MESSAGE, number=177408606, message="GlobalOrganizationSetPolicyRequest", + ) + resource = proto.Field(proto.STRING, number=195806222,) + + +class SetIamPolicyImageRequest(proto.Message): + r"""A request message for Images.SetIamPolicy. See the method + description for details. + + Attributes: + global_set_policy_request_resource (google.cloud.compute_v1.types.GlobalSetPolicyRequest): The body resource for this request project (str): Project ID for this request. - region (str): - Name of the region scoping this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + resource (str): + Name or id of the resource for this request. """ - notification_endpoint_resource = proto.Field( - proto.MESSAGE, number=338459940, message="NotificationEndpoint", + global_set_policy_request_resource = proto.Field( + proto.MESSAGE, number=337048498, message="GlobalSetPolicyRequest", ) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + resource = proto.Field(proto.STRING, number=195806222,) -class ListRegionNotificationEndpointsRequest(proto.Message): - r"""A request message for RegionNotificationEndpoints.List. See - the method description for details. +class SetIamPolicyInstanceRequest(proto.Message): + r"""A request message for Instances.SetIamPolicy. See the method + description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. + project (str): + Project ID for this request. + resource (str): + Name or id of the resource for this request. + zone (str): + The name of the zone for this request. + zone_set_policy_request_resource (google.cloud.compute_v1.types.ZoneSetPolicyRequest): + The body resource for this request + """ - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + project = proto.Field(proto.STRING, number=227560217,) + resource = proto.Field(proto.STRING, number=195806222,) + zone = proto.Field(proto.STRING, number=3744684,) + zone_set_policy_request_resource = proto.Field( + proto.MESSAGE, number=382082107, message="ZoneSetPolicyRequest", + ) - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. +class SetIamPolicyInstanceTemplateRequest(proto.Message): + r"""A request message for InstanceTemplates.SetIamPolicy. See the + method description for details. - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. + Attributes: + global_set_policy_request_resource (google.cloud.compute_v1.types.GlobalSetPolicyRequest): + The body resource for this request + project (str): + Project ID for this request. + resource (str): + Name or id of the resource for this request. + """ - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. + global_set_policy_request_resource = proto.Field( + proto.MESSAGE, number=337048498, message="GlobalSetPolicyRequest", + ) + project = proto.Field(proto.STRING, number=227560217,) + resource = proto.Field(proto.STRING, number=195806222,) + + +class SetIamPolicyLicenseRequest(proto.Message): + r"""A request message for Licenses.SetIamPolicy. See the method + description for details. + + Attributes: + global_set_policy_request_resource (google.cloud.compute_v1.types.GlobalSetPolicyRequest): + The body resource for this request + project (str): + Project ID for this request. + resource (str): + Name or id of the resource for this request. + """ + + global_set_policy_request_resource = proto.Field( + proto.MESSAGE, number=337048498, message="GlobalSetPolicyRequest", + ) + project = proto.Field(proto.STRING, number=227560217,) + resource = proto.Field(proto.STRING, number=195806222,) + + +class SetIamPolicyNodeGroupRequest(proto.Message): + r"""A request message for NodeGroups.SetIamPolicy. See the method + description for details. + + Attributes: project (str): Project ID for this request. - region (str): - Name of the region scoping this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + resource (str): + Name or id of the resource for this request. + zone (str): + The name of the zone for this request. + zone_set_policy_request_resource (google.cloud.compute_v1.types.ZoneSetPolicyRequest): + The body resource for this request """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + resource = proto.Field(proto.STRING, number=195806222,) + zone = proto.Field(proto.STRING, number=3744684,) + zone_set_policy_request_resource = proto.Field( + proto.MESSAGE, number=382082107, message="ZoneSetPolicyRequest", + ) -class DeleteRegionOperationRequest(proto.Message): - r"""A request message for RegionOperations.Delete. See the method - description for details. +class SetIamPolicyNodeTemplateRequest(proto.Message): + r"""A request message for NodeTemplates.SetIamPolicy. See the + method description for details. Attributes: - operation (str): - Name of the Operations resource to delete. project (str): Project ID for this request. region (str): - Name of the region for this request. + The name of the region for this request. + region_set_policy_request_resource (google.cloud.compute_v1.types.RegionSetPolicyRequest): + The body resource for this request + resource (str): + Name or id of the resource for this request. """ - operation = proto.Field(proto.STRING, number=52090215,) project = proto.Field(proto.STRING, number=227560217,) region = proto.Field(proto.STRING, number=138946292,) + region_set_policy_request_resource = proto.Field( + proto.MESSAGE, number=276489091, message="RegionSetPolicyRequest", + ) + resource = proto.Field(proto.STRING, number=195806222,) -class DeleteRegionOperationResponse(proto.Message): - r"""A response message for RegionOperations.Delete. See the +class SetIamPolicyRegionDiskRequest(proto.Message): + r"""A request message for RegionDisks.SetIamPolicy. See the method description for details. - """ - - -class GetRegionOperationRequest(proto.Message): - r"""A request message for RegionOperations.Get. See the method - description for details. Attributes: - operation (str): - Name of the Operations resource to return. project (str): Project ID for this request. region (str): - Name of the region for this request. + The name of the region for this request. + region_set_policy_request_resource (google.cloud.compute_v1.types.RegionSetPolicyRequest): + The body resource for this request + resource (str): + Name or id of the resource for this request. """ - operation = proto.Field(proto.STRING, number=52090215,) project = proto.Field(proto.STRING, number=227560217,) region = proto.Field(proto.STRING, number=138946292,) + region_set_policy_request_resource = proto.Field( + proto.MESSAGE, number=276489091, message="RegionSetPolicyRequest", + ) + resource = proto.Field(proto.STRING, number=195806222,) -class ListRegionOperationsRequest(proto.Message): - r"""A request message for RegionOperations.List. See the method - description for details. +class SetIamPolicyReservationRequest(proto.Message): + r"""A request message for Reservations.SetIamPolicy. See the + method description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + project (str): + Project ID for this request. + resource (str): + Name or id of the resource for this request. + zone (str): + The name of the zone for this request. + zone_set_policy_request_resource (google.cloud.compute_v1.types.ZoneSetPolicyRequest): + The body resource for this request + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + project = proto.Field(proto.STRING, number=227560217,) + resource = proto.Field(proto.STRING, number=195806222,) + zone = proto.Field(proto.STRING, number=3744684,) + zone_set_policy_request_resource = proto.Field( + proto.MESSAGE, number=382082107, message="ZoneSetPolicyRequest", + ) - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. +class SetIamPolicyResourcePolicyRequest(proto.Message): + r"""A request message for ResourcePolicies.SetIamPolicy. See the + method description for details. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. + Attributes: project (str): Project ID for this request. region (str): - Name of the region for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + The name of the region for this request. + region_set_policy_request_resource (google.cloud.compute_v1.types.RegionSetPolicyRequest): + The body resource for this request + resource (str): + Name or id of the resource for this request. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + region_set_policy_request_resource = proto.Field( + proto.MESSAGE, number=276489091, message="RegionSetPolicyRequest", + ) + resource = proto.Field(proto.STRING, number=195806222,) -class WaitRegionOperationRequest(proto.Message): - r"""A request message for RegionOperations.Wait. See the method - description for details. +class SetIamPolicyServiceAttachmentRequest(proto.Message): + r"""A request message for ServiceAttachments.SetIamPolicy. See + the method description for details. Attributes: - operation (str): - Name of the Operations resource to return. project (str): Project ID for this request. region (str): - Name of the region for this request. + The name of the region for this request. + region_set_policy_request_resource (google.cloud.compute_v1.types.RegionSetPolicyRequest): + The body resource for this request + resource (str): + Name or id of the resource for this request. """ - operation = proto.Field(proto.STRING, number=52090215,) project = proto.Field(proto.STRING, number=227560217,) region = proto.Field(proto.STRING, number=138946292,) + region_set_policy_request_resource = proto.Field( + proto.MESSAGE, number=276489091, message="RegionSetPolicyRequest", + ) + resource = proto.Field(proto.STRING, number=195806222,) -class DeleteRegionSslCertificateRequest(proto.Message): - r"""A request message for RegionSslCertificates.Delete. See the - method description for details. +class SetIamPolicySnapshotRequest(proto.Message): + r"""A request message for Snapshots.SetIamPolicy. See the method + description for details. Attributes: + global_set_policy_request_resource (google.cloud.compute_v1.types.GlobalSetPolicyRequest): + The body resource for this request project (str): Project ID for this request. - region (str): - Name of the region scoping this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - ssl_certificate (str): - Name of the SslCertificate resource to - delete. + resource (str): + Name or id of the resource for this request. """ + global_set_policy_request_resource = proto.Field( + proto.MESSAGE, number=337048498, message="GlobalSetPolicyRequest", + ) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - ssl_certificate = proto.Field(proto.STRING, number=46443492,) + resource = proto.Field(proto.STRING, number=195806222,) -class GetRegionSslCertificateRequest(proto.Message): - r"""A request message for RegionSslCertificates.Get. See the +class SetIamPolicySubnetworkRequest(proto.Message): + r"""A request message for Subnetworks.SetIamPolicy. See the method description for details. Attributes: project (str): Project ID for this request. region (str): - Name of the region scoping this request. - ssl_certificate (str): - Name of the SslCertificate resource to - return. + The name of the region for this request. + region_set_policy_request_resource (google.cloud.compute_v1.types.RegionSetPolicyRequest): + The body resource for this request + resource (str): + Name or id of the resource for this request. """ project = proto.Field(proto.STRING, number=227560217,) region = proto.Field(proto.STRING, number=138946292,) - ssl_certificate = proto.Field(proto.STRING, number=46443492,) + region_set_policy_request_resource = proto.Field( + proto.MESSAGE, number=276489091, message="RegionSetPolicyRequest", + ) + resource = proto.Field(proto.STRING, number=195806222,) -class InsertRegionSslCertificateRequest(proto.Message): - r"""A request message for RegionSslCertificates.Insert. See the - method description for details. +class SetInstanceTemplateInstanceGroupManagerRequest(proto.Message): + r"""A request message for + InstanceGroupManagers.SetInstanceTemplate. See the method + description for details. Attributes: + instance_group_manager (str): + The name of the managed instance group. + instance_group_managers_set_instance_template_request_resource (google.cloud.compute_v1.types.InstanceGroupManagersSetInstanceTemplateRequest): + The body resource for this request project (str): Project ID for this request. - region (str): - Name of the region scoping this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - ssl_certificate_resource (google.cloud.compute_v1.types.SslCertificate): - The body resource for this request + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone where the managed + instance group is located. """ + instance_group_manager = proto.Field(proto.STRING, number=249363395,) + instance_group_managers_set_instance_template_request_resource = proto.Field( + proto.MESSAGE, + number=9809093, + message="InstanceGroupManagersSetInstanceTemplateRequest", + ) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - ssl_certificate_resource = proto.Field( - proto.MESSAGE, number=180709897, message="SslCertificate", - ) + zone = proto.Field(proto.STRING, number=3744684,) -class ListRegionSslCertificatesRequest(proto.Message): - r"""A request message for RegionSslCertificates.List. See the - method description for details. +class SetInstanceTemplateRegionInstanceGroupManagerRequest(proto.Message): + r"""A request message for + RegionInstanceGroupManagers.SetInstanceTemplate. See the method + description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. + instance_group_manager (str): + The name of the managed instance group. project (str): Project ID for this request. region (str): Name of the region scoping this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + region_instance_group_managers_set_template_request_resource (google.cloud.compute_v1.types.RegionInstanceGroupManagersSetTemplateRequest): + The body resource for this request + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + instance_group_manager = proto.Field(proto.STRING, number=249363395,) project = proto.Field(proto.STRING, number=227560217,) region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + region_instance_group_managers_set_template_request_resource = proto.Field( + proto.MESSAGE, + number=187310412, + message="RegionInstanceGroupManagersSetTemplateRequest", + ) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class DeleteRegionTargetHttpProxyRequest(proto.Message): - r"""A request message for RegionTargetHttpProxies.Delete. See the - method description for details. +class SetLabelsDiskRequest(proto.Message): + r"""A request message for Disks.SetLabels. See the method + description for details. Attributes: project (str): Project ID for this request. - region (str): - Name of the region scoping this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_http_proxy (str): - Name of the TargetHttpProxy resource to - delete. + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + resource (str): + Name or id of the resource for this request. + zone (str): + The name of the zone for this request. + zone_set_labels_request_resource (google.cloud.compute_v1.types.ZoneSetLabelsRequest): + The body resource for this request """ project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_http_proxy = proto.Field(proto.STRING, number=206872421,) + resource = proto.Field(proto.STRING, number=195806222,) + zone = proto.Field(proto.STRING, number=3744684,) + zone_set_labels_request_resource = proto.Field( + proto.MESSAGE, number=364950798, message="ZoneSetLabelsRequest", + ) -class GetRegionTargetHttpProxyRequest(proto.Message): - r"""A request message for RegionTargetHttpProxies.Get. See the +class SetLabelsExternalVpnGatewayRequest(proto.Message): + r"""A request message for ExternalVpnGateways.SetLabels. See the method description for details. Attributes: + global_set_labels_request_resource (google.cloud.compute_v1.types.GlobalSetLabelsRequest): + The body resource for this request project (str): Project ID for this request. - region (str): - Name of the region scoping this request. - target_http_proxy (str): - Name of the TargetHttpProxy resource to - return. + resource (str): + Name or id of the resource for this request. """ + global_set_labels_request_resource = proto.Field( + proto.MESSAGE, number=319917189, message="GlobalSetLabelsRequest", + ) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - target_http_proxy = proto.Field(proto.STRING, number=206872421,) + resource = proto.Field(proto.STRING, number=195806222,) -class InsertRegionTargetHttpProxyRequest(proto.Message): - r"""A request message for RegionTargetHttpProxies.Insert. See the +class SetLabelsForwardingRuleRequest(proto.Message): + r"""A request message for ForwardingRules.SetLabels. See the method description for details. Attributes: project (str): Project ID for this request. region (str): - Name of the region scoping this request. + The region for this request. + region_set_labels_request_resource (google.cloud.compute_v1.types.RegionSetLabelsRequest): + The body resource for this request request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_http_proxy_resource (google.cloud.compute_v1.types.TargetHttpProxy): - The body resource for this request + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + resource (str): + Name or id of the resource for this request. """ project = proto.Field(proto.STRING, number=227560217,) region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_http_proxy_resource = proto.Field( - proto.MESSAGE, number=24696744, message="TargetHttpProxy", + region_set_labels_request_resource = proto.Field( + proto.MESSAGE, number=259357782, message="RegionSetLabelsRequest", ) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + resource = proto.Field(proto.STRING, number=195806222,) -class ListRegionTargetHttpProxiesRequest(proto.Message): - r"""A request message for RegionTargetHttpProxies.List. See the - method description for details. +class SetLabelsGlobalForwardingRuleRequest(proto.Message): + r"""A request message for GlobalForwardingRules.SetLabels. See + the method description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. + global_set_labels_request_resource (google.cloud.compute_v1.types.GlobalSetLabelsRequest): + The body resource for this request project (str): Project ID for this request. - region (str): - Name of the region scoping this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + resource (str): + Name or id of the resource for this request. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + global_set_labels_request_resource = proto.Field( + proto.MESSAGE, number=319917189, message="GlobalSetLabelsRequest", + ) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + resource = proto.Field(proto.STRING, number=195806222,) -class SetUrlMapRegionTargetHttpProxyRequest(proto.Message): - r"""A request message for RegionTargetHttpProxies.SetUrlMap. See - the method description for details. +class SetLabelsImageRequest(proto.Message): + r"""A request message for Images.SetLabels. See the method + description for details. Attributes: + global_set_labels_request_resource (google.cloud.compute_v1.types.GlobalSetLabelsRequest): + The body resource for this request project (str): Project ID for this request. - region (str): - Name of the region scoping this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_http_proxy (str): - Name of the TargetHttpProxy to set a URL map - for. - url_map_reference_resource (google.cloud.compute_v1.types.UrlMapReference): - The body resource for this request + resource (str): + Name or id of the resource for this request. """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_http_proxy = proto.Field(proto.STRING, number=206872421,) - url_map_reference_resource = proto.Field( - proto.MESSAGE, number=398701333, message="UrlMapReference", + global_set_labels_request_resource = proto.Field( + proto.MESSAGE, number=319917189, message="GlobalSetLabelsRequest", ) + project = proto.Field(proto.STRING, number=227560217,) + resource = proto.Field(proto.STRING, number=195806222,) -class DeleteRegionTargetHttpsProxyRequest(proto.Message): - r"""A request message for RegionTargetHttpsProxies.Delete. See - the method description for details. +class SetLabelsInstanceRequest(proto.Message): + r"""A request message for Instances.SetLabels. See the method + description for details. Attributes: + instance (str): + Name of the instance scoping this request. + instances_set_labels_request_resource (google.cloud.compute_v1.types.InstancesSetLabelsRequest): + The body resource for this request project (str): Project ID for this request. - region (str): - Name of the region scoping this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_https_proxy (str): - Name of the TargetHttpsProxy resource to - delete. - """ - - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_https_proxy = proto.Field(proto.STRING, number=52336748,) - - -class GetRegionTargetHttpsProxyRequest(proto.Message): - r"""A request message for RegionTargetHttpsProxies.Get. See the - method description for details. - - Attributes: - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - target_https_proxy (str): - Name of the TargetHttpsProxy resource to - return. + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. """ + instance = proto.Field(proto.STRING, number=18257045,) + instances_set_labels_request_resource = proto.Field( + proto.MESSAGE, number=207749344, message="InstancesSetLabelsRequest", + ) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - target_https_proxy = proto.Field(proto.STRING, number=52336748,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class InsertRegionTargetHttpsProxyRequest(proto.Message): - r"""A request message for RegionTargetHttpsProxies.Insert. See - the method description for details. +class SetLabelsRegionDiskRequest(proto.Message): + r"""A request message for RegionDisks.SetLabels. See the method + description for details. Attributes: project (str): Project ID for this request. region (str): - Name of the region scoping this request. + The region for this request. + region_set_labels_request_resource (google.cloud.compute_v1.types.RegionSetLabelsRequest): + The body resource for this request request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_https_proxy_resource (google.cloud.compute_v1.types.TargetHttpsProxy): - The body resource for this request + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + resource (str): + Name or id of the resource for this request. """ project = proto.Field(proto.STRING, number=227560217,) region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_https_proxy_resource = proto.Field( - proto.MESSAGE, number=433657473, message="TargetHttpsProxy", + region_set_labels_request_resource = proto.Field( + proto.MESSAGE, number=259357782, message="RegionSetLabelsRequest", ) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + resource = proto.Field(proto.STRING, number=195806222,) -class ListRegionTargetHttpsProxiesRequest(proto.Message): - r"""A request message for RegionTargetHttpsProxies.List. See the - method description for details. +class SetLabelsSnapshotRequest(proto.Message): + r"""A request message for Snapshots.SetLabels. See the method + description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. + global_set_labels_request_resource (google.cloud.compute_v1.types.GlobalSetLabelsRequest): + The body resource for this request project (str): Project ID for this request. - region (str): - Name of the region scoping this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + resource (str): + Name or id of the resource for this request. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + global_set_labels_request_resource = proto.Field( + proto.MESSAGE, number=319917189, message="GlobalSetLabelsRequest", + ) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + resource = proto.Field(proto.STRING, number=195806222,) -class SetSslCertificatesRegionTargetHttpsProxyRequest(proto.Message): - r"""A request message for - RegionTargetHttpsProxies.SetSslCertificates. See the method +class SetLabelsVpnGatewayRequest(proto.Message): + r"""A request message for VpnGateways.SetLabels. See the method description for details. Attributes: project (str): Project ID for this request. region (str): - Name of the region scoping this request. - region_target_https_proxies_set_ssl_certificates_request_resource (google.cloud.compute_v1.types.RegionTargetHttpsProxiesSetSslCertificatesRequest): + The region for this request. + region_set_labels_request_resource (google.cloud.compute_v1.types.RegionSetLabelsRequest): The body resource for this request request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_https_proxy (str): - Name of the TargetHttpsProxy resource to set - an SslCertificates resource for. + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + resource (str): + Name or id of the resource for this request. """ project = proto.Field(proto.STRING, number=227560217,) region = proto.Field(proto.STRING, number=138946292,) - region_target_https_proxies_set_ssl_certificates_request_resource = proto.Field( - proto.MESSAGE, - number=390693383, - message="RegionTargetHttpsProxiesSetSslCertificatesRequest", + region_set_labels_request_resource = proto.Field( + proto.MESSAGE, number=259357782, message="RegionSetLabelsRequest", ) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_https_proxy = proto.Field(proto.STRING, number=52336748,) + resource = proto.Field(proto.STRING, number=195806222,) -class SetUrlMapRegionTargetHttpsProxyRequest(proto.Message): - r"""A request message for RegionTargetHttpsProxies.SetUrlMap. See - the method description for details. +class SetMachineResourcesInstanceRequest(proto.Message): + r"""A request message for Instances.SetMachineResources. See the + method description for details. Attributes: + instance (str): + Name of the instance scoping this request. + instances_set_machine_resources_request_resource (google.cloud.compute_v1.types.InstancesSetMachineResourcesRequest): + The body resource for this request project (str): Project ID for this request. - region (str): - Name of the region scoping this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_https_proxy (str): - Name of the TargetHttpsProxy to set a URL map - for. - url_map_reference_resource (google.cloud.compute_v1.types.UrlMapReference): - The body resource for this request + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. """ + instance = proto.Field(proto.STRING, number=18257045,) + instances_set_machine_resources_request_resource = proto.Field( + proto.MESSAGE, number=196286318, message="InstancesSetMachineResourcesRequest", + ) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_https_proxy = proto.Field(proto.STRING, number=52336748,) - url_map_reference_resource = proto.Field( - proto.MESSAGE, number=398701333, message="UrlMapReference", - ) + zone = proto.Field(proto.STRING, number=3744684,) -class DeleteRegionUrlMapRequest(proto.Message): - r"""A request message for RegionUrlMaps.Delete. See the method - description for details. +class SetMachineTypeInstanceRequest(proto.Message): + r"""A request message for Instances.SetMachineType. See the + method description for details. Attributes: + instance (str): + Name of the instance scoping this request. + instances_set_machine_type_request_resource (google.cloud.compute_v1.types.InstancesSetMachineTypeRequest): + The body resource for this request project (str): Project ID for this request. - region (str): - Name of the region scoping this request. request_id (str): - begin_interface: MixerMutationRequestBuilder Request ID to - support idempotency. - url_map (str): - Name of the UrlMap resource to delete. + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. """ + instance = proto.Field(proto.STRING, number=18257045,) + instances_set_machine_type_request_resource = proto.Field( + proto.MESSAGE, number=254157709, message="InstancesSetMachineTypeRequest", + ) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - url_map = proto.Field(proto.STRING, number=367020684,) + zone = proto.Field(proto.STRING, number=3744684,) -class GetRegionUrlMapRequest(proto.Message): - r"""A request message for RegionUrlMaps.Get. See the method +class SetMetadataInstanceRequest(proto.Message): + r"""A request message for Instances.SetMetadata. See the method description for details. Attributes: + instance (str): + Name of the instance scoping this request. + metadata_resource (google.cloud.compute_v1.types.Metadata): + The body resource for this request project (str): Project ID for this request. - region (str): - Name of the region scoping this request. - url_map (str): - Name of the UrlMap resource to return. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. """ + instance = proto.Field(proto.STRING, number=18257045,) + metadata_resource = proto.Field( + proto.MESSAGE, number=291086110, message="Metadata", + ) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - url_map = proto.Field(proto.STRING, number=367020684,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class InsertRegionUrlMapRequest(proto.Message): - r"""A request message for RegionUrlMaps.Insert. See the method - description for details. +class SetMinCpuPlatformInstanceRequest(proto.Message): + r"""A request message for Instances.SetMinCpuPlatform. See the + method description for details. Attributes: + instance (str): + Name of the instance scoping this request. + instances_set_min_cpu_platform_request_resource (google.cloud.compute_v1.types.InstancesSetMinCpuPlatformRequest): + The body resource for this request project (str): Project ID for this request. - region (str): - Name of the region scoping this request. request_id (str): - begin_interface: MixerMutationRequestBuilder Request ID to - support idempotency. - url_map_resource (google.cloud.compute_v1.types.UrlMap): - The body resource for this request + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. """ + instance = proto.Field(proto.STRING, number=18257045,) + instances_set_min_cpu_platform_request_resource = proto.Field( + proto.MESSAGE, number=148459368, message="InstancesSetMinCpuPlatformRequest", + ) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - url_map_resource = proto.Field(proto.MESSAGE, number=168675425, message="UrlMap",) + zone = proto.Field(proto.STRING, number=3744684,) -class ListRegionUrlMapsRequest(proto.Message): - r"""A request message for RegionUrlMaps.List. See the method - description for details. +class SetNamedPortsInstanceGroupRequest(proto.Message): + r"""A request message for InstanceGroups.SetNamedPorts. See the + method description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. + instance_group (str): + The name of the instance group where the + named ports are updated. + instance_groups_set_named_ports_request_resource (google.cloud.compute_v1.types.InstanceGroupsSetNamedPortsRequest): + The body resource for this request project (str): Project ID for this request. - region (str): - Name of the region scoping this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone where the instance group + is located. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + instance_group = proto.Field(proto.STRING, number=81095253,) + instance_groups_set_named_ports_request_resource = proto.Field( + proto.MESSAGE, number=385151535, message="InstanceGroupsSetNamedPortsRequest", + ) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class PatchRegionUrlMapRequest(proto.Message): - r"""A request message for RegionUrlMaps.Patch. See the method - description for details. +class SetNamedPortsRegionInstanceGroupRequest(proto.Message): + r"""A request message for RegionInstanceGroups.SetNamedPorts. See + the method description for details. Attributes: + instance_group (str): + The name of the regional instance group where + the named ports are updated. project (str): Project ID for this request. region (str): Name of the region scoping this request. - request_id (str): - begin_interface: MixerMutationRequestBuilder Request ID to - support idempotency. - url_map (str): - Name of the UrlMap resource to patch. - url_map_resource (google.cloud.compute_v1.types.UrlMap): + region_instance_groups_set_named_ports_request_resource (google.cloud.compute_v1.types.RegionInstanceGroupsSetNamedPortsRequest): The body resource for this request + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ + instance_group = proto.Field(proto.STRING, number=81095253,) project = proto.Field(proto.STRING, number=227560217,) region = proto.Field(proto.STRING, number=138946292,) + region_instance_groups_set_named_ports_request_resource = proto.Field( + proto.MESSAGE, + number=1574938, + message="RegionInstanceGroupsSetNamedPortsRequest", + ) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - url_map = proto.Field(proto.STRING, number=367020684,) - url_map_resource = proto.Field(proto.MESSAGE, number=168675425, message="UrlMap",) -class UpdateRegionUrlMapRequest(proto.Message): - r"""A request message for RegionUrlMaps.Update. See the method - description for details. +class SetNodeTemplateNodeGroupRequest(proto.Message): + r"""A request message for NodeGroups.SetNodeTemplate. See the + method description for details. Attributes: + node_group (str): + Name of the NodeGroup resource to update. + node_groups_set_node_template_request_resource (google.cloud.compute_v1.types.NodeGroupsSetNodeTemplateRequest): + The body resource for this request project (str): Project ID for this request. - region (str): - Name of the region scoping this request. request_id (str): - begin_interface: MixerMutationRequestBuilder Request ID to - support idempotency. - url_map (str): - Name of the UrlMap resource to update. - url_map_resource (google.cloud.compute_v1.types.UrlMap): - The body resource for this request + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. """ + node_group = proto.Field(proto.STRING, number=469958146,) + node_groups_set_node_template_request_resource = proto.Field( + proto.MESSAGE, number=117382321, message="NodeGroupsSetNodeTemplateRequest", + ) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - url_map = proto.Field(proto.STRING, number=367020684,) - url_map_resource = proto.Field(proto.MESSAGE, number=168675425, message="UrlMap",) + zone = proto.Field(proto.STRING, number=3744684,) -class ValidateRegionUrlMapRequest(proto.Message): - r"""A request message for RegionUrlMaps.Validate. See the method - description for details. +class SetPrivateIpGoogleAccessSubnetworkRequest(proto.Message): + r"""A request message for Subnetworks.SetPrivateIpGoogleAccess. + See the method description for details. Attributes: project (str): Project ID for this request. region (str): Name of the region scoping this request. - region_url_maps_validate_request_resource (google.cloud.compute_v1.types.RegionUrlMapsValidateRequest): + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + subnetwork (str): + Name of the Subnetwork resource. + subnetworks_set_private_ip_google_access_request_resource (google.cloud.compute_v1.types.SubnetworksSetPrivateIpGoogleAccessRequest): The body resource for this request - url_map (str): - Name of the UrlMap resource to be validated - as. """ project = proto.Field(proto.STRING, number=227560217,) region = proto.Field(proto.STRING, number=138946292,) - region_url_maps_validate_request_resource = proto.Field( - proto.MESSAGE, number=56632858, message="RegionUrlMapsValidateRequest", + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + subnetwork = proto.Field(proto.STRING, number=307827694,) + subnetworks_set_private_ip_google_access_request_resource = proto.Field( + proto.MESSAGE, + number=268920696, + message="SubnetworksSetPrivateIpGoogleAccessRequest", ) - url_map = proto.Field(proto.STRING, number=367020684,) -class GetRegionRequest(proto.Message): - r"""A request message for Regions.Get. See the method description - for details. +class SetProxyHeaderTargetSslProxyRequest(proto.Message): + r"""A request message for TargetSslProxies.SetProxyHeader. See + the method description for details. Attributes: project (str): Project ID for this request. - region (str): - Name of the region resource to return. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_ssl_proxies_set_proxy_header_request_resource (google.cloud.compute_v1.types.TargetSslProxiesSetProxyHeaderRequest): + The body resource for this request + target_ssl_proxy (str): + Name of the TargetSslProxy resource whose + ProxyHeader is to be set. """ project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_ssl_proxies_set_proxy_header_request_resource = proto.Field( + proto.MESSAGE, + number=205284526, + message="TargetSslProxiesSetProxyHeaderRequest", + ) + target_ssl_proxy = proto.Field(proto.STRING, number=338795853,) -class ListRegionsRequest(proto.Message): - r"""A request message for Regions.List. See the method - description for details. +class SetProxyHeaderTargetTcpProxyRequest(proto.Message): + r"""A request message for TargetTcpProxies.SetProxyHeader. See + the method description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. project (str): Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_tcp_proxies_set_proxy_header_request_resource (google.cloud.compute_v1.types.TargetTcpProxiesSetProxyHeaderRequest): + The body resource for this request + target_tcp_proxy (str): + Name of the TargetTcpProxy resource whose + ProxyHeader is to be set. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_tcp_proxies_set_proxy_header_request_resource = proto.Field( + proto.MESSAGE, + number=219958339, + message="TargetTcpProxiesSetProxyHeaderRequest", + ) + target_tcp_proxy = proto.Field(proto.STRING, number=503065442,) -class AggregatedListReservationsRequest(proto.Message): - r"""A request message for Reservations.AggregatedList. See the - method description for details. +class SetQuicOverrideTargetHttpsProxyRequest(proto.Message): + r"""A request message for TargetHttpsProxies.SetQuicOverride. See + the method description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. project (str): Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_https_proxies_set_quic_override_request_resource (google.cloud.compute_v1.types.TargetHttpsProxiesSetQuicOverrideRequest): + The body resource for this request + target_https_proxy (str): + Name of the TargetHttpsProxy resource to set + the QUIC override policy for. The name should + conform to RFC1035. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_https_proxies_set_quic_override_request_resource = proto.Field( + proto.MESSAGE, + number=72940258, + message="TargetHttpsProxiesSetQuicOverrideRequest", + ) + target_https_proxy = proto.Field(proto.STRING, number=52336748,) -class DeleteReservationRequest(proto.Message): - r"""A request message for Reservations.Delete. See the method +class SetSchedulingInstanceRequest(proto.Message): + r"""A request message for Instances.SetScheduling. See the method description for details. Attributes: + instance (str): + Instance name for this request. project (str): Project ID for this request. request_id (str): @@ -42838,75 +41906,120 @@ class DeleteReservationRequest(proto.Message): Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - reservation (str): - Name of the reservation to delete. + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + scheduling_resource (google.cloud.compute_v1.types.Scheduling): + The body resource for this request zone (str): - Name of the zone for this request. + The name of the zone for this request. """ + instance = proto.Field(proto.STRING, number=18257045,) project = proto.Field(proto.STRING, number=227560217,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - reservation = proto.Field(proto.STRING, number=47530956,) + scheduling_resource = proto.Field( + proto.MESSAGE, number=463181401, message="Scheduling", + ) zone = proto.Field(proto.STRING, number=3744684,) -class GetReservationRequest(proto.Message): - r"""A request message for Reservations.Get. See the method - description for details. +class SetSecurityPolicyBackendServiceRequest(proto.Message): + r"""A request message for BackendServices.SetSecurityPolicy. See + the method description for details. Attributes: + backend_service (str): + Name of the BackendService resource to which + the security policy should be set. The name + should conform to RFC1035. project (str): Project ID for this request. - reservation (str): - Name of the reservation to retrieve. - zone (str): - Name of the zone for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + security_policy_reference_resource (google.cloud.compute_v1.types.SecurityPolicyReference): + The body resource for this request """ + backend_service = proto.Field(proto.STRING, number=306946058,) project = proto.Field(proto.STRING, number=227560217,) - reservation = proto.Field(proto.STRING, number=47530956,) - zone = proto.Field(proto.STRING, number=3744684,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + security_policy_reference_resource = proto.Field( + proto.MESSAGE, number=204135024, message="SecurityPolicyReference", + ) -class GetIamPolicyReservationRequest(proto.Message): - r"""A request message for Reservations.GetIamPolicy. See the +class SetServiceAccountInstanceRequest(proto.Message): + r"""A request message for Instances.SetServiceAccount. See the method description for details. Attributes: - options_requested_policy_version (int): - Requested IAM Policy version. + instance (str): + Name of the instance resource to start. + instances_set_service_account_request_resource (google.cloud.compute_v1.types.InstancesSetServiceAccountRequest): + The body resource for this request project (str): Project ID for this request. - resource (str): - Name or id of the resource for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). zone (str): The name of the zone for this request. """ - options_requested_policy_version = proto.Field( - proto.INT32, number=499220029, optional=True, + instance = proto.Field(proto.STRING, number=18257045,) + instances_set_service_account_request_resource = proto.Field( + proto.MESSAGE, number=275550008, message="InstancesSetServiceAccountRequest", ) project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) zone = proto.Field(proto.STRING, number=3744684,) -class InsertReservationRequest(proto.Message): - r"""A request message for Reservations.Insert. See the method +class SetShieldedInstanceIntegrityPolicyInstanceRequest(proto.Message): + r"""A request message for + Instances.SetShieldedInstanceIntegrityPolicy. See the method description for details. Attributes: + instance (str): + Name or id of the instance scoping this + request. project (str): Project ID for this request. request_id (str): @@ -42914,109 +42027,117 @@ class InsertReservationRequest(proto.Message): Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - reservation_resource (google.cloud.compute_v1.types.Reservation): + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + shielded_instance_integrity_policy_resource (google.cloud.compute_v1.types.ShieldedInstanceIntegrityPolicy): The body resource for this request zone (str): - Name of the zone for this request. + The name of the zone for this request. """ + instance = proto.Field(proto.STRING, number=18257045,) project = proto.Field(proto.STRING, number=227560217,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - reservation_resource = proto.Field( - proto.MESSAGE, number=285030177, message="Reservation", + shielded_instance_integrity_policy_resource = proto.Field( + proto.MESSAGE, number=409169462, message="ShieldedInstanceIntegrityPolicy", ) zone = proto.Field(proto.STRING, number=3744684,) -class ListReservationsRequest(proto.Message): - r"""A request message for Reservations.List. See the method +class SetSslCertificatesRegionTargetHttpsProxyRequest(proto.Message): + r"""A request message for + RegionTargetHttpsProxies.SetSslCertificates. See the method description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + project (str): + Project ID for this request. + region (str): + Name of the region scoping this request. + region_target_https_proxies_set_ssl_certificates_request_resource (google.cloud.compute_v1.types.RegionTargetHttpsProxiesSetSslCertificatesRequest): + The body resource for this request + request_id (str): + An optional request ID to identify requests. Specify a + unique request ID so that if you must retry your request, + the server will know to ignore the request if it has already + been completed. For example, consider a situation where you + make an initial request and the request times out. If you + make the request again with the same request ID, the server + can check if original operation with the same request ID was + received, and if so, will ignore the second request. This + prevents clients from accidentally creating duplicate + commitments. The request ID must be a valid UUID with the + exception that zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). end_interface: + MixerMutationRequestBuilder + target_https_proxy (str): + Name of the TargetHttpsProxy resource to set + an SslCertificates resource for. + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) + region_target_https_proxies_set_ssl_certificates_request_resource = proto.Field( + proto.MESSAGE, + number=390693383, + message="RegionTargetHttpsProxiesSetSslCertificatesRequest", + ) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_https_proxy = proto.Field(proto.STRING, number=52336748,) - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. +class SetSslCertificatesTargetHttpsProxyRequest(proto.Message): + r"""A request message for TargetHttpsProxies.SetSslCertificates. + See the method description for details. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. + Attributes: project (str): Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. - zone (str): - Name of the zone for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_https_proxies_set_ssl_certificates_request_resource (google.cloud.compute_v1.types.TargetHttpsProxiesSetSslCertificatesRequest): + The body resource for this request + target_https_proxy (str): + Name of the TargetHttpsProxy resource to set + an SslCertificates resource for. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_https_proxies_set_ssl_certificates_request_resource = proto.Field( + proto.MESSAGE, + number=223122908, + message="TargetHttpsProxiesSetSslCertificatesRequest", + ) + target_https_proxy = proto.Field(proto.STRING, number=52336748,) -class ResizeReservationRequest(proto.Message): - r"""A request message for Reservations.Resize. See the method - description for details. +class SetSslCertificatesTargetSslProxyRequest(proto.Message): + r"""A request message for TargetSslProxies.SetSslCertificates. + See the method description for details. Attributes: project (str): @@ -43026,1082 +42147,1290 @@ class ResizeReservationRequest(proto.Message): Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - reservation (str): - Name of the reservation to update. - reservations_resize_request_resource (google.cloud.compute_v1.types.ReservationsResizeRequest): + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_ssl_proxies_set_ssl_certificates_request_resource (google.cloud.compute_v1.types.TargetSslProxiesSetSslCertificatesRequest): The body resource for this request - zone (str): - Name of the zone for this request. + target_ssl_proxy (str): + Name of the TargetSslProxy resource whose + SslCertificate resource is to be set. """ project = proto.Field(proto.STRING, number=227560217,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - reservation = proto.Field(proto.STRING, number=47530956,) - reservations_resize_request_resource = proto.Field( - proto.MESSAGE, number=389262801, message="ReservationsResizeRequest", + target_ssl_proxies_set_ssl_certificates_request_resource = proto.Field( + proto.MESSAGE, + number=147940797, + message="TargetSslProxiesSetSslCertificatesRequest", ) - zone = proto.Field(proto.STRING, number=3744684,) + target_ssl_proxy = proto.Field(proto.STRING, number=338795853,) -class SetIamPolicyReservationRequest(proto.Message): - r"""A request message for Reservations.SetIamPolicy. See the - method description for details. +class SetSslPolicyTargetHttpsProxyRequest(proto.Message): + r"""A request message for TargetHttpsProxies.SetSslPolicy. See + the method description for details. Attributes: project (str): Project ID for this request. - resource (str): - Name or id of the resource for this request. - zone (str): - The name of the zone for this request. - zone_set_policy_request_resource (google.cloud.compute_v1.types.ZoneSetPolicyRequest): + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + ssl_policy_reference_resource (google.cloud.compute_v1.types.SslPolicyReference): The body resource for this request + target_https_proxy (str): + Name of the TargetHttpsProxy resource whose + SSL policy is to be set. The name must be 1-63 + characters long, and comply with RFC1035. """ project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) - zone = proto.Field(proto.STRING, number=3744684,) - zone_set_policy_request_resource = proto.Field( - proto.MESSAGE, number=382082107, message="ZoneSetPolicyRequest", + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + ssl_policy_reference_resource = proto.Field( + proto.MESSAGE, number=235403836, message="SslPolicyReference", ) + target_https_proxy = proto.Field(proto.STRING, number=52336748,) -class TestIamPermissionsReservationRequest(proto.Message): - r"""A request message for Reservations.TestIamPermissions. See - the method description for details. +class SetSslPolicyTargetSslProxyRequest(proto.Message): + r"""A request message for TargetSslProxies.SetSslPolicy. See the + method description for details. Attributes: project (str): Project ID for this request. - resource (str): - Name or id of the resource for this request. - test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + ssl_policy_reference_resource (google.cloud.compute_v1.types.SslPolicyReference): The body resource for this request - zone (str): - The name of the zone for this request. + target_ssl_proxy (str): + Name of the TargetSslProxy resource whose SSL + policy is to be set. The name must be 1-63 + characters long, and comply with RFC1035. """ project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) - test_permissions_request_resource = proto.Field( - proto.MESSAGE, number=439214758, message="TestPermissionsRequest", + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + ssl_policy_reference_resource = proto.Field( + proto.MESSAGE, number=235403836, message="SslPolicyReference", ) - zone = proto.Field(proto.STRING, number=3744684,) + target_ssl_proxy = proto.Field(proto.STRING, number=338795853,) -class AggregatedListResourcePoliciesRequest(proto.Message): - r"""A request message for ResourcePolicies.AggregatedList. See - the method description for details. +class SetTagsInstanceRequest(proto.Message): + r"""A request message for Instances.SetTags. See the method + description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + instance (str): + Name of the instance scoping this request. + project (str): + Project ID for this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + tags_resource (google.cloud.compute_v1.types.Tags): + The body resource for this request + zone (str): + The name of the zone for this request. + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + instance = proto.Field(proto.STRING, number=18257045,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + tags_resource = proto.Field(proto.MESSAGE, number=331435380, message="Tags",) + zone = proto.Field(proto.STRING, number=3744684,) - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. +class SetTargetForwardingRuleRequest(proto.Message): + r"""A request message for ForwardingRules.SetTarget. See the + method description for details. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. + Attributes: + forwarding_rule (str): + Name of the ForwardingRule resource in which + target is to be set. project (str): Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + region (str): + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_reference_resource (google.cloud.compute_v1.types.TargetReference): + The body resource for this request """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + forwarding_rule = proto.Field(proto.STRING, number=269964030,) project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_reference_resource = proto.Field( + proto.MESSAGE, number=523721712, message="TargetReference", + ) -class DeleteResourcePolicyRequest(proto.Message): - r"""A request message for ResourcePolicies.Delete. See the method - description for details. +class SetTargetGlobalForwardingRuleRequest(proto.Message): + r"""A request message for GlobalForwardingRules.SetTarget. See + the method description for details. Attributes: + forwarding_rule (str): + Name of the ForwardingRule resource in which + target is to be set. project (str): Project ID for this request. - region (str): - Name of the region for this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - resource_policy (str): - Name of the resource policy to delete. + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_reference_resource (google.cloud.compute_v1.types.TargetReference): + The body resource for this request """ + forwarding_rule = proto.Field(proto.STRING, number=269964030,) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - resource_policy = proto.Field(proto.STRING, number=159240835,) + target_reference_resource = proto.Field( + proto.MESSAGE, number=523721712, message="TargetReference", + ) -class GetResourcePolicyRequest(proto.Message): - r"""A request message for ResourcePolicies.Get. See the method - description for details. +class SetTargetPoolsInstanceGroupManagerRequest(proto.Message): + r"""A request message for InstanceGroupManagers.SetTargetPools. + See the method description for details. Attributes: + instance_group_manager (str): + The name of the managed instance group. + instance_group_managers_set_target_pools_request_resource (google.cloud.compute_v1.types.InstanceGroupManagersSetTargetPoolsRequest): + The body resource for this request project (str): Project ID for this request. - region (str): - Name of the region for this request. - resource_policy (str): - Name of the resource policy to retrieve. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone where the managed + instance group is located. """ + instance_group_manager = proto.Field(proto.STRING, number=249363395,) + instance_group_managers_set_target_pools_request_resource = proto.Field( + proto.MESSAGE, + number=281150216, + message="InstanceGroupManagersSetTargetPoolsRequest", + ) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - resource_policy = proto.Field(proto.STRING, number=159240835,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class GetIamPolicyResourcePolicyRequest(proto.Message): - r"""A request message for ResourcePolicies.GetIamPolicy. See the - method description for details. +class SetTargetPoolsRegionInstanceGroupManagerRequest(proto.Message): + r"""A request message for + RegionInstanceGroupManagers.SetTargetPools. See the method + description for details. Attributes: - options_requested_policy_version (int): - Requested IAM Policy version. + instance_group_manager (str): + Name of the managed instance group. project (str): Project ID for this request. region (str): - The name of the region for this request. - resource (str): - Name or id of the resource for this request. + Name of the region scoping this request. + region_instance_group_managers_set_target_pools_request_resource (google.cloud.compute_v1.types.RegionInstanceGroupManagersSetTargetPoolsRequest): + The body resource for this request + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - options_requested_policy_version = proto.Field( - proto.INT32, number=499220029, optional=True, - ) + instance_group_manager = proto.Field(proto.STRING, number=249363395,) project = proto.Field(proto.STRING, number=227560217,) region = proto.Field(proto.STRING, number=138946292,) - resource = proto.Field(proto.STRING, number=195806222,) + region_instance_group_managers_set_target_pools_request_resource = proto.Field( + proto.MESSAGE, + number=78734717, + message="RegionInstanceGroupManagersSetTargetPoolsRequest", + ) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class InsertResourcePolicyRequest(proto.Message): - r"""A request message for ResourcePolicies.Insert. See the method - description for details. +class SetUrlMapRegionTargetHttpProxyRequest(proto.Message): + r"""A request message for RegionTargetHttpProxies.SetUrlMap. See + the method description for details. Attributes: project (str): Project ID for this request. region (str): - Name of the region for this request. + Name of the region scoping this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - resource_policy_resource (google.cloud.compute_v1.types.ResourcePolicy): + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_http_proxy (str): + Name of the TargetHttpProxy to set a URL map + for. + url_map_reference_resource (google.cloud.compute_v1.types.UrlMapReference): The body resource for this request """ project = proto.Field(proto.STRING, number=227560217,) region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - resource_policy_resource = proto.Field( - proto.MESSAGE, number=76826186, message="ResourcePolicy", + target_http_proxy = proto.Field(proto.STRING, number=206872421,) + url_map_reference_resource = proto.Field( + proto.MESSAGE, number=398701333, message="UrlMapReference", ) -class ListResourcePoliciesRequest(proto.Message): - r"""A request message for ResourcePolicies.List. See the method - description for details. +class SetUrlMapRegionTargetHttpsProxyRequest(proto.Message): + r"""A request message for RegionTargetHttpsProxies.SetUrlMap. See + the method description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. project (str): Project ID for this request. region (str): - Name of the region for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + Name of the region scoping this request. + request_id (str): + An optional request ID to identify requests. Specify a + unique request ID so that if you must retry your request, + the server will know to ignore the request if it has already + been completed. For example, consider a situation where you + make an initial request and the request times out. If you + make the request again with the same request ID, the server + can check if original operation with the same request ID was + received, and if so, will ignore the second request. This + prevents clients from accidentally creating duplicate + commitments. The request ID must be a valid UUID with the + exception that zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). end_interface: + MixerMutationRequestBuilder + target_https_proxy (str): + Name of the TargetHttpsProxy to set a URL map + for. + url_map_reference_resource (google.cloud.compute_v1.types.UrlMapReference): + The body resource for this request """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_https_proxy = proto.Field(proto.STRING, number=52336748,) + url_map_reference_resource = proto.Field( + proto.MESSAGE, number=398701333, message="UrlMapReference", + ) -class SetIamPolicyResourcePolicyRequest(proto.Message): - r"""A request message for ResourcePolicies.SetIamPolicy. See the +class SetUrlMapTargetHttpProxyRequest(proto.Message): + r"""A request message for TargetHttpProxies.SetUrlMap. See the method description for details. Attributes: project (str): Project ID for this request. - region (str): - The name of the region for this request. - region_set_policy_request_resource (google.cloud.compute_v1.types.RegionSetPolicyRequest): + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_http_proxy (str): + Name of the TargetHttpProxy to set a URL map + for. + url_map_reference_resource (google.cloud.compute_v1.types.UrlMapReference): The body resource for this request - resource (str): - Name or id of the resource for this request. """ project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - region_set_policy_request_resource = proto.Field( - proto.MESSAGE, number=276489091, message="RegionSetPolicyRequest", + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_http_proxy = proto.Field(proto.STRING, number=206872421,) + url_map_reference_resource = proto.Field( + proto.MESSAGE, number=398701333, message="UrlMapReference", ) - resource = proto.Field(proto.STRING, number=195806222,) -class TestIamPermissionsResourcePolicyRequest(proto.Message): - r"""A request message for ResourcePolicies.TestIamPermissions. - See the method description for details. +class SetUrlMapTargetHttpsProxyRequest(proto.Message): + r"""A request message for TargetHttpsProxies.SetUrlMap. See the + method description for details. Attributes: project (str): Project ID for this request. - region (str): - The name of the region for this request. - resource (str): - Name or id of the resource for this request. - test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + target_https_proxy (str): + Name of the TargetHttpsProxy resource whose + URL map is to be set. + url_map_reference_resource (google.cloud.compute_v1.types.UrlMapReference): The body resource for this request """ project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - resource = proto.Field(proto.STRING, number=195806222,) - test_permissions_request_resource = proto.Field( - proto.MESSAGE, number=439214758, message="TestPermissionsRequest", + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + target_https_proxy = proto.Field(proto.STRING, number=52336748,) + url_map_reference_resource = proto.Field( + proto.MESSAGE, number=398701333, message="UrlMapReference", ) -class AggregatedListRoutersRequest(proto.Message): - r"""A request message for Routers.AggregatedList. See the method - description for details. - - Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. - """ - - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - - -class DeleteRouterRequest(proto.Message): - r"""A request message for Routers.Delete. See the method - description for details. +class SetUsageExportBucketProjectRequest(proto.Message): + r"""A request message for Projects.SetUsageExportBucket. See the + method description for details. Attributes: project (str): Project ID for this request. - region (str): - Name of the region for this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - router (str): - Name of the Router resource to delete. + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + usage_export_location_resource (google.cloud.compute_v1.types.UsageExportLocation): + The body resource for this request """ project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - router = proto.Field(proto.STRING, number=148608841,) - + usage_export_location_resource = proto.Field( + proto.MESSAGE, number=20260459, message="UsageExportLocation", + ) -class GetRouterRequest(proto.Message): - r"""A request message for Routers.Get. See the method description - for details. +class ShieldedInstanceConfig(proto.Message): + r"""A set of Shielded Instance options. Attributes: - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - router (str): - Name of the Router resource to return. + enable_integrity_monitoring (bool): + Defines whether the instance has integrity + monitoring enabled. Enabled by default. + enable_secure_boot (bool): + Defines whether the instance has Secure Boot + enabled. Disabled by default. + enable_vtpm (bool): + Defines whether the instance has the vTPM + enabled. Enabled by default. """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - router = proto.Field(proto.STRING, number=148608841,) - + enable_integrity_monitoring = proto.Field( + proto.BOOL, number=409071030, optional=True, + ) + enable_secure_boot = proto.Field(proto.BOOL, number=123568638, optional=True,) + enable_vtpm = proto.Field(proto.BOOL, number=181858935, optional=True,) -class GetNatMappingInfoRoutersRequest(proto.Message): - r"""A request message for Routers.GetNatMappingInfo. See the - method description for details. +class ShieldedInstanceIdentity(proto.Message): + r"""A Shielded Instance Identity. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. - router (str): - Name of the Router resource to query for Nat - Mapping information of VM endpoints. + encryption_key (google.cloud.compute_v1.types.ShieldedInstanceIdentityEntry): + An Endorsement Key (EK) made by the RSA 2048 + algorithm issued to the Shielded Instance's + vTPM. + kind (str): + [Output Only] Type of the resource. Always + compute#shieldedInstanceIdentity for shielded Instance + identity entry. + signing_key (google.cloud.compute_v1.types.ShieldedInstanceIdentityEntry): + An Attestation Key (AK) made by the RSA 2048 + algorithm issued to the Shielded Instance's + vTPM. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - router = proto.Field(proto.STRING, number=148608841,) - + encryption_key = proto.Field( + proto.MESSAGE, + number=488268707, + optional=True, + message="ShieldedInstanceIdentityEntry", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + signing_key = proto.Field( + proto.MESSAGE, + number=320948261, + optional=True, + message="ShieldedInstanceIdentityEntry", + ) -class GetRouterStatusRouterRequest(proto.Message): - r"""A request message for Routers.GetRouterStatus. See the method - description for details. +class ShieldedInstanceIdentityEntry(proto.Message): + r"""A Shielded Instance Identity Entry. Attributes: - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - router (str): - Name of the Router resource to query. + ek_cert (str): + A PEM-encoded X.509 certificate. This field + can be empty. + ek_pub (str): + A PEM-encoded public key. """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - router = proto.Field(proto.STRING, number=148608841,) + ek_cert = proto.Field(proto.STRING, number=450178589, optional=True,) + ek_pub = proto.Field(proto.STRING, number=308947940, optional=True,) -class InsertRouterRequest(proto.Message): - r"""A request message for Routers.Insert. See the method - description for details. +class ShieldedInstanceIntegrityPolicy(proto.Message): + r"""The policy describes the baseline against which Instance boot + integrity is measured. Attributes: - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - router_resource (google.cloud.compute_v1.types.Router): - The body resource for this request + update_auto_learn_policy (bool): + Updates the integrity policy baseline using + the measurements from the VM instance's most + recent boot. """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - router_resource = proto.Field(proto.MESSAGE, number=155222084, message="Router",) + update_auto_learn_policy = proto.Field(proto.BOOL, number=245490215, optional=True,) -class ListRoutersRequest(proto.Message): - r"""A request message for Routers.List. See the method - description for details. +class SignedUrlKey(proto.Message): + r"""Represents a customer-supplied Signing Key used by Cloud CDN + Signed URLs Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + key_name (str): + Name of the key. The name must be 1-63 characters long, and + comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. + key_value (str): + 128-bit key value used for signing the URL. + The key value must be a valid RFC 4648 Section 5 + base64url encoded string. + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + key_name = proto.Field(proto.STRING, number=500938859, optional=True,) + key_value = proto.Field(proto.STRING, number=504106897, optional=True,) - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. +class SimulateMaintenanceEventInstanceRequest(proto.Message): + r"""A request message for Instances.SimulateMaintenanceEvent. See + the method description for details. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. + Attributes: + instance (str): + Name of the instance scoping this request. project (str): Project ID for this request. - region (str): - Name of the region for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + zone (str): + The name of the zone for this request. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + instance = proto.Field(proto.STRING, number=18257045,) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class PatchRouterRequest(proto.Message): - r"""A request message for Routers.Patch. See the method - description for details. +class Snapshot(proto.Message): + r"""Represents a Persistent Disk Snapshot resource. You can use + snapshots to back up data on a regular interval. For more + information, read Creating persistent disk snapshots. Attributes: - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - router (str): - Name of the Router resource to patch. - router_resource (google.cloud.compute_v1.types.Router): - The body resource for this request + auto_created (bool): + [Output Only] Set to true if snapshots are automatically + created by applying resource policy on the target disk. + chain_name (str): + Creates the new snapshot in the snapshot + chain labeled with the specified name. The chain + name must be 1-63 characters long and comply + with RFC1035. This is an uncommon option only + for advanced service owners who needs to create + separate snapshot chains, for example, for + chargeback tracking. When you describe your + snapshot resource, this field is visible only if + it has a non-empty value. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + disk_size_gb (int): + [Output Only] Size of the source disk, specified in GB. + download_bytes (int): + [Output Only] Number of bytes downloaded to restore a + snapshot to a disk. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + kind (str): + [Output Only] Type of the resource. Always compute#snapshot + for Snapshot resources. + label_fingerprint (str): + A fingerprint for the labels being applied to + this snapshot, which is essentially a hash of + the labels set used for optimistic locking. The + fingerprint is initially generated by Compute + Engine and changes after every request to modify + or update labels. You must always provide an up- + to-date fingerprint hash in order to update or + change labels, otherwise the request will fail + with error 412 conditionNotMet. To see the + latest fingerprint, make a get() request to + retrieve a snapshot. + labels (Sequence[google.cloud.compute_v1.types.Snapshot.LabelsEntry]): + Labels to apply to this snapshot. These can + be later modified by the setLabels method. Label + values may be empty. + license_codes (Sequence[int]): + [Output Only] Integer license codes indicating which + licenses are attached to this snapshot. + licenses (Sequence[str]): + [Output Only] A list of public visible licenses that apply + to this snapshot. This can be because the original image had + licenses attached (such as a Windows image). + location_hint (str): + An opaque location hint used to place the + snapshot close to other resources. This field is + for use by internal tools that use the public + API. + name (str): + Name of the resource; provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. + satisfies_pzs (bool): + [Output Only] Reserved for future use. + self_link (str): + [Output Only] Server-defined URL for the resource. + snapshot_encryption_key (google.cloud.compute_v1.types.CustomerEncryptionKey): + Encrypts the snapshot using a customer- + upplied encryption key. After you encrypt a + snapshot using a customer-supplied key, you must + provide the same key if you use the snapshot + later. For example, you must provide the + encryption key when you create a disk from the + encrypted snapshot in a future request. + Customer-supplied encryption keys do not protect + access to metadata of the snapshot. If you do + not provide an encryption key when creating the + snapshot, then the snapshot will be encrypted + using an automatically generated key and you do + not need to provide a key to use the snapshot + later. + source_disk (str): + The source disk used to create this snapshot. + source_disk_encryption_key (google.cloud.compute_v1.types.CustomerEncryptionKey): + The customer-supplied encryption key of the + source disk. Required if the source disk is + protected by a customer-supplied encryption key. + source_disk_id (str): + [Output Only] The ID value of the disk used to create this + snapshot. This value may be used to determine whether the + snapshot was taken from the current or a previous instance + of a given disk name. + status (google.cloud.compute_v1.types.Snapshot.Status): + [Output Only] The status of the snapshot. This can be + CREATING, DELETING, FAILED, READY, or UPLOADING. + storage_bytes (int): + [Output Only] A size of the storage used by the snapshot. As + snapshots share storage, this number is expected to change + with snapshot creation/deletion. + storage_bytes_status (google.cloud.compute_v1.types.Snapshot.StorageBytesStatus): + [Output Only] An indicator whether storageBytes is in a + stable state or it is being adjusted as a result of shared + storage reallocation. This status can either be UPDATING, + meaning the size of the snapshot is being updated, or + UP_TO_DATE, meaning the size of the snapshot is up-to-date. + storage_locations (Sequence[str]): + Cloud Storage bucket storage location of the + snapshot (regional or multi-regional). """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - router = proto.Field(proto.STRING, number=148608841,) - router_resource = proto.Field(proto.MESSAGE, number=155222084, message="Router",) + class Status(proto.Enum): + r"""[Output Only] The status of the snapshot. This can be CREATING, + DELETING, FAILED, READY, or UPLOADING. + """ + UNDEFINED_STATUS = 0 + CREATING = 455564985 + DELETING = 528602024 + FAILED = 455706685 + READY = 77848963 + UPLOADING = 267603489 + + class StorageBytesStatus(proto.Enum): + r"""[Output Only] An indicator whether storageBytes is in a stable state + or it is being adjusted as a result of shared storage reallocation. + This status can either be UPDATING, meaning the size of the snapshot + is being updated, or UP_TO_DATE, meaning the size of the snapshot is + up-to-date. + """ + UNDEFINED_STORAGE_BYTES_STATUS = 0 + UPDATING = 494614342 + UP_TO_DATE = 101306702 + auto_created = proto.Field(proto.BOOL, number=463922264, optional=True,) + chain_name = proto.Field(proto.STRING, number=68644169, optional=True,) + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + disk_size_gb = proto.Field(proto.INT64, number=316263735, optional=True,) + download_bytes = proto.Field(proto.INT64, number=435054068, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + label_fingerprint = proto.Field(proto.STRING, number=178124825, optional=True,) + labels = proto.MapField(proto.STRING, proto.STRING, number=500195327,) + license_codes = proto.RepeatedField(proto.INT64, number=45482664,) + licenses = proto.RepeatedField(proto.STRING, number=337642578,) + location_hint = proto.Field(proto.STRING, number=350519505, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + satisfies_pzs = proto.Field(proto.BOOL, number=480964267, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + snapshot_encryption_key = proto.Field( + proto.MESSAGE, number=43334526, optional=True, message="CustomerEncryptionKey", + ) + source_disk = proto.Field(proto.STRING, number=451753793, optional=True,) + source_disk_encryption_key = proto.Field( + proto.MESSAGE, number=531501153, optional=True, message="CustomerEncryptionKey", + ) + source_disk_id = proto.Field(proto.STRING, number=454190809, optional=True,) + status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) + storage_bytes = proto.Field(proto.INT64, number=424631719, optional=True,) + storage_bytes_status = proto.Field( + proto.ENUM, number=490739082, optional=True, enum=StorageBytesStatus, + ) + storage_locations = proto.RepeatedField(proto.STRING, number=328005274,) -class PreviewRouterRequest(proto.Message): - r"""A request message for Routers.Preview. See the method - description for details. +class SnapshotList(proto.Message): + r"""Contains a list of Snapshot resources. Attributes: - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - router (str): - Name of the Router resource to query. - router_resource (google.cloud.compute_v1.types.Router): - The body resource for this request + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.Snapshot]): + A list of Snapshot resources. + kind (str): + Type of resource. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - router = proto.Field(proto.STRING, number=148608841,) - router_resource = proto.Field(proto.MESSAGE, number=155222084, message="Router",) + @property + def raw_page(self): + return self + + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Snapshot",) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class UpdateRouterRequest(proto.Message): - r"""A request message for Routers.Update. See the method - description for details. +class SourceInstanceParams(proto.Message): + r"""A specification of the parameters to use when creating the + instance template from a source instance. Attributes: - project (str): - Project ID for this request. + disk_configs (Sequence[google.cloud.compute_v1.types.DiskInstantiationConfig]): + Attached disks configuration. If not + provided, defaults are applied: For boot disk + and any other R/W disks, new custom images will + be created from each disk. For read-only disks, + they will be attached in read-only mode. Local + SSD disks will be created as blank volumes. + """ + + disk_configs = proto.RepeatedField( + proto.MESSAGE, number=235580623, message="DiskInstantiationConfig", + ) + + +class SslCertificate(proto.Message): + r"""Represents an SSL Certificate resource. Google Compute Engine has + two SSL Certificate resources: \* + `Global `__ \* + `Regional `__ + The sslCertificates are used by: - external HTTPS load balancers - + SSL proxy load balancers The regionSslCertificates are used by + internal HTTPS load balancers. Optionally, certificate file contents + that you upload can contain a set of up to five PEM-encoded + certificates. The API call creates an object (sslCertificate) that + holds this data. You can use SSL keys and certificates to secure + connections to a load balancer. For more information, read Creating + and using SSL certificates, SSL certificates quotas and limits, and + Troubleshooting SSL certificates. + + Attributes: + certificate (str): + A value read into memory from a certificate + file. The certificate file must be in PEM + format. The certificate chain must be no greater + than 5 certs long. The chain must include at + least one intermediate cert. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + expire_time (str): + [Output Only] Expire time of the certificate. RFC3339 + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + kind (str): + [Output Only] Type of the resource. Always + compute#sslCertificate for SSL certificates. + managed (google.cloud.compute_v1.types.SslCertificateManagedSslCertificate): + Configuration and status of a managed SSL + certificate. + name (str): + Name of the resource. Provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. + private_key (str): + A value read into memory from a write-only + private key file. The private key file must be + in PEM format. For security, only insert + requests include this field. region (str): - Name of the region for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - router (str): - Name of the Router resource to update. - router_resource (google.cloud.compute_v1.types.Router): - The body resource for this request + [Output Only] URL of the region where the regional SSL + Certificate resides. This field is not applicable to global + SSL Certificate. + self_link (str): + [Output only] Server-defined URL for the resource. + self_managed (google.cloud.compute_v1.types.SslCertificateSelfManagedSslCertificate): + Configuration and status of a self-managed + SSL certificate. + subject_alternative_names (Sequence[str]): + [Output Only] Domains associated with the certificate via + Subject Alternative Name. + type_ (google.cloud.compute_v1.types.SslCertificate.Type): + (Optional) Specifies the type of SSL certificate, either + "SELF_MANAGED" or "MANAGED". If not specified, the + certificate is self-managed and the fields certificate and + private_key are used. """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - router = proto.Field(proto.STRING, number=148608841,) - router_resource = proto.Field(proto.MESSAGE, number=155222084, message="Router",) + class Type(proto.Enum): + r"""(Optional) Specifies the type of SSL certificate, either + "SELF_MANAGED" or "MANAGED". If not specified, the certificate is + self-managed and the fields certificate and private_key are used. + """ + UNDEFINED_TYPE = 0 + MANAGED = 479501183 + SELF_MANAGED = 434437516 + TYPE_UNSPECIFIED = 437714322 + certificate = proto.Field(proto.STRING, number=341787031, optional=True,) + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + expire_time = proto.Field(proto.STRING, number=440691181, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + managed = proto.Field( + proto.MESSAGE, + number=298389407, + optional=True, + message="SslCertificateManagedSslCertificate", + ) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + private_key = proto.Field(proto.STRING, number=361331107, optional=True,) + region = proto.Field(proto.STRING, number=138946292, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + self_managed = proto.Field( + proto.MESSAGE, + number=329284012, + optional=True, + message="SslCertificateSelfManagedSslCertificate", + ) + subject_alternative_names = proto.RepeatedField(proto.STRING, number=528807907,) + type_ = proto.Field(proto.ENUM, number=3575610, optional=True, enum=Type,) -class DeleteRouteRequest(proto.Message): - r"""A request message for Routes.Delete. See the method - description for details. +class SslCertificateAggregatedList(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - route (str): - Name of the Route resource to delete. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.SslCertificateAggregatedList.ItemsEntry]): + A list of SslCertificatesScopedList + resources. + kind (str): + [Output Only] Type of resource. Always + compute#sslCertificateAggregatedList for lists of SSL + Certificates. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - route = proto.Field(proto.STRING, number=108704329,) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.MapField( + proto.STRING, + proto.MESSAGE, + number=100526016, + message="SslCertificatesScopedList", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class GetRouteRequest(proto.Message): - r"""A request message for Routes.Get. See the method description - for details. +class SslCertificateList(proto.Message): + r"""Contains a list of SslCertificate resources. Attributes: - project (str): - Project ID for this request. - route (str): - Name of the Route resource to return. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.SslCertificate]): + A list of SslCertificate resources. + kind (str): + Type of resource. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - project = proto.Field(proto.STRING, number=227560217,) - route = proto.Field(proto.STRING, number=108704329,) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="SslCertificate", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class InsertRouteRequest(proto.Message): - r"""A request message for Routes.Insert. See the method - description for details. +class SslCertificateManagedSslCertificate(proto.Message): + r"""Configuration and status of a managed SSL certificate. Attributes: - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - route_resource (google.cloud.compute_v1.types.Route): - The body resource for this request + domain_status (Sequence[google.cloud.compute_v1.types.SslCertificateManagedSslCertificate.DomainStatusEntry]): + [Output only] Detailed statuses of the domains specified for + managed certificate resource. + domains (Sequence[str]): + The domains for which a managed SSL certificate will be + generated. Each Google-managed SSL certificate supports up + to the `maximum number of domains per Google-managed SSL + certificate `__. + status (google.cloud.compute_v1.types.SslCertificateManagedSslCertificate.Status): + [Output only] Status of the managed certificate resource. """ - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - route_resource = proto.Field(proto.MESSAGE, number=225428804, message="Route",) + class Status(proto.Enum): + r"""[Output only] Status of the managed certificate resource.""" + UNDEFINED_STATUS = 0 + ACTIVE = 314733318 + MANAGED_CERTIFICATE_STATUS_UNSPECIFIED = 474800850 + PROVISIONING = 290896621 + PROVISIONING_FAILED = 76813775 + PROVISIONING_FAILED_PERMANENTLY = 275036203 + RENEWAL_FAILED = 434659076 + domain_status = proto.MapField(proto.STRING, proto.STRING, number=360305613,) + domains = proto.RepeatedField(proto.STRING, number=226935855,) + status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) -class ListRoutesRequest(proto.Message): - r"""A request message for Routes.List. See the method description - for details. +class SslCertificateSelfManagedSslCertificate(proto.Message): + r"""Configuration and status of a self-managed SSL certificate. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + certificate (str): + A local certificate file. The certificate + must be in PEM format. The certificate chain + must be no greater than 5 certs long. The chain + must include at least one intermediate cert. + private_key (str): + A write-only private key in PEM format. Only + insert requests will include this field. + """ - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. + certificate = proto.Field(proto.STRING, number=341787031, optional=True,) + private_key = proto.Field(proto.STRING, number=361331107, optional=True,) - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. +class SslCertificatesScopedList(proto.Message): + r""" + Attributes: + ssl_certificates (Sequence[google.cloud.compute_v1.types.SslCertificate]): + List of SslCertificates contained in this + scope. + warning (google.cloud.compute_v1.types.Warning): + Informational warning which replaces the list + of backend services when the list is empty. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - + ssl_certificates = proto.RepeatedField( + proto.MESSAGE, number=366006543, message="SslCertificate", + ) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class AddRuleSecurityPolicyRequest(proto.Message): - r"""A request message for SecurityPolicies.AddRule. See the - method description for details. +class SslPoliciesList(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - security_policy (str): - Name of the security policy to update. - security_policy_rule_resource (google.cloud.compute_v1.types.SecurityPolicyRule): - The body resource for this request + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.SslPolicy]): + A list of SslPolicy resources. + kind (str): + [Output Only] Type of the resource. Always + compute#sslPoliciesList for lists of sslPolicies. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - project = proto.Field(proto.STRING, number=227560217,) - security_policy = proto.Field(proto.STRING, number=171082513,) - security_policy_rule_resource = proto.Field( - proto.MESSAGE, number=402693443, message="SecurityPolicyRule", - ) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="SslPolicy",) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class DeleteSecurityPolicyRequest(proto.Message): - r"""A request message for SecurityPolicies.Delete. See the method - description for details. +class SslPoliciesListAvailableFeaturesResponse(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - security_policy (str): - Name of the security policy to delete. + features (Sequence[str]): + """ - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - security_policy = proto.Field(proto.STRING, number=171082513,) + features = proto.RepeatedField(proto.STRING, number=246211645,) -class GetSecurityPolicyRequest(proto.Message): - r"""A request message for SecurityPolicies.Get. See the method - description for details. +class SslPolicy(proto.Message): + r"""Represents an SSL Policy resource. Use SSL policies to + control the SSL features, such as versions and cipher suites, + offered by an HTTPS or SSL Proxy load balancer. For more + information, read SSL Policy Concepts. Attributes: - project (str): - Project ID for this request. - security_policy (str): - Name of the security policy to get. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + custom_features (Sequence[str]): + A list of features enabled when the selected + profile is CUSTOM. The method returns the set of + features that can be specified in this list. + This field must be empty if the profile is not + CUSTOM. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + enabled_features (Sequence[str]): + [Output Only] The list of features enabled in the SSL + policy. + fingerprint (str): + Fingerprint of this resource. A hash of the + contents stored in this object. This field is + used in optimistic locking. This field will be + ignored when inserting a SslPolicy. An up-to- + date fingerprint must be provided in order to + update the SslPolicy, otherwise the request will + fail with error 412 conditionNotMet. To see the + latest fingerprint, make a get() request to + retrieve an SslPolicy. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + kind (str): + [Output only] Type of the resource. Always + compute#sslPolicyfor SSL policies. + min_tls_version (google.cloud.compute_v1.types.SslPolicy.MinTlsVersion): + The minimum version of SSL protocol that can be used by the + clients to establish a connection with the load balancer. + This can be one of TLS_1_0, TLS_1_1, TLS_1_2. + name (str): + Name of the resource. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. + profile (google.cloud.compute_v1.types.SslPolicy.Profile): + Profile specifies the set of SSL features + that can be used by the load balancer when + negotiating SSL with clients. This can be one of + COMPATIBLE, MODERN, RESTRICTED, or CUSTOM. If + using CUSTOM, the set of SSL features to enable + must be specified in the customFeatures field. + self_link (str): + [Output Only] Server-defined URL for the resource. + warnings (Sequence[google.cloud.compute_v1.types.Warnings]): + [Output Only] If potential misconfigurations are detected + for this SSL policy, this field will be populated with + warning messages. """ - project = proto.Field(proto.STRING, number=227560217,) - security_policy = proto.Field(proto.STRING, number=171082513,) + class MinTlsVersion(proto.Enum): + r"""The minimum version of SSL protocol that can be used by the clients + to establish a connection with the load balancer. This can be one of + TLS_1_0, TLS_1_1, TLS_1_2. + """ + UNDEFINED_MIN_TLS_VERSION = 0 + TLS_1_0 = 33116734 + TLS_1_1 = 33116735 + TLS_1_2 = 33116736 + class Profile(proto.Enum): + r"""Profile specifies the set of SSL features that can be used by + the load balancer when negotiating SSL with clients. This can be + one of COMPATIBLE, MODERN, RESTRICTED, or CUSTOM. If using + CUSTOM, the set of SSL features to enable must be specified in + the customFeatures field. + """ + UNDEFINED_PROFILE = 0 + COMPATIBLE = 179357396 + CUSTOM = 388595569 + MODERN = 132013855 + RESTRICTED = 261551195 + + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + custom_features = proto.RepeatedField(proto.STRING, number=34789707,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + enabled_features = proto.RepeatedField(proto.STRING, number=469017467,) + fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + min_tls_version = proto.Field( + proto.ENUM, number=8155943, optional=True, enum=MinTlsVersion, + ) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + profile = proto.Field(proto.ENUM, number=227445161, optional=True, enum=Profile,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warnings = proto.RepeatedField(proto.MESSAGE, number=498091095, message="Warnings",) -class GetRuleSecurityPolicyRequest(proto.Message): - r"""A request message for SecurityPolicies.GetRule. See the - method description for details. +class SslPolicyReference(proto.Message): + r""" Attributes: - priority (int): - The priority of the rule to get from the - security policy. - project (str): - Project ID for this request. - security_policy (str): - Name of the security policy to which the - queried rule belongs. + ssl_policy (str): + URL of the SSL policy resource. Set this to + empty string to clear any existing SSL policy + associated with the target proxy resource. """ - priority = proto.Field(proto.INT32, number=445151652, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - security_policy = proto.Field(proto.STRING, number=171082513,) + ssl_policy = proto.Field(proto.STRING, number=295190213, optional=True,) -class InsertSecurityPolicyRequest(proto.Message): - r"""A request message for SecurityPolicies.Insert. See the method +class StartInstanceRequest(proto.Message): + r"""A request message for Instances.Start. See the method description for details. Attributes: + instance (str): + Name of the instance resource to start. project (str): Project ID for this request. request_id (str): @@ -44109,178 +43438,36 @@ class InsertSecurityPolicyRequest(proto.Message): Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - security_policy_resource (google.cloud.compute_v1.types.SecurityPolicy): - The body resource for this request + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. """ + instance = proto.Field(proto.STRING, number=18257045,) project = proto.Field(proto.STRING, number=227560217,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - security_policy_resource = proto.Field( - proto.MESSAGE, number=216159612, message="SecurityPolicy", - ) - - -class ListSecurityPoliciesRequest(proto.Message): - r"""A request message for SecurityPolicies.List. See the method - description for details. - - Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. - """ - - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - - -class ListPreconfiguredExpressionSetsSecurityPoliciesRequest(proto.Message): - r"""A request message for - SecurityPolicies.ListPreconfiguredExpressionSets. See the method - description for details. - - Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. - """ - - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class PatchSecurityPolicyRequest(proto.Message): - r"""A request message for SecurityPolicies.Patch. See the method - description for details. +class StartWithEncryptionKeyInstanceRequest(proto.Message): + r"""A request message for Instances.StartWithEncryptionKey. See + the method description for details. Attributes: + instance (str): + Name of the instance resource to start. + instances_start_with_encryption_key_request_resource (google.cloud.compute_v1.types.InstancesStartWithEncryptionKeyRequest): + The body resource for this request project (str): Project ID for this request. request_id (str): @@ -44288,78 +43475,100 @@ class PatchSecurityPolicyRequest(proto.Message): Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - security_policy (str): - Name of the security policy to update. - security_policy_resource (google.cloud.compute_v1.types.SecurityPolicy): - The body resource for this request + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. """ + instance = proto.Field(proto.STRING, number=18257045,) + instances_start_with_encryption_key_request_resource = proto.Field( + proto.MESSAGE, + number=441712511, + message="InstancesStartWithEncryptionKeyRequest", + ) project = proto.Field(proto.STRING, number=227560217,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - security_policy = proto.Field(proto.STRING, number=171082513,) - security_policy_resource = proto.Field( - proto.MESSAGE, number=216159612, message="SecurityPolicy", - ) - + zone = proto.Field(proto.STRING, number=3744684,) -class PatchRuleSecurityPolicyRequest(proto.Message): - r"""A request message for SecurityPolicies.PatchRule. See the - method description for details. +class StatefulPolicy(proto.Message): + r""" Attributes: - priority (int): - The priority of the rule to patch. - project (str): - Project ID for this request. - security_policy (str): - Name of the security policy to update. - security_policy_rule_resource (google.cloud.compute_v1.types.SecurityPolicyRule): - The body resource for this request + preserved_state (google.cloud.compute_v1.types.StatefulPolicyPreservedState): + """ - priority = proto.Field(proto.INT32, number=445151652, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - security_policy = proto.Field(proto.STRING, number=171082513,) - security_policy_rule_resource = proto.Field( - proto.MESSAGE, number=402693443, message="SecurityPolicyRule", + preserved_state = proto.Field( + proto.MESSAGE, + number=2634026, + optional=True, + message="StatefulPolicyPreservedState", ) -class RemoveRuleSecurityPolicyRequest(proto.Message): - r"""A request message for SecurityPolicies.RemoveRule. See the - method description for details. +class StatefulPolicyPreservedState(proto.Message): + r"""Configuration of preserved resources. + Attributes: + disks (Sequence[google.cloud.compute_v1.types.StatefulPolicyPreservedState.DisksEntry]): + Disks created on the instances that will be + preserved on instance delete, update, etc. This + map is keyed with the device names of the disks. + """ + + disks = proto.MapField( + proto.STRING, + proto.MESSAGE, + number=95594102, + message="StatefulPolicyPreservedStateDiskDevice", + ) + +class StatefulPolicyPreservedStateDiskDevice(proto.Message): + r""" Attributes: - priority (int): - The priority of the rule to remove from the - security policy. - project (str): - Project ID for this request. - security_policy (str): - Name of the security policy to update. + auto_delete (google.cloud.compute_v1.types.StatefulPolicyPreservedStateDiskDevice.AutoDelete): + These stateful disks will never be deleted during + autohealing, update or VM instance recreate operations. This + flag is used to configure if the disk should be deleted + after it is no longer used by the group, e.g. when the given + instance or the whole group is deleted. Note: disks attached + in READ_ONLY mode cannot be auto-deleted. """ - priority = proto.Field(proto.INT32, number=445151652, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - security_policy = proto.Field(proto.STRING, number=171082513,) + class AutoDelete(proto.Enum): + r"""These stateful disks will never be deleted during autohealing, + update or VM instance recreate operations. This flag is used to + configure if the disk should be deleted after it is no longer used + by the group, e.g. when the given instance or the whole group is + deleted. Note: disks attached in READ_ONLY mode cannot be + auto-deleted. + """ + UNDEFINED_AUTO_DELETE = 0 + NEVER = 74175084 + ON_PERMANENT_INSTANCE_DELETION = 95727719 + auto_delete = proto.Field( + proto.ENUM, number=464761403, optional=True, enum=AutoDelete, + ) -class DeleteSnapshotRequest(proto.Message): - r"""A request message for Snapshots.Delete. See the method + +class StopInstanceRequest(proto.Message): + r"""A request message for Instances.Stop. See the method description for details. Attributes: + instance (str): + Name of the instance resource to stop. project (str): Project ID for this request. request_id (str): @@ -44367,282 +43576,523 @@ class DeleteSnapshotRequest(proto.Message): Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - snapshot (str): - Name of the Snapshot resource to delete. + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. """ + instance = proto.Field(proto.STRING, number=18257045,) project = proto.Field(proto.STRING, number=227560217,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - snapshot = proto.Field(proto.STRING, number=284874180,) + zone = proto.Field(proto.STRING, number=3744684,) -class GetSnapshotRequest(proto.Message): - r"""A request message for Snapshots.Get. See the method - description for details. +class Subnetwork(proto.Message): + r"""Represents a Subnetwork resource. A subnetwork (also known as + a subnet) is a logical partition of a Virtual Private Cloud + network with one primary IP range and zero or more secondary IP + ranges. For more information, read Virtual Private Cloud (VPC) + Network. Attributes: - project (str): - Project ID for this request. - snapshot (str): - Name of the Snapshot resource to return. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. This field can be set only at resource + creation time. + enable_flow_logs (bool): + Whether to enable flow logging for this subnetwork. If this + field is not explicitly set, it will not appear in get + listings. If not set the default behavior is to disable flow + logging. This field isn't supported with the purpose field + set to INTERNAL_HTTPS_LOAD_BALANCER. + external_ipv6_prefix (str): + [Output Only] The range of external IPv6 addresses that are + owned by this subnetwork. + fingerprint (str): + Fingerprint of this resource. A hash of the + contents stored in this object. This field is + used in optimistic locking. This field will be + ignored when inserting a Subnetwork. An up-to- + date fingerprint must be provided in order to + update the Subnetwork, otherwise the request + will fail with error 412 conditionNotMet. To see + the latest fingerprint, make a get() request to + retrieve a Subnetwork. + gateway_address (str): + [Output Only] The gateway address for default routes to + reach destination addresses outside this subnetwork. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + ip_cidr_range (str): + The range of internal addresses that are + owned by this subnetwork. Provide this property + when you create the subnetwork. For example, + 10.0.0.0/8 or 100.64.0.0/10. Ranges must be + unique and non-overlapping within a network. + Only IPv4 is supported. This field is set at + resource creation time. The range can be any + range listed in the Valid ranges list. The range + can be expanded after creation using + expandIpCidrRange. + ipv6_access_type (google.cloud.compute_v1.types.Subnetwork.Ipv6AccessType): + The access type of IPv6 address this subnet holds. It's + immutable and can only be specified during creation or the + first time the subnet is updated into IPV4_IPV6 dual stack. + If the ipv6_type is EXTERNAL then this subnet cannot enable + direct path. + ipv6_cidr_range (str): + [Output Only] The range of internal IPv6 addresses that are + owned by this subnetwork. + kind (str): + [Output Only] Type of the resource. Always + compute#subnetwork for Subnetwork resources. + log_config (google.cloud.compute_v1.types.SubnetworkLogConfig): + This field denotes the VPC flow logging + options for this subnetwork. If logging is + enabled, logs are exported to Cloud Logging. + name (str): + The name of the resource, provided by the client when + initially creating the resource. The name must be 1-63 + characters long, and comply with RFC1035. Specifically, the + name must be 1-63 characters long and match the regular + expression ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the + first character must be a lowercase letter, and all + following characters must be a dash, lowercase letter, or + digit, except the last character, which cannot be a dash. + network (str): + The URL of the network to which this + subnetwork belongs, provided by the client when + initially creating the subnetwork. This field + can be set only at resource creation time. + private_ip_google_access (bool): + Whether the VMs in this subnet can access + Google services without assigned external IP + addresses. This field can be both set at + resource creation time and updated using + setPrivateIpGoogleAccess. + private_ipv6_google_access (google.cloud.compute_v1.types.Subnetwork.PrivateIpv6GoogleAccess): + The private IPv6 google access type for the + VMs in this subnet. This is an expanded field of + enablePrivateV6Access. If both fields are set, + privateIpv6GoogleAccess will take priority. This + field can be both set at resource creation time + and updated using patch. + purpose (google.cloud.compute_v1.types.Subnetwork.Purpose): + The purpose of the resource. This field can be either + PRIVATE_RFC_1918 or INTERNAL_HTTPS_LOAD_BALANCER. A + subnetwork with purpose set to INTERNAL_HTTPS_LOAD_BALANCER + is a user-created subnetwork that is reserved for Internal + HTTP(S) Load Balancing. If unspecified, the purpose defaults + to PRIVATE_RFC_1918. The enableFlowLogs field isn't + supported with the purpose field set to + INTERNAL_HTTPS_LOAD_BALANCER. + region (str): + URL of the region where the Subnetwork + resides. This field can be set only at resource + creation time. + role (google.cloud.compute_v1.types.Subnetwork.Role): + The role of subnetwork. Currently, this field is only used + when purpose = INTERNAL_HTTPS_LOAD_BALANCER. The value can + be set to ACTIVE or BACKUP. An ACTIVE subnetwork is one that + is currently being used for Internal HTTP(S) Load Balancing. + A BACKUP subnetwork is one that is ready to be promoted to + ACTIVE or is currently draining. This field can be updated + with a patch request. + secondary_ip_ranges (Sequence[google.cloud.compute_v1.types.SubnetworkSecondaryRange]): + An array of configurations for secondary IP + ranges for VM instances contained in this + subnetwork. The primary IP of such VM must + belong to the primary ipCidrRange of the + subnetwork. The alias IPs may belong to either + primary or secondary ranges. This field can be + updated with a patch request. + self_link (str): + [Output Only] Server-defined URL for the resource. + stack_type (google.cloud.compute_v1.types.Subnetwork.StackType): + The stack type for this subnet to identify whether the IPv6 + feature is enabled or not. If not specified IPV4_ONLY will + be used. This field can be both set at resource creation + time and updated using patch. + state (google.cloud.compute_v1.types.Subnetwork.State): + [Output Only] The state of the subnetwork, which can be one + of the following values: READY: Subnetwork is created and + ready to use DRAINING: only applicable to subnetworks that + have the purpose set to INTERNAL_HTTPS_LOAD_BALANCER and + indicates that connections to the load balancer are being + drained. A subnetwork that is draining cannot be used or + modified until it reaches a status of READY """ - project = proto.Field(proto.STRING, number=227560217,) - snapshot = proto.Field(proto.STRING, number=284874180,) + class Ipv6AccessType(proto.Enum): + r"""The access type of IPv6 address this subnet holds. It's immutable + and can only be specified during creation or the first time the + subnet is updated into IPV4_IPV6 dual stack. If the ipv6_type is + EXTERNAL then this subnet cannot enable direct path. + """ + UNDEFINED_IPV6_ACCESS_TYPE = 0 + EXTERNAL = 35607499 + UNSPECIFIED_IPV6_ACCESS_TYPE = 313080613 + class PrivateIpv6GoogleAccess(proto.Enum): + r"""The private IPv6 google access type for the VMs in this + subnet. This is an expanded field of enablePrivateV6Access. If + both fields are set, privateIpv6GoogleAccess will take priority. + This field can be both set at resource creation time and updated + using patch. + """ + UNDEFINED_PRIVATE_IPV6_GOOGLE_ACCESS = 0 + DISABLE_GOOGLE_ACCESS = 450958579 + ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE = 427975994 + ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE = 288210263 -class GetIamPolicySnapshotRequest(proto.Message): - r"""A request message for Snapshots.GetIamPolicy. See the method - description for details. + class Purpose(proto.Enum): + r"""The purpose of the resource. This field can be either + PRIVATE_RFC_1918 or INTERNAL_HTTPS_LOAD_BALANCER. A subnetwork with + purpose set to INTERNAL_HTTPS_LOAD_BALANCER is a user-created + subnetwork that is reserved for Internal HTTP(S) Load Balancing. If + unspecified, the purpose defaults to PRIVATE_RFC_1918. The + enableFlowLogs field isn't supported with the purpose field set to + INTERNAL_HTTPS_LOAD_BALANCER. + """ + UNDEFINED_PURPOSE = 0 + INTERNAL_HTTPS_LOAD_BALANCER = 248748889 + PRIVATE = 403485027 + PRIVATE_RFC_1918 = 254902107 + PRIVATE_SERVICE_CONNECT = 48134724 - Attributes: - options_requested_policy_version (int): - Requested IAM Policy version. - project (str): - Project ID for this request. - resource (str): - Name or id of the resource for this request. - """ + class Role(proto.Enum): + r"""The role of subnetwork. Currently, this field is only used when + purpose = INTERNAL_HTTPS_LOAD_BALANCER. The value can be set to + ACTIVE or BACKUP. An ACTIVE subnetwork is one that is currently + being used for Internal HTTP(S) Load Balancing. A BACKUP subnetwork + is one that is ready to be promoted to ACTIVE or is currently + draining. This field can be updated with a patch request. + """ + UNDEFINED_ROLE = 0 + ACTIVE = 314733318 + BACKUP = 341010882 - options_requested_policy_version = proto.Field( - proto.INT32, number=499220029, optional=True, - ) - project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) + class StackType(proto.Enum): + r"""The stack type for this subnet to identify whether the IPv6 feature + is enabled or not. If not specified IPV4_ONLY will be used. This + field can be both set at resource creation time and updated using + patch. + """ + UNDEFINED_STACK_TYPE = 0 + IPV4_IPV6 = 22197249 + IPV4_ONLY = 22373798 + UNSPECIFIED_STACK_TYPE = 298084569 + class State(proto.Enum): + r"""[Output Only] The state of the subnetwork, which can be one of the + following values: READY: Subnetwork is created and ready to use + DRAINING: only applicable to subnetworks that have the purpose set + to INTERNAL_HTTPS_LOAD_BALANCER and indicates that connections to + the load balancer are being drained. A subnetwork that is draining + cannot be used or modified until it reaches a status of READY + """ + UNDEFINED_STATE = 0 + DRAINING = 480455402 + READY = 77848963 -class ListSnapshotsRequest(proto.Message): - r"""A request message for Snapshots.List. See the method - description for details. + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + enable_flow_logs = proto.Field(proto.BOOL, number=151544420, optional=True,) + external_ipv6_prefix = proto.Field(proto.STRING, number=139299190, optional=True,) + fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) + gateway_address = proto.Field(proto.STRING, number=459867385, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + ip_cidr_range = proto.Field(proto.STRING, number=98117322, optional=True,) + ipv6_access_type = proto.Field( + proto.ENUM, number=504658653, optional=True, enum=Ipv6AccessType, + ) + ipv6_cidr_range = proto.Field(proto.STRING, number=273141258, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + log_config = proto.Field( + proto.MESSAGE, number=351299741, optional=True, message="SubnetworkLogConfig", + ) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + network = proto.Field(proto.STRING, number=232872494, optional=True,) + private_ip_google_access = proto.Field(proto.BOOL, number=421491790, optional=True,) + private_ipv6_google_access = proto.Field( + proto.ENUM, number=48277006, optional=True, enum=PrivateIpv6GoogleAccess, + ) + purpose = proto.Field(proto.ENUM, number=316407070, optional=True, enum=Purpose,) + region = proto.Field(proto.STRING, number=138946292, optional=True,) + role = proto.Field(proto.ENUM, number=3506294, optional=True, enum=Role,) + secondary_ip_ranges = proto.RepeatedField( + proto.MESSAGE, number=136658915, message="SubnetworkSecondaryRange", + ) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + stack_type = proto.Field( + proto.ENUM, number=425908881, optional=True, enum=StackType, + ) + state = proto.Field(proto.ENUM, number=109757585, optional=True, enum=State,) - Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. +class SubnetworkAggregatedList(proto.Message): + r""" + Attributes: + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.SubnetworkAggregatedList.ItemsEntry]): + A list of SubnetworksScopedList resources. + kind (str): + [Output Only] Type of resource. Always + compute#subnetworkAggregatedList for aggregated lists of + subnetworks. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + @property + def raw_page(self): + return self - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.MapField( + proto.STRING, proto.MESSAGE, number=100526016, message="SubnetworksScopedList", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. +class SubnetworkList(proto.Message): + r"""Contains a list of Subnetwork resources. + Attributes: + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.Subnetwork]): + A list of Subnetwork resources. + kind (str): + [Output Only] Type of resource. Always + compute#subnetworkList for lists of subnetworks. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Subnetwork",) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class SetIamPolicySnapshotRequest(proto.Message): - r"""A request message for Snapshots.SetIamPolicy. See the method - description for details. +class SubnetworkLogConfig(proto.Message): + r"""The available logging options for this subnetwork. Attributes: - global_set_policy_request_resource (google.cloud.compute_v1.types.GlobalSetPolicyRequest): - The body resource for this request - project (str): - Project ID for this request. - resource (str): - Name or id of the resource for this request. + aggregation_interval (google.cloud.compute_v1.types.SubnetworkLogConfig.AggregationInterval): + Can only be specified if VPC flow logging for + this subnetwork is enabled. Toggles the + aggregation interval for collecting flow logs. + Increasing the interval time will reduce the + amount of generated flow logs for long lasting + connections. Default is an interval of 5 seconds + per connection. + enable (bool): + Whether to enable flow logging for this + subnetwork. If this field is not explicitly set, + it will not appear in get listings. If not set + the default behavior is to disable flow logging. + filter_expr (str): + Can only be specified if VPC flow logs for + this subnetwork is enabled. Export filter used + to define which VPC flow logs should be logged. + flow_sampling (float): + Can only be specified if VPC flow logging for this + subnetwork is enabled. The value of the field must be in [0, + 1]. Set the sampling rate of VPC flow logs within the + subnetwork where 1.0 means all collected logs are reported + and 0.0 means no logs are reported. Default is 0.5, which + means half of all collected logs are reported. + metadata (google.cloud.compute_v1.types.SubnetworkLogConfig.Metadata): + Can only be specified if VPC flow logs for this subnetwork + is enabled. Configures whether all, none or a subset of + metadata fields should be added to the reported VPC flow + logs. Default is EXCLUDE_ALL_METADATA. + metadata_fields (Sequence[str]): + Can only be specified if VPC flow logs for this subnetwork + is enabled and "metadata" was set to CUSTOM_METADATA. """ - global_set_policy_request_resource = proto.Field( - proto.MESSAGE, number=337048498, message="GlobalSetPolicyRequest", - ) - project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) + class AggregationInterval(proto.Enum): + r"""Can only be specified if VPC flow logging for this subnetwork + is enabled. Toggles the aggregation interval for collecting flow + logs. Increasing the interval time will reduce the amount of + generated flow logs for long lasting connections. Default is an + interval of 5 seconds per connection. + """ + UNDEFINED_AGGREGATION_INTERVAL = 0 + INTERVAL_10_MIN = 487155916 + INTERVAL_15_MIN = 491773521 + INTERVAL_1_MIN = 69052714 + INTERVAL_30_SEC = 7548937 + INTERVAL_5_MIN = 72746798 + INTERVAL_5_SEC = 72752429 + + class Metadata(proto.Enum): + r"""Can only be specified if VPC flow logs for this subnetwork is + enabled. Configures whether all, none or a subset of metadata fields + should be added to the reported VPC flow logs. Default is + EXCLUDE_ALL_METADATA. + """ + UNDEFINED_METADATA = 0 + CUSTOM_METADATA = 62450749 + EXCLUDE_ALL_METADATA = 334519954 + INCLUDE_ALL_METADATA = 164619908 + aggregation_interval = proto.Field( + proto.ENUM, number=174919042, optional=True, enum=AggregationInterval, + ) + enable = proto.Field(proto.BOOL, number=311764355, optional=True,) + filter_expr = proto.Field(proto.STRING, number=183374428, optional=True,) + flow_sampling = proto.Field(proto.FLOAT, number=530150360, optional=True,) + metadata = proto.Field(proto.ENUM, number=86866735, optional=True, enum=Metadata,) + metadata_fields = proto.RepeatedField(proto.STRING, number=378461641,) -class SetLabelsSnapshotRequest(proto.Message): - r"""A request message for Snapshots.SetLabels. See the method - description for details. +class SubnetworkSecondaryRange(proto.Message): + r"""Represents a secondary IP range of a subnetwork. Attributes: - global_set_labels_request_resource (google.cloud.compute_v1.types.GlobalSetLabelsRequest): - The body resource for this request - project (str): - Project ID for this request. - resource (str): - Name or id of the resource for this request. + ip_cidr_range (str): + The range of IP addresses belonging to this + subnetwork secondary range. Provide this + property when you create the subnetwork. Ranges + must be unique and non-overlapping with all + primary and secondary IP ranges within a + network. Only IPv4 is supported. The range can + be any range listed in the Valid ranges list. + range_name (str): + The name associated with this subnetwork + secondary range, used when adding an alias IP + range to a VM instance. The name must be 1-63 + characters long, and comply with RFC1035. The + name must be unique within the subnetwork. """ - global_set_labels_request_resource = proto.Field( - proto.MESSAGE, number=319917189, message="GlobalSetLabelsRequest", - ) - project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) + ip_cidr_range = proto.Field(proto.STRING, number=98117322, optional=True,) + range_name = proto.Field(proto.STRING, number=332216397, optional=True,) -class TestIamPermissionsSnapshotRequest(proto.Message): - r"""A request message for Snapshots.TestIamPermissions. See the - method description for details. +class SubnetworksExpandIpCidrRangeRequest(proto.Message): + r""" + Attributes: + ip_cidr_range (str): + The IP (in CIDR format or netmask) of + internal addresses that are legal on this + Subnetwork. This range should be disjoint from + other subnetworks within this network. This + range can only be larger than (i.e. a superset + of) the range previously defined before the + update. + """ + + ip_cidr_range = proto.Field(proto.STRING, number=98117322, optional=True,) + +class SubnetworksScopedList(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - resource (str): - Name or id of the resource for this request. - test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): - The body resource for this request + subnetworks (Sequence[google.cloud.compute_v1.types.Subnetwork]): + A list of subnetworks contained in this + scope. + warning (google.cloud.compute_v1.types.Warning): + An informational warning that appears when + the list of addresses is empty. """ - project = proto.Field(proto.STRING, number=227560217,) - resource = proto.Field(proto.STRING, number=195806222,) - test_permissions_request_resource = proto.Field( - proto.MESSAGE, number=439214758, message="TestPermissionsRequest", + subnetworks = proto.RepeatedField( + proto.MESSAGE, number=415853125, message="Subnetwork", + ) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", ) -class AggregatedListSslCertificatesRequest(proto.Message): - r"""A request message for SslCertificates.AggregatedList. See the - method description for details. - +class SubnetworksSetPrivateIpGoogleAccessRequest(proto.Message): + r""" Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. + private_ip_google_access (bool): - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + private_ip_google_access = proto.Field(proto.BOOL, number=421491790, optional=True,) - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. +class Subsetting(proto.Message): + r"""Subsetting configuration for this BackendService. Currently + this is applicable only for Internal TCP/UDP load balancing, + Internal HTTP(S) load balancing and Traffic Director. + + Attributes: + policy (google.cloud.compute_v1.types.Subsetting.Policy): - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Name of the project scoping this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + class Policy(proto.Enum): + r"""""" + UNDEFINED_POLICY = 0 + CONSISTENT_HASH_SUBSETTING = 108989492 + NONE = 2402104 + policy = proto.Field(proto.ENUM, number=91071794, optional=True, enum=Policy,) -class DeleteSslCertificateRequest(proto.Message): - r"""A request message for SslCertificates.Delete. See the method - description for details. + +class SwitchToCustomModeNetworkRequest(proto.Message): + r"""A request message for Networks.SwitchToCustomMode. See the + method description for details. Attributes: + network (str): + Name of the network to be updated. project (str): Project ID for this request. request_id (str): @@ -44650,2621 +44100,2426 @@ class DeleteSslCertificateRequest(proto.Message): Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - ssl_certificate (str): - Name of the SslCertificate resource to - delete. + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ + network = proto.Field(proto.STRING, number=232872494,) project = proto.Field(proto.STRING, number=227560217,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - ssl_certificate = proto.Field(proto.STRING, number=46443492,) - -class GetSslCertificateRequest(proto.Message): - r"""A request message for SslCertificates.Get. See the method - description for details. +class TCPHealthCheck(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - ssl_certificate (str): - Name of the SslCertificate resource to - return. + port (int): + The TCP port number for the health check + request. The default value is 80. Valid values + are 1 through 65535. + port_name (str): + Port name as defined in InstanceGroup#NamedPort#name. If + both port and port_name are defined, port takes precedence. + port_specification (google.cloud.compute_v1.types.TCPHealthCheck.PortSpecification): + Specifies how port is selected for health checking, can be + one of following values: USE_FIXED_PORT: The port number in + port is used for health checking. USE_NAMED_PORT: The + portName is used for health checking. USE_SERVING_PORT: For + NetworkEndpointGroup, the port specified for each network + endpoint is used for health checking. For other backends, + the port or named port specified in the Backend Service is + used for health checking. If not specified, TCP health check + follows behavior specified in port and portName fields. + proxy_header (google.cloud.compute_v1.types.TCPHealthCheck.ProxyHeader): + Specifies the type of proxy header to append before sending + data to the backend, either NONE or PROXY_V1. The default is + NONE. + request (str): + The application data to send once the TCP + connection has been established (default value + is empty). If both request and response are + empty, the connection establishment alone will + indicate health. The request data can only be + ASCII. + response (str): + The bytes to match against the beginning of + the response data. If left empty (the default + value), any response will indicate health. The + response data can only be ASCII. """ - project = proto.Field(proto.STRING, number=227560217,) - ssl_certificate = proto.Field(proto.STRING, number=46443492,) + class PortSpecification(proto.Enum): + r"""Specifies how port is selected for health checking, can be one of + following values: USE_FIXED_PORT: The port number in port is used + for health checking. USE_NAMED_PORT: The portName is used for health + checking. USE_SERVING_PORT: For NetworkEndpointGroup, the port + specified for each network endpoint is used for health checking. For + other backends, the port or named port specified in the Backend + Service is used for health checking. If not specified, TCP health + check follows behavior specified in port and portName fields. + """ + UNDEFINED_PORT_SPECIFICATION = 0 + USE_FIXED_PORT = 190235748 + USE_NAMED_PORT = 349300671 + USE_SERVING_PORT = 362637516 + class ProxyHeader(proto.Enum): + r"""Specifies the type of proxy header to append before sending data to + the backend, either NONE or PROXY_V1. The default is NONE. + """ + UNDEFINED_PROXY_HEADER = 0 + NONE = 2402104 + PROXY_V1 = 334352940 + + port = proto.Field(proto.INT32, number=3446913, optional=True,) + port_name = proto.Field(proto.STRING, number=41534345, optional=True,) + port_specification = proto.Field( + proto.ENUM, number=51590597, optional=True, enum=PortSpecification, + ) + proxy_header = proto.Field( + proto.ENUM, number=160374142, optional=True, enum=ProxyHeader, + ) + request = proto.Field(proto.STRING, number=21951119, optional=True,) + response = proto.Field(proto.STRING, number=196547649, optional=True,) -class InsertSslCertificateRequest(proto.Message): - r"""A request message for SslCertificates.Insert. See the method - description for details. +class Tags(proto.Message): + r"""A set of instance tags. Attributes: - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - ssl_certificate_resource (google.cloud.compute_v1.types.SslCertificate): - The body resource for this request + fingerprint (str): + Specifies a fingerprint for this request, + which is essentially a hash of the tags' + contents and used for optimistic locking. The + fingerprint is initially generated by Compute + Engine and changes after every request to modify + or update tags. You must always provide an up- + to-date fingerprint hash in order to update or + change tags. To see the latest fingerprint, make + get() request to the instance. + items (Sequence[str]): + An array of tags. Each tag must be 1-63 + characters long, and comply with RFC1035. """ - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - ssl_certificate_resource = proto.Field( - proto.MESSAGE, number=180709897, message="SslCertificate", - ) + fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) + items = proto.RepeatedField(proto.STRING, number=100526016,) -class ListSslCertificatesRequest(proto.Message): - r"""A request message for SslCertificates.List. See the method - description for details. +class TargetGrpcProxy(proto.Message): + r"""Represents a Target gRPC Proxy resource. A target gRPC proxy is a + component of load balancers intended for load balancing gRPC + traffic. Only global forwarding rules with load balancing scheme + INTERNAL_SELF_MANAGED can reference a target gRPC proxy. The target + gRPC Proxy references a URL map that specifies how traffic is routed + to gRPC backend services. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + fingerprint (str): + Fingerprint of this resource. A hash of the + contents stored in this object. This field is + used in optimistic locking. This field will be + ignored when inserting a TargetGrpcProxy. An up- + to-date fingerprint must be provided in order to + patch/update the TargetGrpcProxy; otherwise, the + request will fail with error 412 + conditionNotMet. To see the latest fingerprint, + make a get() request to retrieve the + TargetGrpcProxy. + id (int): + [Output Only] The unique identifier for the resource type. + The server generates this identifier. + kind (str): + [Output Only] Type of the resource. Always + compute#targetGrpcProxy for target grpc proxies. + name (str): + Name of the resource. Provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. + self_link (str): + [Output Only] Server-defined URL for the resource. + self_link_with_id (str): + [Output Only] Server-defined URL with id for the resource. + url_map (str): + URL to the UrlMap resource that defines the + mapping from URL to the BackendService. The + protocol field in the BackendService must be set + to GRPC. + validate_for_proxyless (bool): + If true, indicates that the BackendServices + referenced by the urlMap may be accessed by gRPC + applications without using a sidecar proxy. This + will enable configuration checks on urlMap and + its referenced BackendServices to not allow + unsupported features. A gRPC application must + use "xds:///" scheme in the target URI of the + service it is connecting to. If false, indicates + that the BackendServices referenced by the + urlMap will be accessed by gRPC applications via + a sidecar proxy. In this case, a gRPC + application must not use "xds:///" scheme in the + target URI of the service it is connecting to + """ - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + self_link_with_id = proto.Field(proto.STRING, number=44520962, optional=True,) + url_map = proto.Field(proto.STRING, number=367020684, optional=True,) + validate_for_proxyless = proto.Field(proto.BOOL, number=101822888, optional=True,) - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. +class TargetGrpcProxyList(proto.Message): + r""" + Attributes: + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.TargetGrpcProxy]): + A list of TargetGrpcProxy resources. + kind (str): + [Output Only] Type of the resource. Always + compute#targetGrpcProxy for target grpc proxies. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="TargetGrpcProxy", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class DeleteSslPolicyRequest(proto.Message): - r"""A request message for SslPolicies.Delete. See the method - description for details. +class TargetHttpProxiesScopedList(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - ssl_policy (str): - Name of the SSL policy to delete. The name - must be 1-63 characters long, and comply with - RFC1035. + target_http_proxies (Sequence[google.cloud.compute_v1.types.TargetHttpProxy]): + A list of TargetHttpProxies contained in this + scope. + warning (google.cloud.compute_v1.types.Warning): + Informational warning which replaces the list + of backend services when the list is empty. """ - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - ssl_policy = proto.Field(proto.STRING, number=295190213,) + target_http_proxies = proto.RepeatedField( + proto.MESSAGE, number=162147011, message="TargetHttpProxy", + ) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class GetSslPolicyRequest(proto.Message): - r"""A request message for SslPolicies.Get. See the method - description for details. +class TargetHttpProxy(proto.Message): + r"""Represents a Target HTTP Proxy resource. Google Compute Engine has + two Target HTTP Proxy resources: \* + `Global `__ \* + `Regional `__ + A target HTTP proxy is a component of GCP HTTP load balancers. \* + targetHttpProxies are used by external HTTP load balancers and + Traffic Director. \* regionTargetHttpProxies are used by internal + HTTP load balancers. Forwarding rules reference a target HTTP proxy, + and the target proxy then references a URL map. For more + information, read Using Target Proxies and Forwarding rule concepts. Attributes: - project (str): - Project ID for this request. - ssl_policy (str): - Name of the SSL policy to update. The name - must be 1-63 characters long, and comply with - RFC1035. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + fingerprint (str): + Fingerprint of this resource. A hash of the + contents stored in this object. This field is + used in optimistic locking. This field will be + ignored when inserting a TargetHttpProxy. An up- + to-date fingerprint must be provided in order to + patch/update the TargetHttpProxy; otherwise, the + request will fail with error 412 + conditionNotMet. To see the latest fingerprint, + make a get() request to retrieve the + TargetHttpProxy. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + kind (str): + [Output Only] Type of resource. Always + compute#targetHttpProxy for target HTTP proxies. + name (str): + Name of the resource. Provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. + proxy_bind (bool): + This field only applies when the forwarding rule that + references this target proxy has a loadBalancingScheme set + to INTERNAL_SELF_MANAGED. When this field is set to true, + Envoy proxies set up inbound traffic interception and bind + to the IP address and port specified in the forwarding rule. + This is generally useful when using Traffic Director to + configure Envoy as a gateway or middle proxy (in other + words, not a sidecar proxy). The Envoy proxy listens for + inbound requests and handles requests when it receives them. + The default is false. + region (str): + [Output Only] URL of the region where the regional Target + HTTP Proxy resides. This field is not applicable to global + Target HTTP Proxies. + self_link (str): + [Output Only] Server-defined URL for the resource. + url_map (str): + URL to the UrlMap resource that defines the + mapping from URL to the BackendService. """ - project = proto.Field(proto.STRING, number=227560217,) - ssl_policy = proto.Field(proto.STRING, number=295190213,) - + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + proxy_bind = proto.Field(proto.BOOL, number=286025582, optional=True,) + region = proto.Field(proto.STRING, number=138946292, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + url_map = proto.Field(proto.STRING, number=367020684, optional=True,) -class InsertSslPolicyRequest(proto.Message): - r"""A request message for SslPolicies.Insert. See the method - description for details. +class TargetHttpProxyAggregatedList(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - ssl_policy_resource (google.cloud.compute_v1.types.SslPolicy): - The body resource for this request + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.TargetHttpProxyAggregatedList.ItemsEntry]): + A list of TargetHttpProxiesScopedList + resources. + kind (str): + [Output Only] Type of resource. Always + compute#targetHttpProxyAggregatedList for lists of Target + HTTP Proxies. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. """ - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - ssl_policy_resource = proto.Field( - proto.MESSAGE, number=274891848, message="SslPolicy", - ) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.MapField( + proto.STRING, + proto.MESSAGE, + number=100526016, + message="TargetHttpProxiesScopedList", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) -class ListSslPoliciesRequest(proto.Message): - r"""A request message for SslPolicies.List. See the method - description for details. +class TargetHttpProxyList(proto.Message): + r"""A list of TargetHttpProxy resources. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.TargetHttpProxy]): + A list of TargetHttpProxy resources. + kind (str): + Type of resource. Always + compute#targetHttpProxyList for lists of target + HTTP proxies. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + @property + def raw_page(self): + return self - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="TargetHttpProxy", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. +class TargetHttpsProxiesScopedList(proto.Message): + r""" + Attributes: + target_https_proxies (Sequence[google.cloud.compute_v1.types.TargetHttpsProxy]): + A list of TargetHttpsProxies contained in + this scope. + warning (google.cloud.compute_v1.types.Warning): + Informational warning which replaces the list + of backend services when the list is empty. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - + target_https_proxies = proto.RepeatedField( + proto.MESSAGE, number=366607882, message="TargetHttpsProxy", + ) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class ListAvailableFeaturesSslPoliciesRequest(proto.Message): - r"""A request message for SslPolicies.ListAvailableFeatures. See - the method description for details. +class TargetHttpsProxiesSetQuicOverrideRequest(proto.Message): + r""" Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + quic_override (google.cloud.compute_v1.types.TargetHttpsProxiesSetQuicOverrideRequest.QuicOverride): + QUIC policy for the TargetHttpsProxy + resource. + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + class QuicOverride(proto.Enum): + r"""QUIC policy for the TargetHttpsProxy resource.""" + UNDEFINED_QUIC_OVERRIDE = 0 + DISABLE = 241807048 + ENABLE = 438835587 + NONE = 2402104 - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. + quic_override = proto.Field( + proto.ENUM, number=456577197, optional=True, enum=QuicOverride, + ) - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. +class TargetHttpsProxiesSetSslCertificatesRequest(proto.Message): + r""" + Attributes: + ssl_certificates (Sequence[str]): + New set of SslCertificate resources to + associate with this TargetHttpsProxy resource. + At least one SSL certificate must be specified. + Currently, you may specify up to 15 SSL + certificates. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + ssl_certificates = proto.RepeatedField(proto.STRING, number=366006543,) -class PatchSslPolicyRequest(proto.Message): - r"""A request message for SslPolicies.Patch. See the method - description for details. +class TargetHttpsProxy(proto.Message): + r"""Represents a Target HTTPS Proxy resource. Google Compute Engine has + two Target HTTPS Proxy resources: \* + `Global `__ \* + `Regional `__ + A target HTTPS proxy is a component of GCP HTTPS load balancers. \* + targetHttpsProxies are used by external HTTPS load balancers. \* + regionTargetHttpsProxies are used by internal HTTPS load balancers. + Forwarding rules reference a target HTTPS proxy, and the target + proxy then references a URL map. For more information, read Using + Target Proxies and Forwarding rule concepts. Attributes: - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). + authorization_policy (str): + Optional. A URL referring to a + networksecurity.AuthorizationPolicy resource that describes + how the proxy should authorize inbound traffic. If left + blank, access will not be restricted by an authorization + policy. Refer to the AuthorizationPolicy resource for + additional details. authorizationPolicy only applies to a + global TargetHttpsProxy attached to globalForwardingRules + with the loadBalancingScheme set to INTERNAL_SELF_MANAGED. + Note: This field currently has no impact. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + fingerprint (str): + Fingerprint of this resource. A hash of the + contents stored in this object. This field is + used in optimistic locking. This field will be + ignored when inserting a TargetHttpsProxy. An + up-to-date fingerprint must be provided in order + to patch the TargetHttpsProxy; otherwise, the + request will fail with error 412 + conditionNotMet. To see the latest fingerprint, + make a get() request to retrieve the + TargetHttpsProxy. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + kind (str): + [Output Only] Type of resource. Always + compute#targetHttpsProxy for target HTTPS proxies. + name (str): + Name of the resource. Provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. + proxy_bind (bool): + This field only applies when the forwarding rule that + references this target proxy has a loadBalancingScheme set + to INTERNAL_SELF_MANAGED. When this field is set to true, + Envoy proxies set up inbound traffic interception and bind + to the IP address and port specified in the forwarding rule. + This is generally useful when using Traffic Director to + configure Envoy as a gateway or middle proxy (in other + words, not a sidecar proxy). The Envoy proxy listens for + inbound requests and handles requests when it receives them. + The default is false. + quic_override (google.cloud.compute_v1.types.TargetHttpsProxy.QuicOverride): + Specifies the QUIC override policy for this + TargetHttpsProxy resource. This setting + determines whether the load balancer attempts to + negotiate QUIC with clients. You can specify + NONE, ENABLE, or DISABLE. - When quic-override + is set to NONE, Google manages whether QUIC is + used. - When quic-override is set to ENABLE, the + load balancer uses QUIC when possible. - When + quic-override is set to DISABLE, the load + balancer doesn't use QUIC. - If the quic- + override flag is not specified, NONE is implied. + region (str): + [Output Only] URL of the region where the regional + TargetHttpsProxy resides. This field is not applicable to + global TargetHttpsProxies. + self_link (str): + [Output Only] Server-defined URL for the resource. + server_tls_policy (str): + Optional. A URL referring to a + networksecurity.ServerTlsPolicy resource that describes how + the proxy should authenticate inbound traffic. + serverTlsPolicy only applies to a global TargetHttpsProxy + attached to globalForwardingRules with the + loadBalancingScheme set to INTERNAL_SELF_MANAGED. If left + blank, communications are not encrypted. Note: This field + currently has no impact. + ssl_certificates (Sequence[str]): + URLs to SslCertificate resources that are used to + authenticate connections between users and the load + balancer. At least one SSL certificate must be specified. + Currently, you may specify up to 15 SSL certificates. + sslCertificates do not apply when the load balancing scheme + is set to INTERNAL_SELF_MANAGED. ssl_policy (str): - Name of the SSL policy to update. The name - must be 1-63 characters long, and comply with - RFC1035. - ssl_policy_resource (google.cloud.compute_v1.types.SslPolicy): - The body resource for this request + URL of SslPolicy resource that will be + associated with the TargetHttpsProxy resource. + If not set, the TargetHttpsProxy resource has no + SSL policy configured. + url_map (str): + A fully-qualified or valid partial URL to the + UrlMap resource that defines the mapping from + URL to the BackendService. For example, the + following are all valid URLs for specifying a + URL map: - + https://www.googleapis.compute/v1/projects/project/global/urlMaps/ + url-map - projects/project/global/urlMaps/url- + map - global/urlMaps/url-map """ - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - ssl_policy = proto.Field(proto.STRING, number=295190213,) - ssl_policy_resource = proto.Field( - proto.MESSAGE, number=274891848, message="SslPolicy", - ) + class QuicOverride(proto.Enum): + r"""Specifies the QUIC override policy for this TargetHttpsProxy + resource. This setting determines whether the load balancer + attempts to negotiate QUIC with clients. You can specify NONE, + ENABLE, or DISABLE. - When quic-override is set to NONE, Google + manages whether QUIC is used. - When quic-override is set to + ENABLE, the load balancer uses QUIC when possible. - When quic- + override is set to DISABLE, the load balancer doesn't use QUIC. + - If the quic-override flag is not specified, NONE is implied. + """ + UNDEFINED_QUIC_OVERRIDE = 0 + DISABLE = 241807048 + ENABLE = 438835587 + NONE = 2402104 + authorization_policy = proto.Field(proto.STRING, number=33945528, optional=True,) + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + proxy_bind = proto.Field(proto.BOOL, number=286025582, optional=True,) + quic_override = proto.Field( + proto.ENUM, number=456577197, optional=True, enum=QuicOverride, + ) + region = proto.Field(proto.STRING, number=138946292, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + server_tls_policy = proto.Field(proto.STRING, number=295825266, optional=True,) + ssl_certificates = proto.RepeatedField(proto.STRING, number=366006543,) + ssl_policy = proto.Field(proto.STRING, number=295190213, optional=True,) + url_map = proto.Field(proto.STRING, number=367020684, optional=True,) -class AggregatedListSubnetworksRequest(proto.Message): - r"""A request message for Subnetworks.AggregatedList. See the - method description for details. +class TargetHttpsProxyAggregatedList(proto.Message): + r""" Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.TargetHttpsProxyAggregatedList.ItemsEntry]): + A list of TargetHttpsProxiesScopedList + resources. + kind (str): + [Output Only] Type of resource. Always + compute#targetHttpsProxyAggregatedList for lists of Target + HTTP Proxies. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + @property + def raw_page(self): + return self - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.MapField( + proto.STRING, + proto.MESSAGE, + number=100526016, + message="TargetHttpsProxiesScopedList", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. +class TargetHttpsProxyList(proto.Message): + r"""Contains a list of TargetHttpsProxy resources. + Attributes: + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.TargetHttpsProxy]): + A list of TargetHttpsProxy resources. + kind (str): + Type of resource. Always + compute#targetHttpsProxyList for lists of target + HTTPS proxies. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + @property + def raw_page(self): + return self + + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="TargetHttpsProxy", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class DeleteSubnetworkRequest(proto.Message): - r"""A request message for Subnetworks.Delete. See the method - description for details. +class TargetInstance(proto.Message): + r"""Represents a Target Instance resource. You can use a target + instance to handle traffic for one or more forwarding rules, + which is ideal for forwarding protocol traffic that is managed + by a single source. For example, ESP, AH, TCP, or UDP. For more + information, read Target instances. Attributes: - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - subnetwork (str): - Name of the Subnetwork resource to delete. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + instance (str): + A URL to the virtual machine instance that + handles traffic for this target instance. When + creating a target instance, you can provide the + fully-qualified URL or a valid partial URL to + the desired virtual machine. For example, the + following are all valid URLs: - + https://www.googleapis.com/compute/v1/projects/project/zones/zone + /instances/instance - + projects/project/zones/zone/instances/instance - + zones/zone/instances/instance + kind (str): + [Output Only] The type of the resource. Always + compute#targetInstance for target instances. + name (str): + Name of the resource. Provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. + nat_policy (google.cloud.compute_v1.types.TargetInstance.NatPolicy): + NAT option controlling how IPs are NAT'ed to the instance. + Currently only NO_NAT (default value) is supported. + network (str): + The URL of the network this target instance + uses to forward traffic. If not specified, the + traffic will be forwarded to the network that + the default network interface belongs to. + self_link (str): + [Output Only] Server-defined URL for the resource. + zone (str): + [Output Only] URL of the zone where the target instance + resides. You must specify this field as part of the HTTP + request URL. It is not settable as a field in the request + body. """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - subnetwork = proto.Field(proto.STRING, number=307827694,) + class NatPolicy(proto.Enum): + r"""NAT option controlling how IPs are NAT'ed to the instance. Currently + only NO_NAT (default value) is supported. + """ + UNDEFINED_NAT_POLICY = 0 + NO_NAT = 161455491 + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + instance = proto.Field(proto.STRING, number=18257045, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + nat_policy = proto.Field( + proto.ENUM, number=509780496, optional=True, enum=NatPolicy, + ) + network = proto.Field(proto.STRING, number=232872494, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + zone = proto.Field(proto.STRING, number=3744684, optional=True,) -class ExpandIpCidrRangeSubnetworkRequest(proto.Message): - r"""A request message for Subnetworks.ExpandIpCidrRange. See the - method description for details. +class TargetInstanceAggregatedList(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - subnetwork (str): - Name of the Subnetwork resource to update. - subnetworks_expand_ip_cidr_range_request_resource (google.cloud.compute_v1.types.SubnetworksExpandIpCidrRangeRequest): - The body resource for this request + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.TargetInstanceAggregatedList.ItemsEntry]): + A list of TargetInstance resources. + kind (str): + Type of resource. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - subnetwork = proto.Field(proto.STRING, number=307827694,) - subnetworks_expand_ip_cidr_range_request_resource = proto.Field( - proto.MESSAGE, number=477014110, message="SubnetworksExpandIpCidrRangeRequest", - ) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.MapField( + proto.STRING, + proto.MESSAGE, + number=100526016, + message="TargetInstancesScopedList", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class GetSubnetworkRequest(proto.Message): - r"""A request message for Subnetworks.Get. See the method - description for details. +class TargetInstanceList(proto.Message): + r"""Contains a list of TargetInstance resources. Attributes: - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - subnetwork (str): - Name of the Subnetwork resource to return. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.TargetInstance]): + A list of TargetInstance resources. + kind (str): + Type of resource. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - subnetwork = proto.Field(proto.STRING, number=307827694,) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="TargetInstance", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class GetIamPolicySubnetworkRequest(proto.Message): - r"""A request message for Subnetworks.GetIamPolicy. See the - method description for details. +class TargetInstancesScopedList(proto.Message): + r""" Attributes: - options_requested_policy_version (int): - Requested IAM Policy version. - project (str): - Project ID for this request. - region (str): - The name of the region for this request. - resource (str): - Name or id of the resource for this request. + target_instances (Sequence[google.cloud.compute_v1.types.TargetInstance]): + A list of target instances contained in this + scope. + warning (google.cloud.compute_v1.types.Warning): + Informational warning which replaces the list + of addresses when the list is empty. """ - options_requested_policy_version = proto.Field( - proto.INT32, number=499220029, optional=True, + target_instances = proto.RepeatedField( + proto.MESSAGE, number=392915280, message="TargetInstance", + ) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", ) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - resource = proto.Field(proto.STRING, number=195806222,) -class InsertSubnetworkRequest(proto.Message): - r"""A request message for Subnetworks.Insert. See the method - description for details. +class TargetPool(proto.Message): + r"""Represents a Target Pool resource. Target pools are used for + network TCP/UDP load balancing. A target pool references member + instances, an associated legacy HttpHealthCheck resource, and, + optionally, a backup target pool. For more information, read + Using target pools. Attributes: - project (str): - Project ID for this request. + backup_pool (str): + The server-defined URL for the resource. This field is + applicable only when the containing target pool is serving a + forwarding rule as the primary pool, and its failoverRatio + field is properly set to a value between [0, 1]. backupPool + and failoverRatio together define the fallback behavior of + the primary target pool: if the ratio of the healthy + instances in the primary pool is at or below failoverRatio, + traffic arriving at the load-balanced IP will be directed to + the backup pool. In case where failoverRatio and backupPool + are not set, or all the instances in the backup pool are + unhealthy, the traffic will be directed back to the primary + pool in the "force" mode, where traffic will be spread to + the healthy instances with the best effort, or to all + instances when no instance is healthy. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + failover_ratio (float): + This field is applicable only when the containing target + pool is serving a forwarding rule as the primary pool (i.e., + not as a backup pool to some other target pool). The value + of the field must be in [0, 1]. If set, backupPool must also + be set. They together define the fallback behavior of the + primary target pool: if the ratio of the healthy instances + in the primary pool is at or below this number, traffic + arriving at the load-balanced IP will be directed to the + backup pool. In case where failoverRatio is not set or all + the instances in the backup pool are unhealthy, the traffic + will be directed back to the primary pool in the "force" + mode, where traffic will be spread to the healthy instances + with the best effort, or to all instances when no instance + is healthy. + health_checks (Sequence[str]): + The URL of the HttpHealthCheck resource. A + member instance in this pool is considered + healthy if and only if the health checks pass. + Only legacy HttpHealthChecks are supported. Only + one health check may be specified. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + instances (Sequence[str]): + A list of resource URLs to the virtual + machine instances serving this pool. They must + live in zones contained in the same region as + this pool. + kind (str): + [Output Only] Type of the resource. Always + compute#targetPool for target pools. + name (str): + Name of the resource. Provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. region (str): - Name of the region scoping this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - subnetwork_resource (google.cloud.compute_v1.types.Subnetwork): - The body resource for this request + [Output Only] URL of the region where the target pool + resides. + self_link (str): + [Output Only] Server-defined URL for the resource. + session_affinity (google.cloud.compute_v1.types.TargetPool.SessionAffinity): + Session affinity option, must be one of the following + values: NONE: Connections from the same client IP may go to + any instance in the pool. CLIENT_IP: Connections from the + same client IP will go to the same instance in the pool + while that instance remains healthy. CLIENT_IP_PROTO: + Connections from the same client IP with the same IP + protocol will go to the same instance in the pool while that + instance remains healthy. """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - subnetwork_resource = proto.Field( - proto.MESSAGE, number=42233151, message="Subnetwork", - ) + class SessionAffinity(proto.Enum): + r"""Session affinity option, must be one of the following values: NONE: + Connections from the same client IP may go to any instance in the + pool. CLIENT_IP: Connections from the same client IP will go to the + same instance in the pool while that instance remains healthy. + CLIENT_IP_PROTO: Connections from the same client IP with the same + IP protocol will go to the same instance in the pool while that + instance remains healthy. + """ + UNDEFINED_SESSION_AFFINITY = 0 + CLIENT_IP = 345665051 + CLIENT_IP_NO_DESTINATION = 106122516 + CLIENT_IP_PORT_PROTO = 221722926 + CLIENT_IP_PROTO = 25322148 + GENERATED_COOKIE = 370321204 + HEADER_FIELD = 200737960 + HTTP_COOKIE = 494981627 + NONE = 2402104 + backup_pool = proto.Field(proto.STRING, number=45884537, optional=True,) + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + failover_ratio = proto.Field(proto.FLOAT, number=212667006, optional=True,) + health_checks = proto.RepeatedField(proto.STRING, number=448370606,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + instances = proto.RepeatedField(proto.STRING, number=29097598,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + region = proto.Field(proto.STRING, number=138946292, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + session_affinity = proto.Field( + proto.ENUM, number=463888561, optional=True, enum=SessionAffinity, + ) -class ListSubnetworksRequest(proto.Message): - r"""A request message for Subnetworks.List. See the method - description for details. +class TargetPoolAggregatedList(proto.Message): + r""" Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.TargetPoolAggregatedList.ItemsEntry]): + A list of TargetPool resources. + kind (str): + [Output Only] Type of resource. Always + compute#targetPoolAggregatedList for aggregated lists of + target pools. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.MapField( + proto.STRING, proto.MESSAGE, number=100526016, message="TargetPoolsScopedList", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class ListUsableSubnetworksRequest(proto.Message): - r"""A request message for Subnetworks.ListUsable. See the method - description for details. +class TargetPoolInstanceHealth(proto.Message): + r""" Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + health_status (Sequence[google.cloud.compute_v1.types.HealthStatus]): - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + kind (str): + [Output Only] Type of resource. Always + compute#targetPoolInstanceHealth when checking the health of + an instance. + """ - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. + health_status = proto.RepeatedField( + proto.MESSAGE, number=380545845, message="HealthStatus", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. +class TargetPoolList(proto.Message): + r"""Contains a list of TargetPool resources. + Attributes: + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.TargetPool]): + A list of TargetPool resources. + kind (str): + [Output Only] Type of resource. Always + compute#targetPoolList for lists of target pools. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="TargetPool",) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class PatchSubnetworkRequest(proto.Message): - r"""A request message for Subnetworks.Patch. See the method - description for details. - Attributes: - drain_timeout_seconds (int): - The drain timeout specifies the upper bound in seconds on - the amount of time allowed to drain connections from the - current ACTIVE subnetwork to the current BACKUP subnetwork. - The drain timeout is only applicable when the following - conditions are true: - the subnetwork being patched has - purpose = INTERNAL_HTTPS_LOAD_BALANCER - the subnetwork - being patched has role = BACKUP - the patch request is - setting the role to ACTIVE. Note that after this patch - operation the roles of the ACTIVE and BACKUP subnetworks - will be swapped. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - subnetwork (str): - Name of the Subnetwork resource to patch. - subnetwork_resource (google.cloud.compute_v1.types.Subnetwork): - The body resource for this request +class TargetPoolsAddHealthCheckRequest(proto.Message): + r""" + Attributes: + health_checks (Sequence[google.cloud.compute_v1.types.HealthCheckReference]): + The HttpHealthCheck to add to the target + pool. """ - drain_timeout_seconds = proto.Field(proto.INT32, number=357707098, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - subnetwork = proto.Field(proto.STRING, number=307827694,) - subnetwork_resource = proto.Field( - proto.MESSAGE, number=42233151, message="Subnetwork", + health_checks = proto.RepeatedField( + proto.MESSAGE, number=448370606, message="HealthCheckReference", ) -class SetIamPolicySubnetworkRequest(proto.Message): - r"""A request message for Subnetworks.SetIamPolicy. See the - method description for details. - +class TargetPoolsAddInstanceRequest(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - region (str): - The name of the region for this request. - region_set_policy_request_resource (google.cloud.compute_v1.types.RegionSetPolicyRequest): - The body resource for this request - resource (str): - Name or id of the resource for this request. + instances (Sequence[google.cloud.compute_v1.types.InstanceReference]): + A full or partial URL to an instance to add + to this target pool. This can be a full or + partial URL. For example, the following are + valid URLs: - + https://www.googleapis.com/compute/v1/projects/project- + id/zones/zone /instances/instance-name - + projects/project- + id/zones/zone/instances/instance-name - + zones/zone/instances/instance-name """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - region_set_policy_request_resource = proto.Field( - proto.MESSAGE, number=276489091, message="RegionSetPolicyRequest", + instances = proto.RepeatedField( + proto.MESSAGE, number=29097598, message="InstanceReference", ) - resource = proto.Field(proto.STRING, number=195806222,) -class SetPrivateIpGoogleAccessSubnetworkRequest(proto.Message): - r"""A request message for Subnetworks.SetPrivateIpGoogleAccess. - See the method description for details. - +class TargetPoolsRemoveHealthCheckRequest(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - subnetwork (str): - Name of the Subnetwork resource. - subnetworks_set_private_ip_google_access_request_resource (google.cloud.compute_v1.types.SubnetworksSetPrivateIpGoogleAccessRequest): - The body resource for this request + health_checks (Sequence[google.cloud.compute_v1.types.HealthCheckReference]): + Health check URL to be removed. This can be a + full or valid partial URL. For example, the + following are valid URLs: - + https://www.googleapis.com/compute/beta/projects/project + /global/httpHealthChecks/health-check - + projects/project/global/httpHealthChecks/health- + check - global/httpHealthChecks/health-check """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - subnetwork = proto.Field(proto.STRING, number=307827694,) - subnetworks_set_private_ip_google_access_request_resource = proto.Field( - proto.MESSAGE, - number=268920696, - message="SubnetworksSetPrivateIpGoogleAccessRequest", + health_checks = proto.RepeatedField( + proto.MESSAGE, number=448370606, message="HealthCheckReference", ) -class TestIamPermissionsSubnetworkRequest(proto.Message): - r"""A request message for Subnetworks.TestIamPermissions. See the - method description for details. - +class TargetPoolsRemoveInstanceRequest(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - region (str): - The name of the region for this request. - resource (str): - Name or id of the resource for this request. - test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): - The body resource for this request + instances (Sequence[google.cloud.compute_v1.types.InstanceReference]): + URLs of the instances to be removed from + target pool. """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - resource = proto.Field(proto.STRING, number=195806222,) - test_permissions_request_resource = proto.Field( - proto.MESSAGE, number=439214758, message="TestPermissionsRequest", + instances = proto.RepeatedField( + proto.MESSAGE, number=29097598, message="InstanceReference", ) -class DeleteTargetGrpcProxyRequest(proto.Message): - r"""A request message for TargetGrpcProxies.Delete. See the - method description for details. +class TargetPoolsScopedList(proto.Message): + r""" + Attributes: + target_pools (Sequence[google.cloud.compute_v1.types.TargetPool]): + A list of target pools contained in this + scope. + warning (google.cloud.compute_v1.types.Warning): + Informational warning which replaces the list + of addresses when the list is empty. + """ + + target_pools = proto.RepeatedField( + proto.MESSAGE, number=336072617, message="TargetPool", + ) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) + +class TargetReference(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_grpc_proxy (str): - Name of the TargetGrpcProxy resource to - delete. + target (str): + """ - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_grpc_proxy = proto.Field(proto.STRING, number=5020283,) + target = proto.Field(proto.STRING, number=192835985, optional=True,) -class GetTargetGrpcProxyRequest(proto.Message): - r"""A request message for TargetGrpcProxies.Get. See the method - description for details. +class TargetSslProxiesSetBackendServiceRequest(proto.Message): + r""" + Attributes: + service (str): + The URL of the new BackendService resource + for the targetSslProxy. + """ + service = proto.Field(proto.STRING, number=373540533, optional=True,) + + +class TargetSslProxiesSetProxyHeaderRequest(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - target_grpc_proxy (str): - Name of the TargetGrpcProxy resource to - return. + proxy_header (google.cloud.compute_v1.types.TargetSslProxiesSetProxyHeaderRequest.ProxyHeader): + The new type of proxy header to append before sending data + to the backend. NONE or PROXY_V1 are allowed. """ - project = proto.Field(proto.STRING, number=227560217,) - target_grpc_proxy = proto.Field(proto.STRING, number=5020283,) + class ProxyHeader(proto.Enum): + r"""The new type of proxy header to append before sending data to the + backend. NONE or PROXY_V1 are allowed. + """ + UNDEFINED_PROXY_HEADER = 0 + NONE = 2402104 + PROXY_V1 = 334352940 + proxy_header = proto.Field( + proto.ENUM, number=160374142, optional=True, enum=ProxyHeader, + ) -class InsertTargetGrpcProxyRequest(proto.Message): - r"""A request message for TargetGrpcProxies.Insert. See the - method description for details. +class TargetSslProxiesSetSslCertificatesRequest(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_grpc_proxy_resource (google.cloud.compute_v1.types.TargetGrpcProxy): - The body resource for this request + ssl_certificates (Sequence[str]): + New set of URLs to SslCertificate resources + to associate with this TargetSslProxy. At least + one SSL certificate must be specified. + Currently, you may specify up to 15 SSL + certificates. """ - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_grpc_proxy_resource = proto.Field( - proto.MESSAGE, number=328922450, message="TargetGrpcProxy", - ) + ssl_certificates = proto.RepeatedField(proto.STRING, number=366006543,) -class ListTargetGrpcProxiesRequest(proto.Message): - r"""A request message for TargetGrpcProxies.List. See the method - description for details. +class TargetSslProxy(proto.Message): + r"""Represents a Target SSL Proxy resource. A target SSL proxy is + a component of a SSL Proxy load balancer. Global forwarding + rules reference a target SSL proxy, and the target proxy then + references an external backend service. For more information, + read Using Target Proxies. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + kind (str): + [Output Only] Type of the resource. Always + compute#targetSslProxy for target SSL proxies. + name (str): + Name of the resource. Provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. + proxy_header (google.cloud.compute_v1.types.TargetSslProxy.ProxyHeader): + Specifies the type of proxy header to append before sending + data to the backend, either NONE or PROXY_V1. The default is + NONE. + self_link (str): + [Output Only] Server-defined URL for the resource. + service (str): + URL to the BackendService resource. + ssl_certificates (Sequence[str]): + URLs to SslCertificate resources that are used to + authenticate connections to Backends. At least one SSL + certificate must be specified. Currently, you may specify up + to 15 SSL certificates. sslCertificates do not apply when + the load balancing scheme is set to INTERNAL_SELF_MANAGED. + ssl_policy (str): + URL of SslPolicy resource that will be + associated with the TargetSslProxy resource. If + not set, the TargetSslProxy resource will not + have any SSL policy configured. + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + class ProxyHeader(proto.Enum): + r"""Specifies the type of proxy header to append before sending data to + the backend, either NONE or PROXY_V1. The default is NONE. + """ + UNDEFINED_PROXY_HEADER = 0 + NONE = 2402104 + PROXY_V1 = 334352940 - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + proxy_header = proto.Field( + proto.ENUM, number=160374142, optional=True, enum=ProxyHeader, + ) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + service = proto.Field(proto.STRING, number=373540533, optional=True,) + ssl_certificates = proto.RepeatedField(proto.STRING, number=366006543,) + ssl_policy = proto.Field(proto.STRING, number=295190213, optional=True,) - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. +class TargetSslProxyList(proto.Message): + r"""Contains a list of TargetSslProxy resources. + Attributes: + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.TargetSslProxy]): + A list of TargetSslProxy resources. + kind (str): + Type of resource. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="TargetSslProxy", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class PatchTargetGrpcProxyRequest(proto.Message): - r"""A request message for TargetGrpcProxies.Patch. See the method - description for details. +class TargetTcpProxiesSetBackendServiceRequest(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_grpc_proxy (str): - Name of the TargetGrpcProxy resource to - patch. - target_grpc_proxy_resource (google.cloud.compute_v1.types.TargetGrpcProxy): - The body resource for this request + service (str): + The URL of the new BackendService resource + for the targetTcpProxy. """ - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_grpc_proxy = proto.Field(proto.STRING, number=5020283,) - target_grpc_proxy_resource = proto.Field( - proto.MESSAGE, number=328922450, message="TargetGrpcProxy", + service = proto.Field(proto.STRING, number=373540533, optional=True,) + + +class TargetTcpProxiesSetProxyHeaderRequest(proto.Message): + r""" + Attributes: + proxy_header (google.cloud.compute_v1.types.TargetTcpProxiesSetProxyHeaderRequest.ProxyHeader): + The new type of proxy header to append before sending data + to the backend. NONE or PROXY_V1 are allowed. + """ + + class ProxyHeader(proto.Enum): + r"""The new type of proxy header to append before sending data to the + backend. NONE or PROXY_V1 are allowed. + """ + UNDEFINED_PROXY_HEADER = 0 + NONE = 2402104 + PROXY_V1 = 334352940 + + proxy_header = proto.Field( + proto.ENUM, number=160374142, optional=True, enum=ProxyHeader, ) -class AggregatedListTargetHttpProxiesRequest(proto.Message): - r"""A request message for TargetHttpProxies.AggregatedList. See - the method description for details. +class TargetTcpProxy(proto.Message): + r"""Represents a Target TCP Proxy resource. A target TCP proxy is + a component of a TCP Proxy load balancer. Global forwarding + rules reference target TCP proxy, and the target proxy then + references an external backend service. For more information, + read TCP Proxy Load Balancing overview. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + kind (str): + [Output Only] Type of the resource. Always + compute#targetTcpProxy for target TCP proxies. + name (str): + Name of the resource. Provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. + proxy_bind (bool): + This field only applies when the forwarding rule that + references this target proxy has a loadBalancingScheme set + to INTERNAL_SELF_MANAGED. When this field is set to true, + Envoy proxies set up inbound traffic interception and bind + to the IP address and port specified in the forwarding rule. + This is generally useful when using Traffic Director to + configure Envoy as a gateway or middle proxy (in other + words, not a sidecar proxy). The Envoy proxy listens for + inbound requests and handles requests when it receives them. + The default is false. + proxy_header (google.cloud.compute_v1.types.TargetTcpProxy.ProxyHeader): + Specifies the type of proxy header to append before sending + data to the backend, either NONE or PROXY_V1. The default is + NONE. + self_link (str): + [Output Only] Server-defined URL for the resource. + service (str): + URL to the BackendService resource. + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + class ProxyHeader(proto.Enum): + r"""Specifies the type of proxy header to append before sending data to + the backend, either NONE or PROXY_V1. The default is NONE. + """ + UNDEFINED_PROXY_HEADER = 0 + NONE = 2402104 + PROXY_V1 = 334352940 - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + proxy_bind = proto.Field(proto.BOOL, number=286025582, optional=True,) + proxy_header = proto.Field( + proto.ENUM, number=160374142, optional=True, enum=ProxyHeader, + ) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + service = proto.Field(proto.STRING, number=373540533, optional=True,) - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Name of the project scoping this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. +class TargetTcpProxyList(proto.Message): + r"""Contains a list of TargetTcpProxy resources. + Attributes: + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.TargetTcpProxy]): + A list of TargetTcpProxy resources. + kind (str): + Type of resource. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + @property + def raw_page(self): + return self + + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="TargetTcpProxy", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class DeleteTargetHttpProxyRequest(proto.Message): - r"""A request message for TargetHttpProxies.Delete. See the - method description for details. +class TargetVpnGateway(proto.Message): + r"""Represents a Target VPN Gateway resource. The target VPN + gateway resource represents a Classic Cloud VPN gateway. For + more information, read the the Cloud VPN Overview. Attributes: - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_http_proxy (str): - Name of the TargetHttpProxy resource to - delete. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + forwarding_rules (Sequence[str]): + [Output Only] A list of URLs to the ForwardingRule + resources. ForwardingRules are created using + compute.forwardingRules.insert and associated with a VPN + gateway. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + kind (str): + [Output Only] Type of resource. Always + compute#targetVpnGateway for target VPN gateways. + name (str): + Name of the resource. Provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. + network (str): + URL of the network to which this VPN gateway + is attached. Provided by the client when the VPN + gateway is created. + region (str): + [Output Only] URL of the region where the target VPN gateway + resides. You must specify this field as part of the HTTP + request URL. It is not settable as a field in the request + body. + self_link (str): + [Output Only] Server-defined URL for the resource. + status (google.cloud.compute_v1.types.TargetVpnGateway.Status): + [Output Only] The status of the VPN gateway, which can be + one of the following: CREATING, READY, FAILED, or DELETING. + tunnels (Sequence[str]): + [Output Only] A list of URLs to VpnTunnel resources. + VpnTunnels are created using the compute.vpntunnels.insert + method and associated with a VPN gateway. """ - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_http_proxy = proto.Field(proto.STRING, number=206872421,) + class Status(proto.Enum): + r"""[Output Only] The status of the VPN gateway, which can be one of the + following: CREATING, READY, FAILED, or DELETING. + """ + UNDEFINED_STATUS = 0 + CREATING = 455564985 + DELETING = 528602024 + FAILED = 455706685 + READY = 77848963 + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + forwarding_rules = proto.RepeatedField(proto.STRING, number=315821365,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + network = proto.Field(proto.STRING, number=232872494, optional=True,) + region = proto.Field(proto.STRING, number=138946292, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) + tunnels = proto.RepeatedField(proto.STRING, number=104561931,) -class GetTargetHttpProxyRequest(proto.Message): - r"""A request message for TargetHttpProxies.Get. See the method - description for details. +class TargetVpnGatewayAggregatedList(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - target_http_proxy (str): - Name of the TargetHttpProxy resource to - return. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.TargetVpnGatewayAggregatedList.ItemsEntry]): + A list of TargetVpnGateway resources. + kind (str): + [Output Only] Type of resource. Always + compute#targetVpnGateway for target VPN gateways. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - project = proto.Field(proto.STRING, number=227560217,) - target_http_proxy = proto.Field(proto.STRING, number=206872421,) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.MapField( + proto.STRING, + proto.MESSAGE, + number=100526016, + message="TargetVpnGatewaysScopedList", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class InsertTargetHttpProxyRequest(proto.Message): - r"""A request message for TargetHttpProxies.Insert. See the - method description for details. +class TargetVpnGatewayList(proto.Message): + r"""Contains a list of TargetVpnGateway resources. Attributes: - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_http_proxy_resource (google.cloud.compute_v1.types.TargetHttpProxy): - The body resource for this request + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.TargetVpnGateway]): + A list of TargetVpnGateway resources. + kind (str): + [Output Only] Type of resource. Always + compute#targetVpnGateway for target VPN gateways. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_http_proxy_resource = proto.Field( - proto.MESSAGE, number=24696744, message="TargetHttpProxy", - ) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="TargetVpnGateway", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class ListTargetHttpProxiesRequest(proto.Message): - r"""A request message for TargetHttpProxies.List. See the method - description for details. +class TargetVpnGatewaysScopedList(proto.Message): + r""" Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + target_vpn_gateways (Sequence[google.cloud.compute_v1.types.TargetVpnGateway]): + [Output Only] A list of target VPN gateways contained in + this scope. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning which replaces the list + of addresses when the list is empty. + """ - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. + target_vpn_gateways = proto.RepeatedField( + proto.MESSAGE, number=401770888, message="TargetVpnGateway", + ) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. +class TestFailure(proto.Message): + r""" + Attributes: + actual_output_url (str): + The actual output URL evaluated by load + balancer containing the scheme, host, path and + query parameters. + actual_redirect_response_code (int): + Actual HTTP status code for rule with ``urlRedirect`` + calculated by load balancer + actual_service (str): + BackendService or BackendBucket returned by + load balancer. + expected_output_url (str): + The expected output URL evaluated by load + balancer containing the scheme, host, path and + query parameters. + expected_redirect_response_code (int): + Expected HTTP status code for rule with ``urlRedirect`` + calculated by load balancer + expected_service (str): + Expected BackendService or BackendBucket + resource the given URL should be mapped to. + headers (Sequence[google.cloud.compute_v1.types.UrlMapTestHeader]): + HTTP headers of the request. + host (str): + Host portion of the URL. + path (str): + Path portion including query parameters in + the URL. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + actual_output_url = proto.Field(proto.STRING, number=287075458, optional=True,) + actual_redirect_response_code = proto.Field( + proto.INT32, number=42926553, optional=True, + ) + actual_service = proto.Field(proto.STRING, number=440379652, optional=True,) + expected_output_url = proto.Field(proto.STRING, number=433967384, optional=True,) + expected_redirect_response_code = proto.Field( + proto.INT32, number=18888047, optional=True, + ) + expected_service = proto.Field(proto.STRING, number=133987374, optional=True,) + headers = proto.RepeatedField( + proto.MESSAGE, number=258436998, message="UrlMapTestHeader", + ) + host = proto.Field(proto.STRING, number=3208616, optional=True,) + path = proto.Field(proto.STRING, number=3433509, optional=True,) -class PatchTargetHttpProxyRequest(proto.Message): - r"""A request message for TargetHttpProxies.Patch. See the method - description for details. +class TestIamPermissionsDiskRequest(proto.Message): + r"""A request message for Disks.TestIamPermissions. See the + method description for details. Attributes: project (str): Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_http_proxy (str): - Name of the TargetHttpProxy resource to - patch. - target_http_proxy_resource (google.cloud.compute_v1.types.TargetHttpProxy): + resource (str): + Name or id of the resource for this request. + test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): The body resource for this request + zone (str): + The name of the zone for this request. """ project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_http_proxy = proto.Field(proto.STRING, number=206872421,) - target_http_proxy_resource = proto.Field( - proto.MESSAGE, number=24696744, message="TargetHttpProxy", + resource = proto.Field(proto.STRING, number=195806222,) + test_permissions_request_resource = proto.Field( + proto.MESSAGE, number=439214758, message="TestPermissionsRequest", ) + zone = proto.Field(proto.STRING, number=3744684,) -class SetUrlMapTargetHttpProxyRequest(proto.Message): - r"""A request message for TargetHttpProxies.SetUrlMap. See the - method description for details. +class TestIamPermissionsExternalVpnGatewayRequest(proto.Message): + r"""A request message for ExternalVpnGateways.TestIamPermissions. + See the method description for details. Attributes: project (str): Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_http_proxy (str): - Name of the TargetHttpProxy to set a URL map - for. - url_map_reference_resource (google.cloud.compute_v1.types.UrlMapReference): + resource (str): + Name or id of the resource for this request. + test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): The body resource for this request """ project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_http_proxy = proto.Field(proto.STRING, number=206872421,) - url_map_reference_resource = proto.Field( - proto.MESSAGE, number=398701333, message="UrlMapReference", + resource = proto.Field(proto.STRING, number=195806222,) + test_permissions_request_resource = proto.Field( + proto.MESSAGE, number=439214758, message="TestPermissionsRequest", ) -class AggregatedListTargetHttpsProxiesRequest(proto.Message): - r"""A request message for TargetHttpsProxies.AggregatedList. See - the method description for details. +class TestIamPermissionsFirewallPolicyRequest(proto.Message): + r"""A request message for FirewallPolicies.TestIamPermissions. + See the method description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Name of the project scoping this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + resource (str): + Name or id of the resource for this request. + test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): + The body resource for this request """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + resource = proto.Field(proto.STRING, number=195806222,) + test_permissions_request_resource = proto.Field( + proto.MESSAGE, number=439214758, message="TestPermissionsRequest", + ) -class DeleteTargetHttpsProxyRequest(proto.Message): - r"""A request message for TargetHttpsProxies.Delete. See the +class TestIamPermissionsImageRequest(proto.Message): + r"""A request message for Images.TestIamPermissions. See the method description for details. Attributes: project (str): Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_https_proxy (str): - Name of the TargetHttpsProxy resource to - delete. + resource (str): + Name or id of the resource for this request. + test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): + The body resource for this request """ project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_https_proxy = proto.Field(proto.STRING, number=52336748,) + resource = proto.Field(proto.STRING, number=195806222,) + test_permissions_request_resource = proto.Field( + proto.MESSAGE, number=439214758, message="TestPermissionsRequest", + ) -class GetTargetHttpsProxyRequest(proto.Message): - r"""A request message for TargetHttpsProxies.Get. See the method - description for details. +class TestIamPermissionsInstanceRequest(proto.Message): + r"""A request message for Instances.TestIamPermissions. See the + method description for details. Attributes: project (str): Project ID for this request. - target_https_proxy (str): - Name of the TargetHttpsProxy resource to - return. + resource (str): + Name or id of the resource for this request. + test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): + The body resource for this request + zone (str): + The name of the zone for this request. """ project = proto.Field(proto.STRING, number=227560217,) - target_https_proxy = proto.Field(proto.STRING, number=52336748,) + resource = proto.Field(proto.STRING, number=195806222,) + test_permissions_request_resource = proto.Field( + proto.MESSAGE, number=439214758, message="TestPermissionsRequest", + ) + zone = proto.Field(proto.STRING, number=3744684,) -class InsertTargetHttpsProxyRequest(proto.Message): - r"""A request message for TargetHttpsProxies.Insert. See the - method description for details. +class TestIamPermissionsInstanceTemplateRequest(proto.Message): + r"""A request message for InstanceTemplates.TestIamPermissions. + See the method description for details. Attributes: project (str): Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_https_proxy_resource (google.cloud.compute_v1.types.TargetHttpsProxy): + resource (str): + Name or id of the resource for this request. + test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): The body resource for this request """ project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_https_proxy_resource = proto.Field( - proto.MESSAGE, number=433657473, message="TargetHttpsProxy", + resource = proto.Field(proto.STRING, number=195806222,) + test_permissions_request_resource = proto.Field( + proto.MESSAGE, number=439214758, message="TestPermissionsRequest", ) -class ListTargetHttpsProxiesRequest(proto.Message): - r"""A request message for TargetHttpsProxies.List. See the method - description for details. +class TestIamPermissionsLicenseCodeRequest(proto.Message): + r"""A request message for LicenseCodes.TestIamPermissions. See + the method description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. project (str): Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + resource (str): + Name or id of the resource for this request. + test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): + The body resource for this request """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + resource = proto.Field(proto.STRING, number=195806222,) + test_permissions_request_resource = proto.Field( + proto.MESSAGE, number=439214758, message="TestPermissionsRequest", + ) -class PatchTargetHttpsProxyRequest(proto.Message): - r"""A request message for TargetHttpsProxies.Patch. See the +class TestIamPermissionsLicenseRequest(proto.Message): + r"""A request message for Licenses.TestIamPermissions. See the method description for details. Attributes: project (str): Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_https_proxy (str): - Name of the TargetHttpsProxy resource to - patch. - target_https_proxy_resource (google.cloud.compute_v1.types.TargetHttpsProxy): + resource (str): + Name or id of the resource for this request. + test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): The body resource for this request """ project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_https_proxy = proto.Field(proto.STRING, number=52336748,) - target_https_proxy_resource = proto.Field( - proto.MESSAGE, number=433657473, message="TargetHttpsProxy", + resource = proto.Field(proto.STRING, number=195806222,) + test_permissions_request_resource = proto.Field( + proto.MESSAGE, number=439214758, message="TestPermissionsRequest", ) -class SetQuicOverrideTargetHttpsProxyRequest(proto.Message): - r"""A request message for TargetHttpsProxies.SetQuicOverride. See - the method description for details. +class TestIamPermissionsNetworkEndpointGroupRequest(proto.Message): + r"""A request message for + NetworkEndpointGroups.TestIamPermissions. See the method + description for details. Attributes: project (str): Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_https_proxies_set_quic_override_request_resource (google.cloud.compute_v1.types.TargetHttpsProxiesSetQuicOverrideRequest): + resource (str): + Name or id of the resource for this request. + test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): The body resource for this request - target_https_proxy (str): - Name of the TargetHttpsProxy resource to set - the QUIC override policy for. The name should - conform to RFC1035. + zone (str): + The name of the zone for this request. """ project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_https_proxies_set_quic_override_request_resource = proto.Field( - proto.MESSAGE, - number=72940258, - message="TargetHttpsProxiesSetQuicOverrideRequest", + resource = proto.Field(proto.STRING, number=195806222,) + test_permissions_request_resource = proto.Field( + proto.MESSAGE, number=439214758, message="TestPermissionsRequest", ) - target_https_proxy = proto.Field(proto.STRING, number=52336748,) + zone = proto.Field(proto.STRING, number=3744684,) -class SetSslCertificatesTargetHttpsProxyRequest(proto.Message): - r"""A request message for TargetHttpsProxies.SetSslCertificates. - See the method description for details. +class TestIamPermissionsNodeGroupRequest(proto.Message): + r"""A request message for NodeGroups.TestIamPermissions. See the + method description for details. Attributes: project (str): Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_https_proxies_set_ssl_certificates_request_resource (google.cloud.compute_v1.types.TargetHttpsProxiesSetSslCertificatesRequest): + resource (str): + Name or id of the resource for this request. + test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): The body resource for this request - target_https_proxy (str): - Name of the TargetHttpsProxy resource to set - an SslCertificates resource for. + zone (str): + The name of the zone for this request. """ project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_https_proxies_set_ssl_certificates_request_resource = proto.Field( - proto.MESSAGE, - number=223122908, - message="TargetHttpsProxiesSetSslCertificatesRequest", + resource = proto.Field(proto.STRING, number=195806222,) + test_permissions_request_resource = proto.Field( + proto.MESSAGE, number=439214758, message="TestPermissionsRequest", ) - target_https_proxy = proto.Field(proto.STRING, number=52336748,) + zone = proto.Field(proto.STRING, number=3744684,) -class SetSslPolicyTargetHttpsProxyRequest(proto.Message): - r"""A request message for TargetHttpsProxies.SetSslPolicy. See +class TestIamPermissionsNodeTemplateRequest(proto.Message): + r"""A request message for NodeTemplates.TestIamPermissions. See the method description for details. Attributes: project (str): Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - ssl_policy_reference_resource (google.cloud.compute_v1.types.SslPolicyReference): + region (str): + The name of the region for this request. + resource (str): + Name or id of the resource for this request. + test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): The body resource for this request - target_https_proxy (str): - Name of the TargetHttpsProxy resource whose - SSL policy is to be set. The name must be 1-63 - characters long, and comply with RFC1035. """ project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - ssl_policy_reference_resource = proto.Field( - proto.MESSAGE, number=235403836, message="SslPolicyReference", + region = proto.Field(proto.STRING, number=138946292,) + resource = proto.Field(proto.STRING, number=195806222,) + test_permissions_request_resource = proto.Field( + proto.MESSAGE, number=439214758, message="TestPermissionsRequest", ) - target_https_proxy = proto.Field(proto.STRING, number=52336748,) -class SetUrlMapTargetHttpsProxyRequest(proto.Message): - r"""A request message for TargetHttpsProxies.SetUrlMap. See the - method description for details. +class TestIamPermissionsPacketMirroringRequest(proto.Message): + r"""A request message for PacketMirrorings.TestIamPermissions. + See the method description for details. Attributes: project (str): Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_https_proxy (str): - Name of the TargetHttpsProxy resource whose - URL map is to be set. - url_map_reference_resource (google.cloud.compute_v1.types.UrlMapReference): + region (str): + The name of the region for this request. + resource (str): + Name or id of the resource for this request. + test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): The body resource for this request """ project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_https_proxy = proto.Field(proto.STRING, number=52336748,) - url_map_reference_resource = proto.Field( - proto.MESSAGE, number=398701333, message="UrlMapReference", + region = proto.Field(proto.STRING, number=138946292,) + resource = proto.Field(proto.STRING, number=195806222,) + test_permissions_request_resource = proto.Field( + proto.MESSAGE, number=439214758, message="TestPermissionsRequest", ) -class AggregatedListTargetInstancesRequest(proto.Message): - r"""A request message for TargetInstances.AggregatedList. See the +class TestIamPermissionsRegionDiskRequest(proto.Message): + r"""A request message for RegionDisks.TestIamPermissions. See the method description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. project (str): Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + region (str): + The name of the region for this request. + resource (str): + Name or id of the resource for this request. + test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): + The body resource for this request """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + region = proto.Field(proto.STRING, number=138946292,) + resource = proto.Field(proto.STRING, number=195806222,) + test_permissions_request_resource = proto.Field( + proto.MESSAGE, number=439214758, message="TestPermissionsRequest", + ) -class DeleteTargetInstanceRequest(proto.Message): - r"""A request message for TargetInstances.Delete. See the method - description for details. +class TestIamPermissionsReservationRequest(proto.Message): + r"""A request message for Reservations.TestIamPermissions. See + the method description for details. Attributes: project (str): Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_instance (str): - Name of the TargetInstance resource to - delete. + resource (str): + Name or id of the resource for this request. + test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): + The body resource for this request zone (str): - Name of the zone scoping this request. + The name of the zone for this request. """ project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_instance = proto.Field(proto.STRING, number=289769347,) + resource = proto.Field(proto.STRING, number=195806222,) + test_permissions_request_resource = proto.Field( + proto.MESSAGE, number=439214758, message="TestPermissionsRequest", + ) zone = proto.Field(proto.STRING, number=3744684,) -class GetTargetInstanceRequest(proto.Message): - r"""A request message for TargetInstances.Get. See the method - description for details. +class TestIamPermissionsResourcePolicyRequest(proto.Message): + r"""A request message for ResourcePolicies.TestIamPermissions. + See the method description for details. Attributes: project (str): Project ID for this request. - target_instance (str): - Name of the TargetInstance resource to - return. - zone (str): - Name of the zone scoping this request. + region (str): + The name of the region for this request. + resource (str): + Name or id of the resource for this request. + test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): + The body resource for this request """ project = proto.Field(proto.STRING, number=227560217,) - target_instance = proto.Field(proto.STRING, number=289769347,) - zone = proto.Field(proto.STRING, number=3744684,) + region = proto.Field(proto.STRING, number=138946292,) + resource = proto.Field(proto.STRING, number=195806222,) + test_permissions_request_resource = proto.Field( + proto.MESSAGE, number=439214758, message="TestPermissionsRequest", + ) -class InsertTargetInstanceRequest(proto.Message): - r"""A request message for TargetInstances.Insert. See the method - description for details. +class TestIamPermissionsServiceAttachmentRequest(proto.Message): + r"""A request message for ServiceAttachments.TestIamPermissions. + See the method description for details. Attributes: project (str): Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_instance_resource (google.cloud.compute_v1.types.TargetInstance): + region (str): + The name of the region for this request. + resource (str): + Name or id of the resource for this request. + test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): The body resource for this request - zone (str): - Name of the zone scoping this request. """ project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_instance_resource = proto.Field( - proto.MESSAGE, number=430453066, message="TargetInstance", + region = proto.Field(proto.STRING, number=138946292,) + resource = proto.Field(proto.STRING, number=195806222,) + test_permissions_request_resource = proto.Field( + proto.MESSAGE, number=439214758, message="TestPermissionsRequest", ) - zone = proto.Field(proto.STRING, number=3744684,) -class ListTargetInstancesRequest(proto.Message): - r"""A request message for TargetInstances.List. See the method - description for details. +class TestIamPermissionsSnapshotRequest(proto.Message): + r"""A request message for Snapshots.TestIamPermissions. See the + method description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. project (str): Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. - zone (str): - Name of the zone scoping this request. + resource (str): + Name or id of the resource for this request. + test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): + The body resource for this request """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + resource = proto.Field(proto.STRING, number=195806222,) + test_permissions_request_resource = proto.Field( + proto.MESSAGE, number=439214758, message="TestPermissionsRequest", + ) -class AddHealthCheckTargetPoolRequest(proto.Message): - r"""A request message for TargetPools.AddHealthCheck. See the +class TestIamPermissionsSubnetworkRequest(proto.Message): + r"""A request message for Subnetworks.TestIamPermissions. See the method description for details. Attributes: project (str): Project ID for this request. - region (str): - Name of the region scoping this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_pool (str): - Name of the target pool to add a health check - to. - target_pools_add_health_check_request_resource (google.cloud.compute_v1.types.TargetPoolsAddHealthCheckRequest): + region (str): + The name of the region for this request. + resource (str): + Name or id of the resource for this request. + test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): The body resource for this request """ project = proto.Field(proto.STRING, number=227560217,) region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_pool = proto.Field(proto.STRING, number=62796298,) - target_pools_add_health_check_request_resource = proto.Field( - proto.MESSAGE, number=269573412, message="TargetPoolsAddHealthCheckRequest", + resource = proto.Field(proto.STRING, number=195806222,) + test_permissions_request_resource = proto.Field( + proto.MESSAGE, number=439214758, message="TestPermissionsRequest", ) -class AddInstanceTargetPoolRequest(proto.Message): - r"""A request message for TargetPools.AddInstance. See the method - description for details. +class TestIamPermissionsVpnGatewayRequest(proto.Message): + r"""A request message for VpnGateways.TestIamPermissions. See the + method description for details. Attributes: project (str): Project ID for this request. region (str): - Name of the region scoping this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_pool (str): - Name of the TargetPool resource to add - instances to. - target_pools_add_instance_request_resource (google.cloud.compute_v1.types.TargetPoolsAddInstanceRequest): + The name of the region for this request. + resource (str): + Name or id of the resource for this request. + test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): The body resource for this request """ project = proto.Field(proto.STRING, number=227560217,) region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_pool = proto.Field(proto.STRING, number=62796298,) - target_pools_add_instance_request_resource = proto.Field( - proto.MESSAGE, number=428796404, message="TargetPoolsAddInstanceRequest", + resource = proto.Field(proto.STRING, number=195806222,) + test_permissions_request_resource = proto.Field( + proto.MESSAGE, number=439214758, message="TestPermissionsRequest", ) -class AggregatedListTargetPoolsRequest(proto.Message): - r"""A request message for TargetPools.AggregatedList. See the - method description for details. +class TestPermissionsRequest(proto.Message): + r""" + Attributes: + permissions (Sequence[str]): + The set of permissions to check for the 'resource'. + Permissions with wildcards (such as '*' or 'storage.*') are + not allowed. + """ + permissions = proto.RepeatedField(proto.STRING, number=59962500,) + + +class TestPermissionsResponse(proto.Message): + r""" Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. + permissions (Sequence[str]): + A subset of ``TestPermissionsRequest.permissions`` that the + caller is allowed. + """ - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + permissions = proto.RepeatedField(proto.STRING, number=59962500,) - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. +class Uint128(proto.Message): + r""" + Attributes: + high (int): - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. + low (int): - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + high = proto.Field(proto.UINT64, number=3202466, optional=True,) + low = proto.Field(proto.UINT64, number=107348, optional=True,) -class DeleteTargetPoolRequest(proto.Message): - r"""A request message for TargetPools.Delete. See the method - description for details. +class UpdateAccessConfigInstanceRequest(proto.Message): + r"""A request message for Instances.UpdateAccessConfig. See the + method description for details. Attributes: + access_config_resource (google.cloud.compute_v1.types.AccessConfig): + The body resource for this request + instance (str): + The instance name for this request. + network_interface (str): + The name of the network interface where the + access config is attached. project (str): Project ID for this request. - region (str): - Name of the region scoping this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_pool (str): - Name of the TargetPool resource to delete. + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. """ + access_config_resource = proto.Field( + proto.MESSAGE, number=387825552, message="AccessConfig", + ) + instance = proto.Field(proto.STRING, number=18257045,) + network_interface = proto.Field(proto.STRING, number=365387880,) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_pool = proto.Field(proto.STRING, number=62796298,) - - -class GetTargetPoolRequest(proto.Message): - r"""A request message for TargetPools.Get. See the method - description for details. - - Attributes: - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - target_pool (str): - Name of the TargetPool resource to return. - """ - - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - target_pool = proto.Field(proto.STRING, number=62796298,) + zone = proto.Field(proto.STRING, number=3744684,) -class GetHealthTargetPoolRequest(proto.Message): - r"""A request message for TargetPools.GetHealth. See the method +class UpdateAutoscalerRequest(proto.Message): + r"""A request message for Autoscalers.Update. See the method description for details. Attributes: - instance_reference_resource (google.cloud.compute_v1.types.InstanceReference): + autoscaler (str): + Name of the autoscaler to update. + autoscaler_resource (google.cloud.compute_v1.types.Autoscaler): The body resource for this request project (str): Project ID for this request. - region (str): - Name of the region scoping this request. - target_pool (str): - Name of the TargetPool resource to which the - queried instance belongs. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + Name of the zone for this request. """ - instance_reference_resource = proto.Field( - proto.MESSAGE, number=292926060, message="InstanceReference", + autoscaler = proto.Field(proto.STRING, number=517258967, optional=True,) + autoscaler_resource = proto.Field( + proto.MESSAGE, number=207616118, message="Autoscaler", ) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - target_pool = proto.Field(proto.STRING, number=62796298,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class InsertTargetPoolRequest(proto.Message): - r"""A request message for TargetPools.Insert. See the method +class UpdateBackendBucketRequest(proto.Message): + r"""A request message for BackendBuckets.Update. See the method description for details. Attributes: + backend_bucket (str): + Name of the BackendBucket resource to update. + backend_bucket_resource (google.cloud.compute_v1.types.BackendBucket): + The body resource for this request project (str): Project ID for this request. - region (str): - Name of the region scoping this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_pool_resource (google.cloud.compute_v1.types.TargetPool): - The body resource for this request + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ + backend_bucket = proto.Field(proto.STRING, number=91714037,) + backend_bucket_resource = proto.Field( + proto.MESSAGE, number=380757784, message="BackendBucket", + ) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_pool_resource = proto.Field( - proto.MESSAGE, number=101281443, message="TargetPool", - ) -class ListTargetPoolsRequest(proto.Message): - r"""A request message for TargetPools.List. See the method +class UpdateBackendServiceRequest(proto.Message): + r"""A request message for BackendServices.Update. See the method description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - region (str): - Name of the region scoping this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. - """ - - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - - -class RemoveHealthCheckTargetPoolRequest(proto.Message): - r"""A request message for TargetPools.RemoveHealthCheck. See the - method description for details. - - Attributes: + backend_service (str): + Name of the BackendService resource to + update. + backend_service_resource (google.cloud.compute_v1.types.BackendService): + The body resource for this request project (str): Project ID for this request. - region (str): - Name of the region for this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_pool (str): - Name of the target pool to remove health - checks from. - target_pools_remove_health_check_request_resource (google.cloud.compute_v1.types.TargetPoolsRemoveHealthCheckRequest): - The body resource for this request + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ + backend_service = proto.Field(proto.STRING, number=306946058,) + backend_service_resource = proto.Field( + proto.MESSAGE, number=347586723, message="BackendService", + ) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_pool = proto.Field(proto.STRING, number=62796298,) - target_pools_remove_health_check_request_resource = proto.Field( - proto.MESSAGE, number=304985011, message="TargetPoolsRemoveHealthCheckRequest", - ) -class RemoveInstanceTargetPoolRequest(proto.Message): - r"""A request message for TargetPools.RemoveInstance. See the +class UpdateDisplayDeviceInstanceRequest(proto.Message): + r"""A request message for Instances.UpdateDisplayDevice. See the method description for details. Attributes: + display_device_resource (google.cloud.compute_v1.types.DisplayDevice): + The body resource for this request + instance (str): + Name of the instance scoping this request. project (str): Project ID for this request. - region (str): - Name of the region scoping this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_pool (str): - Name of the TargetPool resource to remove - instances from. - target_pools_remove_instance_request_resource (google.cloud.compute_v1.types.TargetPoolsRemoveInstanceRequest): - The body resource for this request + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. """ + display_device_resource = proto.Field( + proto.MESSAGE, number=289686106, message="DisplayDevice", + ) + instance = proto.Field(proto.STRING, number=18257045,) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_pool = proto.Field(proto.STRING, number=62796298,) - target_pools_remove_instance_request_resource = proto.Field( - proto.MESSAGE, number=29548547, message="TargetPoolsRemoveInstanceRequest", - ) + zone = proto.Field(proto.STRING, number=3744684,) -class SetBackupTargetPoolRequest(proto.Message): - r"""A request message for TargetPools.SetBackup. See the method +class UpdateFirewallRequest(proto.Message): + r"""A request message for Firewalls.Update. See the method description for details. Attributes: - failover_ratio (float): - New failoverRatio value for the target pool. + firewall (str): + Name of the firewall rule to update. + firewall_resource (google.cloud.compute_v1.types.Firewall): + The body resource for this request project (str): Project ID for this request. - region (str): - Name of the region scoping this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_pool (str): - Name of the TargetPool resource to set a - backup pool for. - target_reference_resource (google.cloud.compute_v1.types.TargetReference): - The body resource for this request + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ - failover_ratio = proto.Field(proto.FLOAT, number=212667006, optional=True,) + firewall = proto.Field(proto.STRING, number=511016192,) + firewall_resource = proto.Field(proto.MESSAGE, number=41425005, message="Firewall",) project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_pool = proto.Field(proto.STRING, number=62796298,) - target_reference_resource = proto.Field( - proto.MESSAGE, number=523721712, message="TargetReference", - ) -class DeleteTargetSslProxyRequest(proto.Message): - r"""A request message for TargetSslProxies.Delete. See the method +class UpdateHealthCheckRequest(proto.Message): + r"""A request message for HealthChecks.Update. See the method description for details. Attributes: + health_check (str): + Name of the HealthCheck resource to update. + health_check_resource (google.cloud.compute_v1.types.HealthCheck): + The body resource for this request project (str): Project ID for this request. request_id (str): @@ -47272,48 +46527,95 @@ class DeleteTargetSslProxyRequest(proto.Message): Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_ssl_proxy (str): - Name of the TargetSslProxy resource to - delete. + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ + health_check = proto.Field(proto.STRING, number=308876645,) + health_check_resource = proto.Field( + proto.MESSAGE, number=201925032, message="HealthCheck", + ) project = proto.Field(proto.STRING, number=227560217,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_ssl_proxy = proto.Field(proto.STRING, number=338795853,) -class GetTargetSslProxyRequest(proto.Message): - r"""A request message for TargetSslProxies.Get. See the method +class UpdateInstanceRequest(proto.Message): + r"""A request message for Instances.Update. See the method description for details. Attributes: + instance (str): + Name of the instance resource to update. + instance_resource (google.cloud.compute_v1.types.Instance): + The body resource for this request + minimal_action (str): + Specifies the action to take when updating an + instance even if the updated properties do not + require it. If not specified, then Compute + Engine acts based on the minimum action that the + updated properties require. + most_disruptive_allowed_action (str): + Specifies the most disruptive action that can be taken on + the instance as part of the update. Compute Engine returns + an error if the instance properties require a more + disruptive action as part of the instance update. Valid + options from lowest to highest are NO_EFFECT, REFRESH, and + RESTART. project (str): Project ID for this request. - target_ssl_proxy (str): - Name of the TargetSslProxy resource to - return. + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. """ + instance = proto.Field(proto.STRING, number=18257045,) + instance_resource = proto.Field( + proto.MESSAGE, number=215988344, message="Instance", + ) + minimal_action = proto.Field(proto.STRING, number=270567060, optional=True,) + most_disruptive_allowed_action = proto.Field( + proto.STRING, number=66103053, optional=True, + ) project = proto.Field(proto.STRING, number=227560217,) - target_ssl_proxy = proto.Field(proto.STRING, number=338795853,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class InsertTargetSslProxyRequest(proto.Message): - r"""A request message for TargetSslProxies.Insert. See the method - description for details. +class UpdateNetworkInterfaceInstanceRequest(proto.Message): + r"""A request message for Instances.UpdateNetworkInterface. See + the method description for details. Attributes: + instance (str): + The instance name for this request. + network_interface (str): + The name of the network interface to update. + network_interface_resource (google.cloud.compute_v1.types.NetworkInterface): + The body resource for this request project (str): Project ID for this request. request_id (str): @@ -47321,105 +46623,80 @@ class InsertTargetSslProxyRequest(proto.Message): Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_ssl_proxy_resource (google.cloud.compute_v1.types.TargetSslProxy): - The body resource for this request + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone for this request. """ + instance = proto.Field(proto.STRING, number=18257045,) + network_interface = proto.Field(proto.STRING, number=365387880,) + network_interface_resource = proto.Field( + proto.MESSAGE, number=325814789, message="NetworkInterface", + ) project = proto.Field(proto.STRING, number=227560217,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_ssl_proxy_resource = proto.Field( - proto.MESSAGE, number=142016192, message="TargetSslProxy", - ) + zone = proto.Field(proto.STRING, number=3744684,) -class ListTargetSslProxiesRequest(proto.Message): - r"""A request message for TargetSslProxies.List. See the method +class UpdatePeeringNetworkRequest(proto.Message): + r"""A request message for Networks.UpdatePeering. See the method description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. + network (str): + Name of the network resource which the + updated peering is belonging to. + networks_update_peering_request_resource (google.cloud.compute_v1.types.NetworksUpdatePeeringRequest): + The body resource for this request project (str): Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. - """ - - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + request_id (str): + An optional request ID to identify requests. + Specify a unique request ID so that if you must + retry your request, the server will know to + ignore the request if it has already been + completed. For example, consider a situation + where you make an initial request and the + request times out. If you make the request again + with the same request ID, the server can check + if original operation with the same request ID + was received, and if so, will ignore the second + request. This prevents clients from accidentally + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + """ + + network = proto.Field(proto.STRING, number=232872494,) + networks_update_peering_request_resource = proto.Field( + proto.MESSAGE, number=224433497, message="NetworksUpdatePeeringRequest", + ) project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class SetBackendServiceTargetSslProxyRequest(proto.Message): - r"""A request message for TargetSslProxies.SetBackendService. See - the method description for details. +class UpdatePerInstanceConfigsInstanceGroupManagerRequest(proto.Message): + r"""A request message for + InstanceGroupManagers.UpdatePerInstanceConfigs. See the method + description for details. Attributes: + instance_group_manager (str): + The name of the managed instance group. It + should conform to RFC1035. + instance_group_managers_update_per_instance_configs_req_resource (google.cloud.compute_v1.types.InstanceGroupManagersUpdatePerInstanceConfigsReq): + The body resource for this request project (str): Project ID for this request. request_id (str): @@ -47427,313 +46704,271 @@ class SetBackendServiceTargetSslProxyRequest(proto.Message): Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_ssl_proxies_set_backend_service_request_resource (google.cloud.compute_v1.types.TargetSslProxiesSetBackendServiceRequest): - The body resource for this request - target_ssl_proxy (str): - Name of the TargetSslProxy resource whose - BackendService resource is to be set. + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + zone (str): + The name of the zone where the managed + instance group is located. It should conform to + RFC1035. """ - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_ssl_proxies_set_backend_service_request_resource = proto.Field( + instance_group_manager = proto.Field(proto.STRING, number=249363395,) + instance_group_managers_update_per_instance_configs_req_resource = proto.Field( proto.MESSAGE, - number=139080868, - message="TargetSslProxiesSetBackendServiceRequest", + number=141402302, + message="InstanceGroupManagersUpdatePerInstanceConfigsReq", ) - target_ssl_proxy = proto.Field(proto.STRING, number=338795853,) + project = proto.Field(proto.STRING, number=227560217,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + zone = proto.Field(proto.STRING, number=3744684,) -class SetProxyHeaderTargetSslProxyRequest(proto.Message): - r"""A request message for TargetSslProxies.SetProxyHeader. See - the method description for details. +class UpdatePerInstanceConfigsRegionInstanceGroupManagerRequest(proto.Message): + r"""A request message for + RegionInstanceGroupManagers.UpdatePerInstanceConfigs. See the + method description for details. Attributes: + instance_group_manager (str): + The name of the managed instance group. It + should conform to RFC1035. project (str): Project ID for this request. + region (str): + Name of the region scoping this request, + should conform to RFC1035. + region_instance_group_manager_update_instance_config_req_resource (google.cloud.compute_v1.types.RegionInstanceGroupManagerUpdateInstanceConfigReq): + The body resource for this request request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_ssl_proxies_set_proxy_header_request_resource (google.cloud.compute_v1.types.TargetSslProxiesSetProxyHeaderRequest): - The body resource for this request - target_ssl_proxy (str): - Name of the TargetSslProxy resource whose - ProxyHeader is to be set. + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ + instance_group_manager = proto.Field(proto.STRING, number=249363395,) project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_ssl_proxies_set_proxy_header_request_resource = proto.Field( + region = proto.Field(proto.STRING, number=138946292,) + region_instance_group_manager_update_instance_config_req_resource = proto.Field( proto.MESSAGE, - number=205284526, - message="TargetSslProxiesSetProxyHeaderRequest", + number=89036583, + message="RegionInstanceGroupManagerUpdateInstanceConfigReq", ) - target_ssl_proxy = proto.Field(proto.STRING, number=338795853,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) -class SetSslCertificatesTargetSslProxyRequest(proto.Message): - r"""A request message for TargetSslProxies.SetSslCertificates. - See the method description for details. +class UpdateRegionAutoscalerRequest(proto.Message): + r"""A request message for RegionAutoscalers.Update. See the + method description for details. Attributes: + autoscaler (str): + Name of the autoscaler to update. + autoscaler_resource (google.cloud.compute_v1.types.Autoscaler): + The body resource for this request project (str): Project ID for this request. + region (str): + Name of the region scoping this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_ssl_proxies_set_ssl_certificates_request_resource (google.cloud.compute_v1.types.TargetSslProxiesSetSslCertificatesRequest): - The body resource for this request - target_ssl_proxy (str): - Name of the TargetSslProxy resource whose - SslCertificate resource is to be set. + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ + autoscaler = proto.Field(proto.STRING, number=517258967, optional=True,) + autoscaler_resource = proto.Field( + proto.MESSAGE, number=207616118, message="Autoscaler", + ) project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_ssl_proxies_set_ssl_certificates_request_resource = proto.Field( - proto.MESSAGE, - number=147940797, - message="TargetSslProxiesSetSslCertificatesRequest", - ) - target_ssl_proxy = proto.Field(proto.STRING, number=338795853,) -class SetSslPolicyTargetSslProxyRequest(proto.Message): - r"""A request message for TargetSslProxies.SetSslPolicy. See the +class UpdateRegionBackendServiceRequest(proto.Message): + r"""A request message for RegionBackendServices.Update. See the method description for details. Attributes: + backend_service (str): + Name of the BackendService resource to + update. + backend_service_resource (google.cloud.compute_v1.types.BackendService): + The body resource for this request project (str): Project ID for this request. + region (str): + Name of the region scoping this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - ssl_policy_reference_resource (google.cloud.compute_v1.types.SslPolicyReference): - The body resource for this request - target_ssl_proxy (str): - Name of the TargetSslProxy resource whose SSL - policy is to be set. The name must be 1-63 - characters long, and comply with RFC1035. + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ + backend_service = proto.Field(proto.STRING, number=306946058,) + backend_service_resource = proto.Field( + proto.MESSAGE, number=347586723, message="BackendService", + ) project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - ssl_policy_reference_resource = proto.Field( - proto.MESSAGE, number=235403836, message="SslPolicyReference", - ) - target_ssl_proxy = proto.Field(proto.STRING, number=338795853,) -class DeleteTargetTcpProxyRequest(proto.Message): - r"""A request message for TargetTcpProxies.Delete. See the method - description for details. +class UpdateRegionHealthCheckRequest(proto.Message): + r"""A request message for RegionHealthChecks.Update. See the + method description for details. Attributes: + health_check (str): + Name of the HealthCheck resource to update. + health_check_resource (google.cloud.compute_v1.types.HealthCheck): + The body resource for this request project (str): Project ID for this request. + region (str): + Name of the region scoping this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_tcp_proxy (str): - Name of the TargetTcpProxy resource to - delete. + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). """ + health_check = proto.Field(proto.STRING, number=308876645,) + health_check_resource = proto.Field( + proto.MESSAGE, number=201925032, message="HealthCheck", + ) project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_tcp_proxy = proto.Field(proto.STRING, number=503065442,) -class GetTargetTcpProxyRequest(proto.Message): - r"""A request message for TargetTcpProxies.Get. See the method +class UpdateRegionUrlMapRequest(proto.Message): + r"""A request message for RegionUrlMaps.Update. See the method description for details. Attributes: project (str): Project ID for this request. - target_tcp_proxy (str): - Name of the TargetTcpProxy resource to - return. + region (str): + Name of the region scoping this request. + request_id (str): + begin_interface: MixerMutationRequestBuilder Request ID to + support idempotency. + url_map (str): + Name of the UrlMap resource to update. + url_map_resource (google.cloud.compute_v1.types.UrlMap): + The body resource for this request """ project = proto.Field(proto.STRING, number=227560217,) - target_tcp_proxy = proto.Field(proto.STRING, number=503065442,) + region = proto.Field(proto.STRING, number=138946292,) + request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + url_map = proto.Field(proto.STRING, number=367020684,) + url_map_resource = proto.Field(proto.MESSAGE, number=168675425, message="UrlMap",) -class InsertTargetTcpProxyRequest(proto.Message): - r"""A request message for TargetTcpProxies.Insert. See the method +class UpdateRouterRequest(proto.Message): + r"""A request message for Routers.Update. See the method description for details. Attributes: project (str): Project ID for this request. + region (str): + Name of the region for this request. request_id (str): An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_tcp_proxy_resource (google.cloud.compute_v1.types.TargetTcpProxy): + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + router (str): + Name of the Router resource to update. + router_resource (google.cloud.compute_v1.types.Router): The body resource for this request """ project = proto.Field(proto.STRING, number=227560217,) + region = proto.Field(proto.STRING, number=138946292,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_tcp_proxy_resource = proto.Field( - proto.MESSAGE, number=145913931, message="TargetTcpProxy", - ) - - -class ListTargetTcpProxiesRequest(proto.Message): - r"""A request message for TargetTcpProxies.List. See the method - description for details. - - Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. - """ - - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + router = proto.Field(proto.STRING, number=148608841,) + router_resource = proto.Field(proto.MESSAGE, number=155222084, message="Router",) -class SetBackendServiceTargetTcpProxyRequest(proto.Message): - r"""A request message for TargetTcpProxies.SetBackendService. See - the method description for details. +class UpdateShieldedInstanceConfigInstanceRequest(proto.Message): + r"""A request message for Instances.UpdateShieldedInstanceConfig. + See the method description for details. Attributes: + instance (str): + Name or id of the instance scoping this + request. project (str): Project ID for this request. request_id (str): @@ -47741,37 +46976,35 @@ class SetBackendServiceTargetTcpProxyRequest(proto.Message): Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_tcp_proxies_set_backend_service_request_resource (google.cloud.compute_v1.types.TargetTcpProxiesSetBackendServiceRequest): + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + shielded_instance_config_resource (google.cloud.compute_v1.types.ShieldedInstanceConfig): The body resource for this request - target_tcp_proxy (str): - Name of the TargetTcpProxy resource whose - BackendService resource is to be set. + zone (str): + The name of the zone for this request. """ + instance = proto.Field(proto.STRING, number=18257045,) project = proto.Field(proto.STRING, number=227560217,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_tcp_proxies_set_backend_service_request_resource = proto.Field( - proto.MESSAGE, - number=273721583, - message="TargetTcpProxiesSetBackendServiceRequest", + shielded_instance_config_resource = proto.Field( + proto.MESSAGE, number=272059224, message="ShieldedInstanceConfig", ) - target_tcp_proxy = proto.Field(proto.STRING, number=503065442,) + zone = proto.Field(proto.STRING, number=3744684,) -class SetProxyHeaderTargetTcpProxyRequest(proto.Message): - r"""A request message for TargetTcpProxies.SetProxyHeader. See - the method description for details. +class UpdateUrlMapRequest(proto.Message): + r"""A request message for UrlMaps.Update. See the method + description for details. Attributes: project (str): @@ -47781,623 +47014,566 @@ class SetProxyHeaderTargetTcpProxyRequest(proto.Message): Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been - completed. For example, consider a situation + completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_tcp_proxies_set_proxy_header_request_resource (google.cloud.compute_v1.types.TargetTcpProxiesSetProxyHeaderRequest): + creating duplicate commitments. The request ID + must be a valid UUID with the exception that + zero UUID is not supported ( + 00000000-0000-0000-0000-000000000000). + url_map (str): + Name of the UrlMap resource to update. + url_map_resource (google.cloud.compute_v1.types.UrlMap): The body resource for this request - target_tcp_proxy (str): - Name of the TargetTcpProxy resource whose - ProxyHeader is to be set. """ project = proto.Field(proto.STRING, number=227560217,) request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_tcp_proxies_set_proxy_header_request_resource = proto.Field( - proto.MESSAGE, - number=219958339, - message="TargetTcpProxiesSetProxyHeaderRequest", - ) - target_tcp_proxy = proto.Field(proto.STRING, number=503065442,) + url_map = proto.Field(proto.STRING, number=367020684,) + url_map_resource = proto.Field(proto.MESSAGE, number=168675425, message="UrlMap",) -class AggregatedListTargetVpnGatewaysRequest(proto.Message): - r"""A request message for TargetVpnGateways.AggregatedList. See - the method description for details. +class UrlMap(proto.Message): + r"""Represents a URL Map resource. Google Compute Engine has two URL Map + resources: \* `Global `__ + \* `Regional `__ A + URL map resource is a component of certain types of GCP load + balancers and Traffic Director. \* urlMaps are used by external + HTTP(S) load balancers and Traffic Director. \* regionUrlMaps are + used by internal HTTP(S) load balancers. For a list of supported URL + map features by load balancer type, see the Load balancing features: + Routing and traffic management table. For a list of supported URL + map features for Traffic Director, see the Traffic Director + features: Routing and traffic management table. This resource + defines mappings from host names and URL paths to either a backend + service or a backend bucket. To use the global urlMaps resource, the + backend service must have a loadBalancingScheme of either EXTERNAL + or INTERNAL_SELF_MANAGED. To use the regionUrlMaps resource, the + backend service must have a loadBalancingScheme of INTERNAL_MANAGED. + For more information, read URL Map Concepts. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + default_route_action (google.cloud.compute_v1.types.HttpRouteAction): + defaultRouteAction takes effect when none of + the hostRules match. The load balancer performs + advanced routing actions like URL rewrites, + header transformations, etc. prior to forwarding + the request to the selected backend. If + defaultRouteAction specifies any + weightedBackendServices, defaultService must not + be set. Conversely if defaultService is set, + defaultRouteAction cannot contain any + weightedBackendServices. Only one of + defaultRouteAction or defaultUrlRedirect must be + set. UrlMaps for external HTTP(S) load balancers + support only the urlRewrite action within + defaultRouteAction. defaultRouteAction has no + effect when the URL map is bound to target gRPC + proxy that has validateForProxyless field set to + true. + default_service (str): + The full or partial URL of the defaultService + resource to which traffic is directed if none of + the hostRules match. If defaultRouteAction is + additionally specified, advanced routing actions + like URL Rewrites, etc. take effect prior to + sending the request to the backend. However, if + defaultService is specified, defaultRouteAction + cannot contain any weightedBackendServices. + Conversely, if routeAction specifies any + weightedBackendServices, service must not be + specified. Only one of defaultService, + defaultUrlRedirect or + defaultRouteAction.weightedBackendService must + be set. defaultService has no effect when the + URL map is bound to target gRPC proxy that has + validateForProxyless field set to true. + default_url_redirect (google.cloud.compute_v1.types.HttpRedirectAction): + When none of the specified hostRules match, + the request is redirected to a URL specified by + defaultUrlRedirect. If defaultUrlRedirect is + specified, defaultService or defaultRouteAction + must not be set. Not supported when the URL map + is bound to target gRPC proxy. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + fingerprint (str): + Fingerprint of this resource. A hash of the + contents stored in this object. This field is + used in optimistic locking. This field will be + ignored when inserting a UrlMap. An up-to-date + fingerprint must be provided in order to update + the UrlMap, otherwise the request will fail with + error 412 conditionNotMet. To see the latest + fingerprint, make a get() request to retrieve a + UrlMap. + header_action (google.cloud.compute_v1.types.HttpHeaderAction): + Specifies changes to request and response + headers that need to take effect for the + selected backendService. The headerAction + specified here take effect after headerAction + specified under pathMatcher. Note that + headerAction is not supported for Loadbalancers + that have their loadBalancingScheme set to + EXTERNAL. Not supported when the URL map is + bound to target gRPC proxy that has + validateForProxyless field set to true. + host_rules (Sequence[google.cloud.compute_v1.types.HostRule]): + The list of HostRules to use against the URL. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + kind (str): + [Output Only] Type of the resource. Always compute#urlMaps + for url maps. + name (str): + Name of the resource. Provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. + path_matchers (Sequence[google.cloud.compute_v1.types.PathMatcher]): + The list of named PathMatchers to use against + the URL. + region (str): + [Output Only] URL of the region where the regional URL map + resides. This field is not applicable to global URL maps. + You must specify this field as part of the HTTP request URL. + It is not settable as a field in the request body. + self_link (str): + [Output Only] Server-defined URL for the resource. + tests (Sequence[google.cloud.compute_v1.types.UrlMapTest]): + The list of expected URL mapping tests. + Request to update this UrlMap will succeed only + if all of the test cases pass. You can specify a + maximum of 100 tests per UrlMap. Not supported + when the URL map is bound to target gRPC proxy + that has validateForProxyless field set to true. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + default_route_action = proto.Field( + proto.MESSAGE, number=378919466, optional=True, message="HttpRouteAction", + ) + default_service = proto.Field(proto.STRING, number=370242231, optional=True,) + default_url_redirect = proto.Field( + proto.MESSAGE, number=359503338, optional=True, message="HttpRedirectAction", + ) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + fingerprint = proto.Field(proto.STRING, number=234678500, optional=True,) + header_action = proto.Field( + proto.MESSAGE, number=328077352, optional=True, message="HttpHeaderAction", + ) + host_rules = proto.RepeatedField( + proto.MESSAGE, number=311804832, message="HostRule", + ) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + path_matchers = proto.RepeatedField( + proto.MESSAGE, number=271664219, message="PathMatcher", + ) + region = proto.Field(proto.STRING, number=138946292, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + tests = proto.RepeatedField(proto.MESSAGE, number=110251553, message="UrlMapTest",) -class DeleteTargetVpnGatewayRequest(proto.Message): - r"""A request message for TargetVpnGateways.Delete. See the - method description for details. +class UrlMapList(proto.Message): + r"""Contains a list of UrlMap resources. Attributes: - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_vpn_gateway (str): - Name of the target VPN gateway to delete. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.UrlMap]): + A list of UrlMap resources. + kind (str): + Type of resource. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_vpn_gateway = proto.Field(proto.STRING, number=532512843,) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="UrlMap",) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class GetTargetVpnGatewayRequest(proto.Message): - r"""A request message for TargetVpnGateways.Get. See the method - description for details. +class UrlMapReference(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - target_vpn_gateway (str): - Name of the target VPN gateway to return. - """ + url_map (str): - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - target_vpn_gateway = proto.Field(proto.STRING, number=532512843,) + """ + url_map = proto.Field(proto.STRING, number=367020684, optional=True,) -class InsertTargetVpnGatewayRequest(proto.Message): - r"""A request message for TargetVpnGateways.Insert. See the - method description for details. +class UrlMapTest(proto.Message): + r"""Message for the expected URL mappings. Attributes: - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - target_vpn_gateway_resource (google.cloud.compute_v1.types.TargetVpnGateway): - The body resource for this request + description (str): + Description of this test case. + expected_output_url (str): + The expected output URL evaluated by load balancer + containing the scheme, host, path and query parameters. For + rules that forward requests to backends, the test passes + only when expectedOutputUrl matches the request forwarded by + load balancer to backends. For rules with urlRewrite, the + test verifies that the forwarded request matches hostRewrite + and pathPrefixRewrite in the urlRewrite action. When service + is specified, expectedOutputUrl`s scheme is ignored. For + rules with urlRedirect, the test passes only if + expectedOutputUrl matches the URL in the load balancer's + redirect response. If urlRedirect specifies https_redirect, + the test passes only if the scheme in expectedOutputUrl is + also set to https. If urlRedirect specifies strip_query, the + test passes only if expectedOutputUrl does not contain any + query parameters. expectedOutputUrl is optional when service + is specified. + expected_redirect_response_code (int): + For rules with urlRedirect, the test passes + only if expectedRedirectResponseCode matches the + HTTP status code in load balancer's redirect + response. expectedRedirectResponseCode cannot be + set when service is set. + headers (Sequence[google.cloud.compute_v1.types.UrlMapTestHeader]): + HTTP headers for this request. If headers + contains a host header, then host must also + match the header value. + host (str): + Host portion of the URL. If headers contains + a host header, then host must also match the + header value. + path (str): + Path portion of the URL. + service (str): + Expected BackendService or BackendBucket + resource the given URL should be mapped to. + service cannot be set if + expectedRedirectResponseCode is set. """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - target_vpn_gateway_resource = proto.Field( - proto.MESSAGE, number=498050, message="TargetVpnGateway", + description = proto.Field(proto.STRING, number=422937596, optional=True,) + expected_output_url = proto.Field(proto.STRING, number=433967384, optional=True,) + expected_redirect_response_code = proto.Field( + proto.INT32, number=18888047, optional=True, ) + headers = proto.RepeatedField( + proto.MESSAGE, number=258436998, message="UrlMapTestHeader", + ) + host = proto.Field(proto.STRING, number=3208616, optional=True,) + path = proto.Field(proto.STRING, number=3433509, optional=True,) + service = proto.Field(proto.STRING, number=373540533, optional=True,) -class ListTargetVpnGatewaysRequest(proto.Message): - r"""A request message for TargetVpnGateways.List. See the method - description for details. - +class UrlMapTestHeader(proto.Message): + r"""HTTP headers used in UrlMapTests. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. + name (str): + Header name. + value (str): + Header value. + """ - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + name = proto.Field(proto.STRING, number=3373707, optional=True,) + value = proto.Field(proto.STRING, number=111972721, optional=True,) - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. +class UrlMapValidationResult(proto.Message): + r"""Message representing the validation result for a UrlMap. + Attributes: + load_errors (Sequence[str]): - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. + load_succeeded (bool): + Whether the given UrlMap can be successfully + loaded. If false, 'loadErrors' indicates the + reasons. + test_failures (Sequence[google.cloud.compute_v1.types.TestFailure]): - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + test_passed (bool): + If successfully loaded, this field indicates + whether the test passed. If false, + 'testFailures's indicate the reason of failure. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - + load_errors = proto.RepeatedField(proto.STRING, number=310147300,) + load_succeeded = proto.Field(proto.BOOL, number=128326216, optional=True,) + test_failures = proto.RepeatedField( + proto.MESSAGE, number=505934134, message="TestFailure", + ) + test_passed = proto.Field(proto.BOOL, number=192708797, optional=True,) -class AggregatedListUrlMapsRequest(proto.Message): - r"""A request message for UrlMaps.AggregatedList. See the method - description for details. +class UrlMapsAggregatedList(proto.Message): + r""" Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.UrlMapsAggregatedList.ItemsEntry]): + A list of UrlMapsScopedList resources. + kind (str): + Type of resource. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + @property + def raw_page(self): + return self - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.MapField( + proto.STRING, proto.MESSAGE, number=100526016, message="UrlMapsScopedList", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Name of the project scoping this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. +class UrlMapsScopedList(proto.Message): + r""" + Attributes: + url_maps (Sequence[google.cloud.compute_v1.types.UrlMap]): + A list of UrlMaps contained in this scope. + warning (google.cloud.compute_v1.types.Warning): + Informational warning which replaces the list + of backend services when the list is empty. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - + url_maps = proto.RepeatedField(proto.MESSAGE, number=103352167, message="UrlMap",) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class DeleteUrlMapRequest(proto.Message): - r"""A request message for UrlMaps.Delete. See the method - description for details. +class UrlMapsValidateRequest(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - url_map (str): - Name of the UrlMap resource to delete. + resource (google.cloud.compute_v1.types.UrlMap): + Content of the UrlMap to be validated. """ - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - url_map = proto.Field(proto.STRING, number=367020684,) - + resource = proto.Field( + proto.MESSAGE, number=195806222, optional=True, message="UrlMap", + ) -class GetUrlMapRequest(proto.Message): - r"""A request message for UrlMaps.Get. See the method description - for details. +class UrlMapsValidateResponse(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - url_map (str): - Name of the UrlMap resource to return. + result (google.cloud.compute_v1.types.UrlMapValidationResult): + """ - project = proto.Field(proto.STRING, number=227560217,) - url_map = proto.Field(proto.STRING, number=367020684,) + result = proto.Field( + proto.MESSAGE, + number=139315229, + optional=True, + message="UrlMapValidationResult", + ) -class InsertUrlMapRequest(proto.Message): - r"""A request message for UrlMaps.Insert. See the method - description for details. +class UrlRewrite(proto.Message): + r"""The spec for modifying the path before sending the request to + the matched backend service. Attributes: - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - url_map_resource (google.cloud.compute_v1.types.UrlMap): - The body resource for this request + host_rewrite (str): + Prior to forwarding the request to the + selected service, the request's host header is + replaced with contents of hostRewrite. The value + must be between 1 and 255 characters. + path_prefix_rewrite (str): + Prior to forwarding the request to the + selected backend service, the matching portion + of the request's path is replaced by + pathPrefixRewrite. The value must be between 1 + and 1024 characters. """ - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - url_map_resource = proto.Field(proto.MESSAGE, number=168675425, message="UrlMap",) + host_rewrite = proto.Field(proto.STRING, number=159819253, optional=True,) + path_prefix_rewrite = proto.Field(proto.STRING, number=41186361, optional=True,) -class InvalidateCacheUrlMapRequest(proto.Message): - r"""A request message for UrlMaps.InvalidateCache. See the method - description for details. +class UsableSubnetwork(proto.Message): + r"""Subnetwork which the current user has compute.subnetworks.use + permission on. Attributes: - cache_invalidation_rule_resource (google.cloud.compute_v1.types.CacheInvalidationRule): - The body resource for this request - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - url_map (str): - Name of the UrlMap scoping this request. + ip_cidr_range (str): + The range of internal addresses that are + owned by this subnetwork. + network (str): + Network URL. + secondary_ip_ranges (Sequence[google.cloud.compute_v1.types.UsableSubnetworkSecondaryRange]): + Secondary IP ranges. + subnetwork (str): + Subnetwork URL. """ - cache_invalidation_rule_resource = proto.Field( - proto.MESSAGE, number=312795565, message="CacheInvalidationRule", + ip_cidr_range = proto.Field(proto.STRING, number=98117322, optional=True,) + network = proto.Field(proto.STRING, number=232872494, optional=True,) + secondary_ip_ranges = proto.RepeatedField( + proto.MESSAGE, number=136658915, message="UsableSubnetworkSecondaryRange", ) - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - url_map = proto.Field(proto.STRING, number=367020684,) - + subnetwork = proto.Field(proto.STRING, number=307827694, optional=True,) -class ListUrlMapsRequest(proto.Message): - r"""A request message for UrlMaps.List. See the method - description for details. +class UsableSubnetworkSecondaryRange(proto.Message): + r"""Secondary IP range of a usable subnetwork. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. - - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + ip_cidr_range (str): + The range of IP addresses belonging to this + subnetwork secondary range. + range_name (str): + The name associated with this subnetwork + secondary range, used when adding an alias IP + range to a VM instance. The name must be 1-63 + characters long, and comply with RFC1035. The + name must be unique within the subnetwork. + """ - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. + ip_cidr_range = proto.Field(proto.STRING, number=98117322, optional=True,) + range_name = proto.Field(proto.STRING, number=332216397, optional=True,) - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. +class UsableSubnetworksAggregatedList(proto.Message): + r""" + Attributes: + id (str): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + items (Sequence[google.cloud.compute_v1.types.UsableSubnetwork]): + [Output] A list of usable subnetwork URLs. + kind (str): + [Output Only] Type of resource. Always + compute#usableSubnetworksAggregatedList for aggregated lists + of usable subnetworks. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. In special cases + listUsable may return 0 subnetworks and nextPageToken which + still should be used to get the next page of results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - + @property + def raw_page(self): + return self -class PatchUrlMapRequest(proto.Message): - r"""A request message for UrlMaps.Patch. See the method - description for details. + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField( + proto.MESSAGE, number=100526016, message="UsableSubnetwork", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) + + +class UsageExportLocation(proto.Message): + r"""The location in Cloud Storage and naming method of the daily usage + report. Contains bucket_name and report_name prefix. Attributes: - project (str): - Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - url_map (str): - Name of the UrlMap resource to patch. - url_map_resource (google.cloud.compute_v1.types.UrlMap): - The body resource for this request + bucket_name (str): + The name of an existing bucket in Cloud + Storage where the usage report object is stored. + The Google Service Account is granted write + access to this bucket. This can either be the + bucket name by itself, such as example-bucket, + or the bucket name with gs:// or + https://storage.googleapis.com/ in front of it, + such as gs://example-bucket. + report_name_prefix (str): + An optional prefix for the name of the usage report object + stored in bucketName. If not supplied, defaults to + usage_gce. The report is stored as a CSV file named + report_name_prefix_gce_YYYYMMDD.csv where YYYYMMDD is the + day of the usage according to Pacific Time. If you supply a + prefix, it should conform to Cloud Storage object naming + conventions. """ - project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - url_map = proto.Field(proto.STRING, number=367020684,) - url_map_resource = proto.Field(proto.MESSAGE, number=168675425, message="UrlMap",) + bucket_name = proto.Field(proto.STRING, number=283610048, optional=True,) + report_name_prefix = proto.Field(proto.STRING, number=320198715, optional=True,) -class UpdateUrlMapRequest(proto.Message): - r"""A request message for UrlMaps.Update. See the method +class ValidateRegionUrlMapRequest(proto.Message): + r"""A request message for RegionUrlMaps.Validate. See the method description for details. Attributes: project (str): Project ID for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - url_map (str): - Name of the UrlMap resource to update. - url_map_resource (google.cloud.compute_v1.types.UrlMap): + region (str): + Name of the region scoping this request. + region_url_maps_validate_request_resource (google.cloud.compute_v1.types.RegionUrlMapsValidateRequest): The body resource for this request + url_map (str): + Name of the UrlMap resource to be validated + as. """ project = proto.Field(proto.STRING, number=227560217,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) + region = proto.Field(proto.STRING, number=138946292,) + region_url_maps_validate_request_resource = proto.Field( + proto.MESSAGE, number=56632858, message="RegionUrlMapsValidateRequest", + ) url_map = proto.Field(proto.STRING, number=367020684,) - url_map_resource = proto.Field(proto.MESSAGE, number=168675425, message="UrlMap",) class ValidateUrlMapRequest(proto.Message): @@ -48421,592 +47597,808 @@ class ValidateUrlMapRequest(proto.Message): ) -class AggregatedListVpnGatewaysRequest(proto.Message): - r"""A request message for VpnGateways.AggregatedList. See the - method description for details. +class VmEndpointNatMappings(proto.Message): + r"""Contain information of Nat mapping for a VM endpoint (i.e., + NIC). Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. + instance_name (str): + Name of the VM instance which the endpoint + belongs to + interface_nat_mappings (Sequence[google.cloud.compute_v1.types.VmEndpointNatMappingsInterfaceNatMappings]): - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + instance_name = proto.Field(proto.STRING, number=227947509, optional=True,) + interface_nat_mappings = proto.RepeatedField( + proto.MESSAGE, + number=256196617, + message="VmEndpointNatMappingsInterfaceNatMappings", + ) - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. +class VmEndpointNatMappingsInterfaceNatMappings(proto.Message): + r"""Contain information of Nat mapping for an interface of this + endpoint. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + Attributes: + drain_nat_ip_port_ranges (Sequence[str]): + List of all drain IP:port-range mappings assigned to this + interface. These ranges are inclusive, that is, both the + first and the last ports can be used for NAT. Example: + ["2.2.2.2:12345-12355", "1.1.1.1:2234-2234"]. + nat_ip_port_ranges (Sequence[str]): + A list of all IP:port-range mappings assigned to this + interface. These ranges are inclusive, that is, both the + first and the last ports can be used for NAT. Example: + ["2.2.2.2:12345-12355", "1.1.1.1:2234-2234"]. + num_total_drain_nat_ports (int): + Total number of drain ports across all NAT IPs allocated to + this interface. It equals to the aggregated port number in + the field drain_nat_ip_port_ranges. + num_total_nat_ports (int): + Total number of ports across all NAT IPs allocated to this + interface. It equals to the aggregated port number in the + field nat_ip_port_ranges. + source_alias_ip_range (str): + Alias IP range for this interface endpoint. + It will be a private (RFC 1918) IP range. + Examples: "10.33.4.55/32", or "192.168.5.0/24". + source_virtual_ip (str): + Primary IP of the VM for this NIC. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + drain_nat_ip_port_ranges = proto.RepeatedField(proto.STRING, number=395440577,) + nat_ip_port_ranges = proto.RepeatedField(proto.STRING, number=531830810,) + num_total_drain_nat_ports = proto.Field( + proto.INT32, number=335532793, optional=True, + ) + num_total_nat_ports = proto.Field(proto.INT32, number=299904384, optional=True,) + source_alias_ip_range = proto.Field(proto.STRING, number=440340952, optional=True,) + source_virtual_ip = proto.Field(proto.STRING, number=149836159, optional=True,) -class DeleteVpnGatewayRequest(proto.Message): - r"""A request message for VpnGateways.Delete. See the method - description for details. +class VmEndpointNatMappingsList(proto.Message): + r"""Contains a list of VmEndpointNatMappings. + Attributes: + id (str): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + kind (str): + [Output Only] Type of resource. Always + compute#vmEndpointNatMappingsList for lists of Nat mappings + of VM endpoints. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + result (Sequence[google.cloud.compute_v1.types.VmEndpointNatMappings]): + [Output Only] A list of Nat mapping information of VM + endpoints. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. + """ + + @property + def raw_page(self): + return self + + id = proto.Field(proto.STRING, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + result = proto.RepeatedField( + proto.MESSAGE, number=139315229, message="VmEndpointNatMappings", + ) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) + + +class VpnGateway(proto.Message): + r"""Represents a HA VPN gateway. HA VPN is a high-availability + (HA) Cloud VPN solution that lets you securely connect your on- + premises network to your Google Cloud Virtual Private Cloud + network through an IPsec VPN connection in a single region. For + more information about Cloud HA VPN solutions, see Cloud VPN + topologies . Attributes: - project (str): - Project ID for this request. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + kind (str): + [Output Only] Type of resource. Always compute#vpnGateway + for VPN gateways. + label_fingerprint (str): + A fingerprint for the labels being applied to + this VpnGateway, which is essentially a hash of + the labels set used for optimistic locking. The + fingerprint is initially generated by Compute + Engine and changes after every request to modify + or update labels. You must always provide an up- + to-date fingerprint hash in order to update or + change labels, otherwise the request will fail + with error 412 conditionNotMet. To see the + latest fingerprint, make a get() request to + retrieve an VpnGateway. + labels (Sequence[google.cloud.compute_v1.types.VpnGateway.LabelsEntry]): + Labels for this resource. These can only be + added or modified by the setLabels method. Each + label key/value pair must comply with RFC1035. + Label values may be empty. + name (str): + Name of the resource. Provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. + network (str): + URL of the network to which this VPN gateway + is attached. Provided by the client when the VPN + gateway is created. region (str): - Name of the region for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - vpn_gateway (str): - Name of the VPN gateway to delete. + [Output Only] URL of the region where the VPN gateway + resides. + self_link (str): + [Output Only] Server-defined URL for the resource. + vpn_interfaces (Sequence[google.cloud.compute_v1.types.VpnGatewayVpnGatewayInterface]): + The list of VPN interfaces associated with + this VPN gateway. """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - vpn_gateway = proto.Field(proto.STRING, number=406684153,) + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + label_fingerprint = proto.Field(proto.STRING, number=178124825, optional=True,) + labels = proto.MapField(proto.STRING, proto.STRING, number=500195327,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + network = proto.Field(proto.STRING, number=232872494, optional=True,) + region = proto.Field(proto.STRING, number=138946292, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + vpn_interfaces = proto.RepeatedField( + proto.MESSAGE, number=91842181, message="VpnGatewayVpnGatewayInterface", + ) -class GetVpnGatewayRequest(proto.Message): - r"""A request message for VpnGateways.Get. See the method - description for details. +class VpnGatewayAggregatedList(proto.Message): + r""" + Attributes: + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.VpnGatewayAggregatedList.ItemsEntry]): + A list of VpnGateway resources. + kind (str): + [Output Only] Type of resource. Always compute#vpnGateway + for VPN gateways. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. + """ + + @property + def raw_page(self): + return self + + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.MapField( + proto.STRING, proto.MESSAGE, number=100526016, message="VpnGatewaysScopedList", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) + +class VpnGatewayList(proto.Message): + r"""Contains a list of VpnGateway resources. Attributes: - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - vpn_gateway (str): - Name of the VPN gateway to return. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.VpnGateway]): + A list of VpnGateway resources. + kind (str): + [Output Only] Type of resource. Always compute#vpnGateway + for VPN gateways. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - vpn_gateway = proto.Field(proto.STRING, number=406684153,) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="VpnGateway",) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class GetStatusVpnGatewayRequest(proto.Message): - r"""A request message for VpnGateways.GetStatus. See the method - description for details. +class VpnGatewayStatus(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - vpn_gateway (str): - Name of the VPN gateway to return. + vpn_connections (Sequence[google.cloud.compute_v1.types.VpnGatewayStatusVpnConnection]): + List of VPN connection for this VpnGateway. """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - vpn_gateway = proto.Field(proto.STRING, number=406684153,) + vpn_connections = proto.RepeatedField( + proto.MESSAGE, number=439334538, message="VpnGatewayStatusVpnConnection", + ) -class InsertVpnGatewayRequest(proto.Message): - r"""A request message for VpnGateways.Insert. See the method - description for details. +class VpnGatewayStatusHighAvailabilityRequirementState(proto.Message): + r"""Describes the high availability requirement state for the VPN + connection between this Cloud VPN gateway and a peer gateway. Attributes: - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - vpn_gateway_resource (google.cloud.compute_v1.types.VpnGateway): - The body resource for this request + state (google.cloud.compute_v1.types.VpnGatewayStatusHighAvailabilityRequirementState.State): + Indicates the high availability requirement state for the + VPN connection. Valid values are CONNECTION_REDUNDANCY_MET, + CONNECTION_REDUNDANCY_NOT_MET. + unsatisfied_reason (google.cloud.compute_v1.types.VpnGatewayStatusHighAvailabilityRequirementState.UnsatisfiedReason): + Indicates the reason why the VPN connection does not meet + the high availability redundancy criteria/requirement. Valid + values is INCOMPLETE_TUNNELS_COVERAGE. + """ + + class State(proto.Enum): + r"""Indicates the high availability requirement state for the VPN + connection. Valid values are CONNECTION_REDUNDANCY_MET, + CONNECTION_REDUNDANCY_NOT_MET. + """ + UNDEFINED_STATE = 0 + CONNECTION_REDUNDANCY_MET = 505242907 + CONNECTION_REDUNDANCY_NOT_MET = 511863311 + + class UnsatisfiedReason(proto.Enum): + r"""Indicates the reason why the VPN connection does not meet the high + availability redundancy criteria/requirement. Valid values is + INCOMPLETE_TUNNELS_COVERAGE. + """ + UNDEFINED_UNSATISFIED_REASON = 0 + INCOMPLETE_TUNNELS_COVERAGE = 55917437 + + state = proto.Field(proto.ENUM, number=109757585, optional=True, enum=State,) + unsatisfied_reason = proto.Field( + proto.ENUM, number=55016330, optional=True, enum=UnsatisfiedReason, + ) + + +class VpnGatewayStatusTunnel(proto.Message): + r"""Contains some information about a VPN tunnel. + Attributes: + local_gateway_interface (int): + The VPN gateway interface this VPN tunnel is + associated with. + peer_gateway_interface (int): + The peer gateway interface this VPN tunnel is + connected to, the peer gateway could either be + an external VPN gateway or GCP VPN gateway. + tunnel_url (str): + URL reference to the VPN tunnel. + """ + + local_gateway_interface = proto.Field( + proto.UINT32, number=158764330, optional=True, + ) + peer_gateway_interface = proto.Field(proto.UINT32, number=214380385, optional=True,) + tunnel_url = proto.Field(proto.STRING, number=78975256, optional=True,) + + +class VpnGatewayStatusVpnConnection(proto.Message): + r"""A VPN connection contains all VPN tunnels connected from this + VpnGateway to the same peer gateway. The peer gateway could + either be a external VPN gateway or GCP VPN gateway. + + Attributes: + peer_external_gateway (str): + URL reference to the peer external VPN gateways to which the + VPN tunnels in this VPN connection are connected. This field + is mutually exclusive with peer_gcp_gateway. + peer_gcp_gateway (str): + URL reference to the peer side VPN gateways to which the VPN + tunnels in this VPN connection are connected. This field is + mutually exclusive with peer_gcp_gateway. + state (google.cloud.compute_v1.types.VpnGatewayStatusHighAvailabilityRequirementState): + HighAvailabilityRequirementState for the VPN + connection. + tunnels (Sequence[google.cloud.compute_v1.types.VpnGatewayStatusTunnel]): + List of VPN tunnels that are in this VPN + connection. """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - vpn_gateway_resource = proto.Field( - proto.MESSAGE, number=182688660, message="VpnGateway", + peer_external_gateway = proto.Field(proto.STRING, number=384956173, optional=True,) + peer_gcp_gateway = proto.Field(proto.STRING, number=281867452, optional=True,) + state = proto.Field( + proto.MESSAGE, + number=109757585, + optional=True, + message="VpnGatewayStatusHighAvailabilityRequirementState", + ) + tunnels = proto.RepeatedField( + proto.MESSAGE, number=104561931, message="VpnGatewayStatusTunnel", ) -class ListVpnGatewaysRequest(proto.Message): - r"""A request message for VpnGateways.List. See the method - description for details. - +class VpnGatewayVpnGatewayInterface(proto.Message): + r"""A VPN gateway interface. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + id (int): + [Output Only] Numeric identifier for this VPN interface + associated with the VPN gateway. + interconnect_attachment (str): + URL of the VLAN attachment + (interconnectAttachment) resource for this VPN + gateway interface. When the value of this field + is present, the VPN gateway is used for IPsec- + encrypted Cloud Interconnect; all egress or + ingress traffic for this VPN gateway interface + goes through the specified VLAN attachment + resource. Not currently available publicly. + ip_address (str): + [Output Only] IP address for this VPN interface associated + with the VPN gateway. The IP address could be either a + regional external IP address or a regional internal IP + address. The two IP addresses for a VPN gateway must be all + regional external or regional internal IP addresses. There + cannot be a mix of regional external IP addresses and + regional internal IP addresses. For IPsec-encrypted Cloud + Interconnect, the IP addresses for both interfaces could + either be regional internal IP addresses or regional + external IP addresses. For regular (non IPsec-encrypted + Cloud Interconnect) HA VPN tunnels, the IP address must be a + regional external IP address. + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + id = proto.Field(proto.UINT32, number=3355, optional=True,) + interconnect_attachment = proto.Field( + proto.STRING, number=308135284, optional=True, + ) + ip_address = proto.Field(proto.STRING, number=406272220, optional=True,) - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. +class VpnGatewaysGetStatusResponse(proto.Message): + r""" + Attributes: + result (google.cloud.compute_v1.types.VpnGatewayStatus): - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - + result = proto.Field( + proto.MESSAGE, number=139315229, optional=True, message="VpnGatewayStatus", + ) -class SetLabelsVpnGatewayRequest(proto.Message): - r"""A request message for VpnGateways.SetLabels. See the method - description for details. +class VpnGatewaysScopedList(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - region (str): - The region for this request. - region_set_labels_request_resource (google.cloud.compute_v1.types.RegionSetLabelsRequest): - The body resource for this request - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - resource (str): - Name or id of the resource for this request. + vpn_gateways (Sequence[google.cloud.compute_v1.types.VpnGateway]): + [Output Only] A list of VPN gateways contained in this + scope. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning which replaces the list + of addresses when the list is empty. """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - region_set_labels_request_resource = proto.Field( - proto.MESSAGE, number=259357782, message="RegionSetLabelsRequest", + vpn_gateways = proto.RepeatedField( + proto.MESSAGE, number=259177882, message="VpnGateway", + ) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", ) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - resource = proto.Field(proto.STRING, number=195806222,) -class TestIamPermissionsVpnGatewayRequest(proto.Message): - r"""A request message for VpnGateways.TestIamPermissions. See the - method description for details. +class VpnTunnel(proto.Message): + r"""Represents a Cloud VPN Tunnel resource. For more information + about VPN, read the the Cloud VPN Overview. Attributes: - project (str): - Project ID for this request. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + description (str): + An optional description of this resource. + Provide this property when you create the + resource. + detailed_status (str): + [Output Only] Detailed status message for the VPN tunnel. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + ike_version (int): + IKE protocol version to use when establishing + the VPN tunnel with the peer VPN gateway. + Acceptable IKE versions are 1 or 2. The default + version is 2. + kind (str): + [Output Only] Type of resource. Always compute#vpnTunnel for + VPN tunnels. + local_traffic_selector (Sequence[str]): + Local traffic selector to use when + establishing the VPN tunnel with the peer VPN + gateway. The value should be a CIDR formatted + string, for example: 192.168.0.0/16. The ranges + must be disjoint. Only IPv4 is supported. + name (str): + Name of the resource. Provided by the client when the + resource is created. The name must be 1-63 characters long, + and comply with RFC1035. Specifically, the name must be 1-63 + characters long and match the regular expression + ``[a-z]([-a-z0-9]*[a-z0-9])?`` which means the first + character must be a lowercase letter, and all following + characters must be a dash, lowercase letter, or digit, + except the last character, which cannot be a dash. + peer_external_gateway (str): + URL of the peer side external VPN gateway to + which this VPN tunnel is connected. Provided by + the client when the VPN tunnel is created. This + field is exclusive with the field + peerGcpGateway. + peer_external_gateway_interface (int): + The interface ID of the external VPN gateway + to which this VPN tunnel is connected. Provided + by the client when the VPN tunnel is created. + peer_gcp_gateway (str): + URL of the peer side HA GCP VPN gateway to + which this VPN tunnel is connected. Provided by + the client when the VPN tunnel is created. This + field can be used when creating highly available + VPN from VPC network to VPC network, the field + is exclusive with the field peerExternalGateway. + If provided, the VPN tunnel will automatically + use the same vpnGatewayInterface ID in the peer + GCP VPN gateway. + peer_ip (str): + IP address of the peer VPN gateway. Only IPv4 + is supported. region (str): - The name of the region for this request. - resource (str): - Name or id of the resource for this request. - test_permissions_request_resource (google.cloud.compute_v1.types.TestPermissionsRequest): - The body resource for this request + [Output Only] URL of the region where the VPN tunnel + resides. You must specify this field as part of the HTTP + request URL. It is not settable as a field in the request + body. + remote_traffic_selector (Sequence[str]): + Remote traffic selectors to use when + establishing the VPN tunnel with the peer VPN + gateway. The value should be a CIDR formatted + string, for example: 192.168.0.0/16. The ranges + should be disjoint. Only IPv4 is supported. + router (str): + URL of the router resource to be used for + dynamic routing. + self_link (str): + [Output Only] Server-defined URL for the resource. + shared_secret (str): + Shared secret used to set the secure session + between the Cloud VPN gateway and the peer VPN + gateway. + shared_secret_hash (str): + Hash of the shared secret. + status (google.cloud.compute_v1.types.VpnTunnel.Status): + [Output Only] The status of the VPN tunnel, which can be one + of the following: - PROVISIONING: Resource is being + allocated for the VPN tunnel. - WAITING_FOR_FULL_CONFIG: + Waiting to receive all VPN-related configs from the user. + Network, TargetVpnGateway, VpnTunnel, ForwardingRule, and + Route resources are needed to setup the VPN tunnel. - + FIRST_HANDSHAKE: Successful first handshake with the peer + VPN. - ESTABLISHED: Secure session is successfully + established with the peer VPN. - NETWORK_ERROR: Deprecated, + replaced by NO_INCOMING_PACKETS - AUTHORIZATION_ERROR: Auth + error (for example, bad shared secret). - + NEGOTIATION_FAILURE: Handshake failed. - DEPROVISIONING: + Resources are being deallocated for the VPN tunnel. - + FAILED: Tunnel creation has failed and the tunnel is not + ready to be used. - NO_INCOMING_PACKETS: No incoming packets + from peer. - REJECTED: Tunnel configuration was rejected, + can be result of being denied access. - + ALLOCATING_RESOURCES: Cloud VPN is in the process of + allocating all required resources. - STOPPED: Tunnel is + stopped due to its Forwarding Rules being deleted for + Classic VPN tunnels or the project is in frozen state. - + PEER_IDENTITY_MISMATCH: Peer identity does not match peer + IP, probably behind NAT. - TS_NARROWING_NOT_ALLOWED: Traffic + selector narrowing not allowed for an HA-VPN tunnel. + target_vpn_gateway (str): + URL of the Target VPN gateway with which this + VPN tunnel is associated. Provided by the client + when the VPN tunnel is created. + vpn_gateway (str): + URL of the VPN gateway with which this VPN tunnel is + associated. Provided by the client when the VPN tunnel is + created. This must be used (instead of target_vpn_gateway) + if a High Availability VPN gateway resource is created. + vpn_gateway_interface (int): + The interface ID of the VPN gateway with + which this VPN tunnel is associated. """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - resource = proto.Field(proto.STRING, number=195806222,) - test_permissions_request_resource = proto.Field( - proto.MESSAGE, number=439214758, message="TestPermissionsRequest", - ) + class Status(proto.Enum): + r"""[Output Only] The status of the VPN tunnel, which can be one of the + following: - PROVISIONING: Resource is being allocated for the VPN + tunnel. - WAITING_FOR_FULL_CONFIG: Waiting to receive all + VPN-related configs from the user. Network, TargetVpnGateway, + VpnTunnel, ForwardingRule, and Route resources are needed to setup + the VPN tunnel. - FIRST_HANDSHAKE: Successful first handshake with + the peer VPN. - ESTABLISHED: Secure session is successfully + established with the peer VPN. - NETWORK_ERROR: Deprecated, replaced + by NO_INCOMING_PACKETS - AUTHORIZATION_ERROR: Auth error (for + example, bad shared secret). - NEGOTIATION_FAILURE: Handshake + failed. - DEPROVISIONING: Resources are being deallocated for the + VPN tunnel. - FAILED: Tunnel creation has failed and the tunnel is + not ready to be used. - NO_INCOMING_PACKETS: No incoming packets + from peer. - REJECTED: Tunnel configuration was rejected, can be + result of being denied access. - ALLOCATING_RESOURCES: Cloud VPN is + in the process of allocating all required resources. - STOPPED: + Tunnel is stopped due to its Forwarding Rules being deleted for + Classic VPN tunnels or the project is in frozen state. - + PEER_IDENTITY_MISMATCH: Peer identity does not match peer IP, + probably behind NAT. - TS_NARROWING_NOT_ALLOWED: Traffic selector + narrowing not allowed for an HA-VPN tunnel. + """ + UNDEFINED_STATUS = 0 + ALLOCATING_RESOURCES = 320922816 + AUTHORIZATION_ERROR = 23580290 + DEPROVISIONING = 428935662 + ESTABLISHED = 88852344 + FAILED = 455706685 + FIRST_HANDSHAKE = 191393000 + NEGOTIATION_FAILURE = 360325868 + NETWORK_ERROR = 193912951 + NO_INCOMING_PACKETS = 119983216 + PROVISIONING = 290896621 + REJECTED = 174130302 + STOPPED = 444276141 + WAITING_FOR_FULL_CONFIG = 41640522 + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + detailed_status = proto.Field(proto.STRING, number=333501025, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + ike_version = proto.Field(proto.INT32, number=218376220, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + local_traffic_selector = proto.RepeatedField(proto.STRING, number=317314613,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + peer_external_gateway = proto.Field(proto.STRING, number=384956173, optional=True,) + peer_external_gateway_interface = proto.Field( + proto.INT32, number=452768391, optional=True, + ) + peer_gcp_gateway = proto.Field(proto.STRING, number=281867452, optional=True,) + peer_ip = proto.Field(proto.STRING, number=383249700, optional=True,) + region = proto.Field(proto.STRING, number=138946292, optional=True,) + remote_traffic_selector = proto.RepeatedField(proto.STRING, number=358887098,) + router = proto.Field(proto.STRING, number=148608841, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + shared_secret = proto.Field(proto.STRING, number=381932490, optional=True,) + shared_secret_hash = proto.Field(proto.STRING, number=398881891, optional=True,) + status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) + target_vpn_gateway = proto.Field(proto.STRING, number=532512843, optional=True,) + vpn_gateway = proto.Field(proto.STRING, number=406684153, optional=True,) + vpn_gateway_interface = proto.Field(proto.INT32, number=95979123, optional=True,) -class AggregatedListVpnTunnelsRequest(proto.Message): - r"""A request message for VpnTunnels.AggregatedList. See the - method description for details. +class VpnTunnelAggregatedList(proto.Message): + r""" Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.VpnTunnelAggregatedList.ItemsEntry]): + A list of VpnTunnelsScopedList resources. + kind (str): + [Output Only] Type of resource. Always compute#vpnTunnel for + VPN tunnels. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + unreachables (Sequence[str]): + [Output Only] Unreachable resources. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + @property + def raw_page(self): + return self - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - include_all_scopes (bool): - Indicates whether every visible scope for - each scope type (zone, region, global) should be - included in the response. For new resource types - added after this field, the flag has no effect - as new resource types will always include every - visible scope for each scope type in response. - For resource types which predate this field, if - this flag is omitted or false, only scopes of - the scope types where the resource type is - expected to be found will be included. - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.MapField( + proto.STRING, proto.MESSAGE, number=100526016, message="VpnTunnelsScopedList", + ) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + unreachables = proto.RepeatedField(proto.STRING, number=243372063,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. +class VpnTunnelList(proto.Message): + r"""Contains a list of VpnTunnel resources. + Attributes: + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.VpnTunnel]): + A list of VpnTunnel resources. + kind (str): + [Output Only] Type of resource. Always compute#vpnTunnel for + VPN tunnels. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - include_all_scopes = proto.Field(proto.BOOL, number=391327988, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="VpnTunnel",) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class DeleteVpnTunnelRequest(proto.Message): - r"""A request message for VpnTunnels.Delete. See the method - description for details. +class VpnTunnelsScopedList(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - vpn_tunnel (str): - Name of the VpnTunnel resource to delete. + vpn_tunnels (Sequence[google.cloud.compute_v1.types.VpnTunnel]): + A list of VPN tunnels contained in this + scope. + warning (google.cloud.compute_v1.types.Warning): + Informational warning which replaces the list + of addresses when the list is empty. """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - vpn_tunnel = proto.Field(proto.STRING, number=143821331,) - + vpn_tunnels = proto.RepeatedField( + proto.MESSAGE, number=163494080, message="VpnTunnel", + ) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class GetVpnTunnelRequest(proto.Message): - r"""A request message for VpnTunnels.Get. See the method - description for details. +class WafExpressionSet(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - vpn_tunnel (str): - Name of the VpnTunnel resource to return. + aliases (Sequence[str]): + A list of alternate IDs. The format should + be: - E.g. XSS-stable Generic suffix like + "stable" is particularly useful if a policy + likes to avail newer set of expressions without + having to change the policy. A given alias name + can't be used for more than one entity set. + expressions (Sequence[google.cloud.compute_v1.types.WafExpressionSetExpression]): + List of available expressions. + id (str): + Google specified expression set ID. The + format should be: - E.g. XSS-20170329 required """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - vpn_tunnel = proto.Field(proto.STRING, number=143821331,) - + aliases = proto.RepeatedField(proto.STRING, number=159207166,) + expressions = proto.RepeatedField( + proto.MESSAGE, number=175554779, message="WafExpressionSetExpression", + ) + id = proto.Field(proto.STRING, number=3355, optional=True,) -class InsertVpnTunnelRequest(proto.Message): - r"""A request message for VpnTunnels.Insert. See the method - description for details. +class WafExpressionSetExpression(proto.Message): + r""" Attributes: - project (str): - Project ID for this request. - region (str): - Name of the region for this request. - request_id (str): - An optional request ID to identify requests. - Specify a unique request ID so that if you must - retry your request, the server will know to - ignore the request if it has already been - completed. For example, consider a situation - where you make an initial request and the - request times out. If you make the request again - with the same request ID, the server can check - if original operation with the same request ID - was received, and if so, will ignore the second - request. This prevents clients from accidentally - creating duplicate commitments. - The request ID must be a valid UUID with the - exception that zero UUID is not supported - (00000000-0000-0000-0000-000000000000). - vpn_tunnel_resource (google.cloud.compute_v1.types.VpnTunnel): - The body resource for this request + id (str): + Expression ID should uniquely identify the + origin of the expression. E.g. owasp- + crs-v020901-id973337 identifies Owasp core rule + set version 2.9.1 rule id 973337. The ID could + be used to determine the individual attack + definition that has been detected. It could also + be used to exclude it from the policy in case of + false positive. required """ - project = proto.Field(proto.STRING, number=227560217,) - region = proto.Field(proto.STRING, number=138946292,) - request_id = proto.Field(proto.STRING, number=37109963, optional=True,) - vpn_tunnel_resource = proto.Field( - proto.MESSAGE, number=86839482, message="VpnTunnel", - ) + id = proto.Field(proto.STRING, number=3355, optional=True,) -class ListVpnTunnelsRequest(proto.Message): - r"""A request message for VpnTunnels.List. See the method +class WaitGlobalOperationRequest(proto.Message): + r"""A request message for GlobalOperations.Wait. See the method description for details. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + operation (str): + Name of the Operations resource to return. + project (str): + Project ID for this request. + """ - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + operation = proto.Field(proto.STRING, number=52090215,) + project = proto.Field(proto.STRING, number=227560217,) - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. +class WaitRegionOperationRequest(proto.Message): + r"""A request message for RegionOperations.Wait. See the method + description for details. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. + Attributes: + operation (str): + Name of the Operations resource to return. project (str): Project ID for this request. region (str): Name of the region for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) + operation = proto.Field(proto.STRING, number=52090215,) project = proto.Field(proto.STRING, number=227560217,) region = proto.Field(proto.STRING, number=138946292,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) -class DeleteZoneOperationRequest(proto.Message): - r"""A request message for ZoneOperations.Delete. See the method +class WaitZoneOperationRequest(proto.Message): + r"""A request message for ZoneOperations.Wait. See the method description for details. Attributes: operation (str): - Name of the Operations resource to delete. + Name of the Operations resource to return. project (str): Project ID for this request. zone (str): @@ -49018,208 +48410,357 @@ class DeleteZoneOperationRequest(proto.Message): zone = proto.Field(proto.STRING, number=3744684,) -class DeleteZoneOperationResponse(proto.Message): - r"""A response message for ZoneOperations.Delete. See the method - description for details. +class Warning(proto.Message): + r"""[Output Only] Informational warning message. + Attributes: + code (google.cloud.compute_v1.types.Warning.Code): + [Output Only] A warning code, if applicable. For example, + Compute Engine returns NO_RESULTS_ON_PAGE if there are no + results in the response. + data (Sequence[google.cloud.compute_v1.types.Data]): + [Output Only] Metadata about this warning in key: value + format. For example: "data": [ { "key": "scope", "value": + "zones/us-east1-d" } + message (str): + [Output Only] A human-readable description of the warning + code. + """ + + class Code(proto.Enum): + r"""[Output Only] A warning code, if applicable. For example, Compute + Engine returns NO_RESULTS_ON_PAGE if there are no results in the + response. """ + UNDEFINED_CODE = 0 + CLEANUP_FAILED = 150308440 + DEPRECATED_RESOURCE_USED = 391835586 + DEPRECATED_TYPE_USED = 346526230 + DISK_SIZE_LARGER_THAN_IMAGE_SIZE = 369442967 + EXPERIMENTAL_TYPE_USED = 451954443 + EXTERNAL_API_WARNING = 175546307 + FIELD_VALUE_OVERRIDEN = 329669423 + INJECTED_KERNELS_DEPRECATED = 417377419 + LARGE_DEPLOYMENT_WARNING = 481440678 + MISSING_TYPE_DEPENDENCY = 344505463 + NEXT_HOP_ADDRESS_NOT_ASSIGNED = 324964999 + NEXT_HOP_CANNOT_IP_FORWARD = 383382887 + NEXT_HOP_INSTANCE_NOT_FOUND = 464250446 + NEXT_HOP_INSTANCE_NOT_ON_NETWORK = 243758146 + NEXT_HOP_NOT_RUNNING = 417081265 + NOT_CRITICAL_ERROR = 105763924 + NO_RESULTS_ON_PAGE = 30036744 + PARTIAL_SUCCESS = 39966469 + REQUIRED_TOS_AGREEMENT = 3745539 + RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING = 496728641 + RESOURCE_NOT_DELETED = 168598460 + SCHEMA_VALIDATION_IGNORED = 275245642 + SINGLE_INSTANCE_PROPERTY_TEMPLATE = 268305617 + UNDECLARED_PROPERTIES = 390513439 + UNREACHABLE = 13328052 + code = proto.Field(proto.ENUM, number=3059181, optional=True, enum=Code,) + data = proto.RepeatedField(proto.MESSAGE, number=3076010, message="Data",) + message = proto.Field(proto.STRING, number=418054151, optional=True,) -class GetZoneOperationRequest(proto.Message): - r"""A request message for ZoneOperations.Get. See the method - description for details. +class Warnings(proto.Message): + r""" Attributes: - operation (str): - Name of the Operations resource to return. - project (str): - Project ID for this request. - zone (str): - Name of the zone for this request. + code (google.cloud.compute_v1.types.Warnings.Code): + [Output Only] A warning code, if applicable. For example, + Compute Engine returns NO_RESULTS_ON_PAGE if there are no + results in the response. + data (Sequence[google.cloud.compute_v1.types.Data]): + [Output Only] Metadata about this warning in key: value + format. For example: "data": [ { "key": "scope", "value": + "zones/us-east1-d" } + message (str): + [Output Only] A human-readable description of the warning + code. """ - operation = proto.Field(proto.STRING, number=52090215,) - project = proto.Field(proto.STRING, number=227560217,) - zone = proto.Field(proto.STRING, number=3744684,) - + class Code(proto.Enum): + r"""[Output Only] A warning code, if applicable. For example, Compute + Engine returns NO_RESULTS_ON_PAGE if there are no results in the + response. + """ + UNDEFINED_CODE = 0 + CLEANUP_FAILED = 150308440 + DEPRECATED_RESOURCE_USED = 391835586 + DEPRECATED_TYPE_USED = 346526230 + DISK_SIZE_LARGER_THAN_IMAGE_SIZE = 369442967 + EXPERIMENTAL_TYPE_USED = 451954443 + EXTERNAL_API_WARNING = 175546307 + FIELD_VALUE_OVERRIDEN = 329669423 + INJECTED_KERNELS_DEPRECATED = 417377419 + LARGE_DEPLOYMENT_WARNING = 481440678 + MISSING_TYPE_DEPENDENCY = 344505463 + NEXT_HOP_ADDRESS_NOT_ASSIGNED = 324964999 + NEXT_HOP_CANNOT_IP_FORWARD = 383382887 + NEXT_HOP_INSTANCE_NOT_FOUND = 464250446 + NEXT_HOP_INSTANCE_NOT_ON_NETWORK = 243758146 + NEXT_HOP_NOT_RUNNING = 417081265 + NOT_CRITICAL_ERROR = 105763924 + NO_RESULTS_ON_PAGE = 30036744 + PARTIAL_SUCCESS = 39966469 + REQUIRED_TOS_AGREEMENT = 3745539 + RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING = 496728641 + RESOURCE_NOT_DELETED = 168598460 + SCHEMA_VALIDATION_IGNORED = 275245642 + SINGLE_INSTANCE_PROPERTY_TEMPLATE = 268305617 + UNDECLARED_PROPERTIES = 390513439 + UNREACHABLE = 13328052 -class ListZoneOperationsRequest(proto.Message): - r"""A request message for ZoneOperations.List. See the method - description for details. + code = proto.Field(proto.ENUM, number=3059181, optional=True, enum=Code,) + data = proto.RepeatedField(proto.MESSAGE, number=3076010, message="Data",) + message = proto.Field(proto.STRING, number=418054151, optional=True,) - Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. +class WeightedBackendService(proto.Message): + r"""In contrast to a single BackendService in HttpRouteAction to + which all matching traffic is directed to, + WeightedBackendService allows traffic to be split across + multiple BackendServices. The volume of traffic for each + BackendService is proportional to the weight specified in each + WeightedBackendService - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + Attributes: + backend_service (str): + The full or partial URL to the default + BackendService resource. Before forwarding the + request to backendService, the loadbalancer + applies any relevant headerActions specified as + part of this backendServiceWeight. + header_action (google.cloud.compute_v1.types.HttpHeaderAction): + Specifies changes to request and response + headers that need to take effect for the + selected backendService. headerAction specified + here take effect before headerAction in the + enclosing HttpRouteRule, PathMatcher and UrlMap. + Note that headerAction is not supported for + Loadbalancers that have their + loadBalancingScheme set to EXTERNAL. Not + supported when the URL map is bound to target + gRPC proxy that has validateForProxyless field + set to true. + weight (int): + Specifies the fraction of traffic sent to + backendService, computed as weight / (sum of all + weightedBackendService weights in routeAction) . + The selection of a backend service is determined + only for new traffic. Once a user's request has + been directed to a backendService, subsequent + requests will be sent to the same backendService + as determined by the BackendService's session + affinity policy. The value must be between 0 and + 1000 + """ - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. + backend_service = proto.Field(proto.STRING, number=306946058, optional=True,) + header_action = proto.Field( + proto.MESSAGE, number=328077352, optional=True, message="HttpHeaderAction", + ) + weight = proto.Field(proto.UINT32, number=282149496, optional=True,) - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. - zone (str): - Name of the zone for request. +class XpnHostList(proto.Message): + r""" + Attributes: + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.Project]): + [Output Only] A list of shared VPC host project URLs. + kind (str): + [Output Only] Type of resource. Always compute#xpnHostList + for lists of shared VPC hosts. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) - zone = proto.Field(proto.STRING, number=3744684,) + @property + def raw_page(self): + return self + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Project",) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) -class WaitZoneOperationRequest(proto.Message): - r"""A request message for ZoneOperations.Wait. See the method - description for details. +class XpnResourceId(proto.Message): + r"""Service resource (a.k.a service project) ID. Attributes: - operation (str): - Name of the Operations resource to return. - project (str): - Project ID for this request. - zone (str): - Name of the zone for this request. + id (str): + The ID of the service resource. In the case + of projects, this field supports project id + (e.g., my-project-123) and project number (e.g. + 12345678). + type_ (google.cloud.compute_v1.types.XpnResourceId.Type): + The type of the service resource. """ - operation = proto.Field(proto.STRING, number=52090215,) - project = proto.Field(proto.STRING, number=227560217,) - zone = proto.Field(proto.STRING, number=3744684,) + class Type(proto.Enum): + r"""The type of the service resource.""" + UNDEFINED_TYPE = 0 + PROJECT = 408671993 + XPN_RESOURCE_TYPE_UNSPECIFIED = 151607034 + id = proto.Field(proto.STRING, number=3355, optional=True,) + type_ = proto.Field(proto.ENUM, number=3575610, optional=True, enum=Type,) -class GetZoneRequest(proto.Message): - r"""A request message for Zones.Get. See the method description - for details. + +class Zone(proto.Message): + r"""Represents a Zone resource. A zone is a deployment area. + These deployment areas are subsets of a region. For example the + zone us-east1-a is located in the us-east1 region. For more + information, read Regions and Zones. Attributes: - project (str): - Project ID for this request. - zone (str): - Name of the zone resource to return. + available_cpu_platforms (Sequence[str]): + [Output Only] Available cpu/platform selections for the + zone. + creation_timestamp (str): + [Output Only] Creation timestamp in RFC3339 text format. + deprecated (google.cloud.compute_v1.types.DeprecationStatus): + [Output Only] The deprecation status associated with this + zone. + description (str): + [Output Only] Textual description of the resource. + id (int): + [Output Only] The unique identifier for the resource. This + identifier is defined by the server. + kind (str): + [Output Only] Type of the resource. Always compute#zone for + zones. + name (str): + [Output Only] Name of the resource. + region (str): + [Output Only] Full URL reference to the region which hosts + the zone. + self_link (str): + [Output Only] Server-defined URL for the resource. + status (google.cloud.compute_v1.types.Zone.Status): + [Output Only] Status of the zone, either UP or DOWN. + supports_pzs (bool): + [Output Only] Reserved for future use. """ - project = proto.Field(proto.STRING, number=227560217,) - zone = proto.Field(proto.STRING, number=3744684,) + class Status(proto.Enum): + r"""[Output Only] Status of the zone, either UP or DOWN.""" + UNDEFINED_STATUS = 0 + DOWN = 2104482 + UP = 2715 + available_cpu_platforms = proto.RepeatedField(proto.STRING, number=175536531,) + creation_timestamp = proto.Field(proto.STRING, number=30525366, optional=True,) + deprecated = proto.Field( + proto.MESSAGE, number=515138995, optional=True, message="DeprecationStatus", + ) + description = proto.Field(proto.STRING, number=422937596, optional=True,) + id = proto.Field(proto.UINT64, number=3355, optional=True,) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + name = proto.Field(proto.STRING, number=3373707, optional=True,) + region = proto.Field(proto.STRING, number=138946292, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + status = proto.Field(proto.ENUM, number=181260274, optional=True, enum=Status,) + supports_pzs = proto.Field(proto.BOOL, number=83983214, optional=True,) -class ListZonesRequest(proto.Message): - r"""A request message for Zones.List. See the method description - for details. +class ZoneList(proto.Message): + r"""Contains a list of zone resources. Attributes: - filter (str): - A filter expression that filters resources listed in the - response. The expression must specify the field name, a - comparison operator, and the value that you want to use for - filtering. The value must be a string, a number, or a - boolean. The comparison operator must be either ``=``, - ``!=``, ``>``, or ``<``. + id (str): + [Output Only] Unique identifier for the resource; defined by + the server. + items (Sequence[google.cloud.compute_v1.types.Zone]): + A list of Zone resources. + kind (str): + Type of resource. + next_page_token (str): + [Output Only] This token allows you to get the next page of + results for list requests. If the number of results is + larger than maxResults, use the nextPageToken as a value for + the query parameter pageToken in the next list request. + Subsequent list requests will have their own nextPageToken + to continue paging through the results. + self_link (str): + [Output Only] Server-defined URL for this resource. + warning (google.cloud.compute_v1.types.Warning): + [Output Only] Informational warning message. + """ - For example, if you are filtering Compute Engine instances, - you can exclude instances named ``example-instance`` by - specifying ``name != example-instance``. + @property + def raw_page(self): + return self - You can also filter nested fields. For example, you could - specify ``scheduling.automaticRestart = false`` to include - instances only if they are not scheduled for automatic - restarts. You can use filtering on nested fields to filter - based on resource labels. + id = proto.Field(proto.STRING, number=3355, optional=True,) + items = proto.RepeatedField(proto.MESSAGE, number=100526016, message="Zone",) + kind = proto.Field(proto.STRING, number=3292052, optional=True,) + next_page_token = proto.Field(proto.STRING, number=79797525, optional=True,) + self_link = proto.Field(proto.STRING, number=456214797, optional=True,) + warning = proto.Field( + proto.MESSAGE, number=50704284, optional=True, message="Warning", + ) - To filter on multiple expressions, provide each separate - expression within parentheses. For example: - ``(scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")`` - By default, each expression is an ``AND`` expression. - However, you can include ``AND`` and ``OR`` expressions - explicitly. For example: - ``(cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)`` - max_results (int): - The maximum number of results per page that should be - returned. If the number of available results is larger than - ``maxResults``, Compute Engine returns a ``nextPageToken`` - that can be used to get the next page of results in - subsequent list requests. Acceptable values are ``0`` to - ``500``, inclusive. (Default: ``500``) - order_by (str): - Sorts list results by a certain order. By default, results - are returned in alphanumerical order based on the resource - name. - You can also sort results in descending order based on the - creation timestamp using - ``orderBy="creationTimestamp desc"``. This sorts results - based on the ``creationTimestamp`` field in reverse - chronological order (newest result first). Use this to sort - resources like operations so that the newest operation is - returned first. +class ZoneSetLabelsRequest(proto.Message): + r""" + Attributes: + label_fingerprint (str): + The fingerprint of the previous set of labels + for this resource, used to detect conflicts. The + fingerprint is initially generated by Compute + Engine and changes after every request to modify + or update labels. You must always provide an up- + to-date fingerprint hash in order to update or + change labels. Make a get() request to the + resource to get the latest fingerprint. + labels (Sequence[google.cloud.compute_v1.types.ZoneSetLabelsRequest.LabelsEntry]): + The labels to set for this resource. + """ - Currently, only sorting by ``name`` or - ``creationTimestamp desc`` is supported. - page_token (str): - Specifies a page token to use. Set ``pageToken`` to the - ``nextPageToken`` returned by a previous list request to get - the next page of results. - project (str): - Project ID for this request. - return_partial_success (bool): - Opt-in for partial success behavior which - provides partial results in case of failure. The - default value is false. + label_fingerprint = proto.Field(proto.STRING, number=178124825, optional=True,) + labels = proto.MapField(proto.STRING, proto.STRING, number=500195327,) + + +class ZoneSetPolicyRequest(proto.Message): + r""" + Attributes: + bindings (Sequence[google.cloud.compute_v1.types.Binding]): + Flatten Policy to create a backwacd + compatible wire-format. Deprecated. Use 'policy' + to specify bindings. + etag (str): + Flatten Policy to create a backward + compatible wire-format. Deprecated. Use 'policy' + to specify the etag. + policy (google.cloud.compute_v1.types.Policy): + REQUIRED: The complete policy to be applied + to the 'resource'. The size of the policy is + limited to a few 10s of KB. An empty policy is + in general a valid policy but certain services + (like Projects) might reject them. """ - filter = proto.Field(proto.STRING, number=336120696, optional=True,) - max_results = proto.Field(proto.UINT32, number=54715419, optional=True,) - order_by = proto.Field(proto.STRING, number=160562920, optional=True,) - page_token = proto.Field(proto.STRING, number=19994697, optional=True,) - project = proto.Field(proto.STRING, number=227560217,) - return_partial_success = proto.Field(proto.BOOL, number=517198390, optional=True,) + bindings = proto.RepeatedField(proto.MESSAGE, number=403251854, message="Binding",) + etag = proto.Field(proto.STRING, number=3123477, optional=True,) + policy = proto.Field( + proto.MESSAGE, number=91071794, optional=True, message="Policy", + ) __all__ = tuple(sorted(__protobuf__.manifest)) diff --git a/synth.metadata b/synth.metadata index de9c4c710..9911bcaea 100644 --- a/synth.metadata +++ b/synth.metadata @@ -4,14 +4,14 @@ "git": { "name": ".", "remote": "https://github.com/googleapis/python-compute.git", - "sha": "b4bea0b0761bf28d4eaf2643ec1f3e97d8142352" + "sha": "6248fdd993c914ed4b94ab483a8168fb3fcd615e" } }, { "git": { "name": "googleapis-discovery", "remote": "https://github.com/googleapis/googleapis-discovery.git", - "sha": "ac663f7f0afb13e3a8cfd04160d1677655c5c613" + "sha": "638b68a77742cb7f4af82e204c9e8c29ef9ada63" } } ], @@ -113,6 +113,7 @@ "docs/compute_v1/global_organization_operations.rst", "docs/compute_v1/global_public_delegated_prefixes.rst", "docs/compute_v1/health_checks.rst", + "docs/compute_v1/image_family_views.rst", "docs/compute_v1/images.rst", "docs/compute_v1/instance_group_managers.rst", "docs/compute_v1/instance_groups.rst", @@ -156,6 +157,7 @@ "docs/compute_v1/routers.rst", "docs/compute_v1/routes.rst", "docs/compute_v1/security_policies.rst", + "docs/compute_v1/service_attachments.rst", "docs/compute_v1/services.rst", "docs/compute_v1/snapshots.rst", "docs/compute_v1/ssl_certificates.rst", @@ -291,6 +293,11 @@ "google/cloud/compute_v1/services/health_checks/transports/__init__.py", "google/cloud/compute_v1/services/health_checks/transports/base.py", "google/cloud/compute_v1/services/health_checks/transports/rest.py", + "google/cloud/compute_v1/services/image_family_views/__init__.py", + "google/cloud/compute_v1/services/image_family_views/client.py", + "google/cloud/compute_v1/services/image_family_views/transports/__init__.py", + "google/cloud/compute_v1/services/image_family_views/transports/base.py", + "google/cloud/compute_v1/services/image_family_views/transports/rest.py", "google/cloud/compute_v1/services/images/__init__.py", "google/cloud/compute_v1/services/images/client.py", "google/cloud/compute_v1/services/images/pagers.py", @@ -547,6 +554,12 @@ "google/cloud/compute_v1/services/security_policies/transports/__init__.py", "google/cloud/compute_v1/services/security_policies/transports/base.py", "google/cloud/compute_v1/services/security_policies/transports/rest.py", + "google/cloud/compute_v1/services/service_attachments/__init__.py", + "google/cloud/compute_v1/services/service_attachments/client.py", + "google/cloud/compute_v1/services/service_attachments/pagers.py", + "google/cloud/compute_v1/services/service_attachments/transports/__init__.py", + "google/cloud/compute_v1/services/service_attachments/transports/base.py", + "google/cloud/compute_v1/services/service_attachments/transports/rest.py", "google/cloud/compute_v1/services/snapshots/__init__.py", "google/cloud/compute_v1/services/snapshots/client.py", "google/cloud/compute_v1/services/snapshots/pagers.py", @@ -686,6 +699,7 @@ "tests/unit/gapic/compute_v1/test_global_organization_operations.py", "tests/unit/gapic/compute_v1/test_global_public_delegated_prefixes.py", "tests/unit/gapic/compute_v1/test_health_checks.py", + "tests/unit/gapic/compute_v1/test_image_family_views.py", "tests/unit/gapic/compute_v1/test_images.py", "tests/unit/gapic/compute_v1/test_instance_group_managers.py", "tests/unit/gapic/compute_v1/test_instance_groups.py", @@ -729,6 +743,7 @@ "tests/unit/gapic/compute_v1/test_routers.py", "tests/unit/gapic/compute_v1/test_routes.py", "tests/unit/gapic/compute_v1/test_security_policies.py", + "tests/unit/gapic/compute_v1/test_service_attachments.py", "tests/unit/gapic/compute_v1/test_snapshots.py", "tests/unit/gapic/compute_v1/test_ssl_certificates.py", "tests/unit/gapic/compute_v1/test_ssl_policies.py", diff --git a/tests/unit/gapic/compute_v1/test_backend_services.py b/tests/unit/gapic/compute_v1/test_backend_services.py index 8e840ddc6..8c80b106f 100644 --- a/tests/unit/gapic/compute_v1/test_backend_services.py +++ b/tests/unit/gapic/compute_v1/test_backend_services.py @@ -1048,6 +1048,9 @@ def test_get_rest( ), self_link="self_link_value", session_affinity=compute.BackendService.SessionAffinity.CLIENT_IP, + subsetting=compute.Subsetting( + policy=compute.Subsetting.Policy.CONSISTENT_HASH_SUBSETTING + ), timeout_sec=1185, ) @@ -1119,6 +1122,9 @@ def test_get_rest( ) assert response.self_link == "self_link_value" assert response.session_affinity == compute.BackendService.SessionAffinity.CLIENT_IP + assert response.subsetting == compute.Subsetting( + policy=compute.Subsetting.Policy.CONSISTENT_HASH_SUBSETTING + ) assert response.timeout_sec == 1185 diff --git a/tests/unit/gapic/compute_v1/test_forwarding_rules.py b/tests/unit/gapic/compute_v1/test_forwarding_rules.py index 26e15180b..8480cc362 100644 --- a/tests/unit/gapic/compute_v1/test_forwarding_rules.py +++ b/tests/unit/gapic/compute_v1/test_forwarding_rules.py @@ -760,6 +760,7 @@ def test_get_rest( port_range="port_range_value", ports=["ports_value"], psc_connection_id=1793, + psc_connection_status=compute.ForwardingRule.PscConnectionStatus.ACCEPTED, region="region_value", self_link="self_link_value", service_directory_registrations=[ @@ -812,6 +813,10 @@ def test_get_rest( assert response.port_range == "port_range_value" assert response.ports == ["ports_value"] assert response.psc_connection_id == 1793 + assert ( + response.psc_connection_status + == compute.ForwardingRule.PscConnectionStatus.ACCEPTED + ) assert response.region == "region_value" assert response.self_link == "self_link_value" assert response.service_directory_registrations == [ diff --git a/tests/unit/gapic/compute_v1/test_global_forwarding_rules.py b/tests/unit/gapic/compute_v1/test_global_forwarding_rules.py index 87f819ca5..c90f1f982 100644 --- a/tests/unit/gapic/compute_v1/test_global_forwarding_rules.py +++ b/tests/unit/gapic/compute_v1/test_global_forwarding_rules.py @@ -619,6 +619,7 @@ def test_get_rest( port_range="port_range_value", ports=["ports_value"], psc_connection_id=1793, + psc_connection_status=compute.ForwardingRule.PscConnectionStatus.ACCEPTED, region="region_value", self_link="self_link_value", service_directory_registrations=[ @@ -671,6 +672,10 @@ def test_get_rest( assert response.port_range == "port_range_value" assert response.ports == ["ports_value"] assert response.psc_connection_id == 1793 + assert ( + response.psc_connection_status + == compute.ForwardingRule.PscConnectionStatus.ACCEPTED + ) assert response.region == "region_value" assert response.self_link == "self_link_value" assert response.service_directory_registrations == [ diff --git a/tests/unit/gapic/compute_v1/test_image_family_views.py b/tests/unit/gapic/compute_v1/test_image_family_views.py new file mode 100644 index 000000000..20138cd63 --- /dev/null +++ b/tests/unit/gapic/compute_v1/test_image_family_views.py @@ -0,0 +1,823 @@ +# -*- coding: utf-8 -*- +# Copyright 2020 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +import os +import mock +import packaging.version + +import grpc +from grpc.experimental import aio +import math +import pytest +from proto.marshal.rules.dates import DurationRule, TimestampRule + +from requests import Response +from requests.sessions import Session + +from google.api_core import client_options +from google.api_core import exceptions as core_exceptions +from google.api_core import gapic_v1 +from google.api_core import grpc_helpers +from google.api_core import grpc_helpers_async +from google.auth import credentials as ga_credentials +from google.auth.exceptions import MutualTLSChannelError +from google.cloud.compute_v1.services.image_family_views import ImageFamilyViewsClient +from google.cloud.compute_v1.services.image_family_views import transports +from google.cloud.compute_v1.services.image_family_views.transports.base import ( + _GOOGLE_AUTH_VERSION, +) +from google.cloud.compute_v1.types import compute +from google.oauth2 import service_account +import google.auth + + +# TODO(busunkim): Once google-auth >= 1.25.0 is required transitively +# through google-api-core: +# - Delete the auth "less than" test cases +# - Delete these pytest markers (Make the "greater than or equal to" tests the default). +requires_google_auth_lt_1_25_0 = pytest.mark.skipif( + packaging.version.parse(_GOOGLE_AUTH_VERSION) >= packaging.version.parse("1.25.0"), + reason="This test requires google-auth < 1.25.0", +) +requires_google_auth_gte_1_25_0 = pytest.mark.skipif( + packaging.version.parse(_GOOGLE_AUTH_VERSION) < packaging.version.parse("1.25.0"), + reason="This test requires google-auth >= 1.25.0", +) + + +def client_cert_source_callback(): + return b"cert bytes", b"key bytes" + + +# If default endpoint is localhost, then default mtls endpoint will be the same. +# This method modifies the default endpoint so the client can produce a different +# mtls endpoint for endpoint testing purposes. +def modify_default_endpoint(client): + return ( + "foo.googleapis.com" + if ("localhost" in client.DEFAULT_ENDPOINT) + else client.DEFAULT_ENDPOINT + ) + + +def test__get_default_mtls_endpoint(): + api_endpoint = "example.googleapis.com" + api_mtls_endpoint = "example.mtls.googleapis.com" + sandbox_endpoint = "example.sandbox.googleapis.com" + sandbox_mtls_endpoint = "example.mtls.sandbox.googleapis.com" + non_googleapi = "api.example.com" + + assert ImageFamilyViewsClient._get_default_mtls_endpoint(None) is None + assert ( + ImageFamilyViewsClient._get_default_mtls_endpoint(api_endpoint) + == api_mtls_endpoint + ) + assert ( + ImageFamilyViewsClient._get_default_mtls_endpoint(api_mtls_endpoint) + == api_mtls_endpoint + ) + assert ( + ImageFamilyViewsClient._get_default_mtls_endpoint(sandbox_endpoint) + == sandbox_mtls_endpoint + ) + assert ( + ImageFamilyViewsClient._get_default_mtls_endpoint(sandbox_mtls_endpoint) + == sandbox_mtls_endpoint + ) + assert ( + ImageFamilyViewsClient._get_default_mtls_endpoint(non_googleapi) + == non_googleapi + ) + + +@pytest.mark.parametrize("client_class", [ImageFamilyViewsClient,]) +def test_image_family_views_client_from_service_account_info(client_class): + creds = ga_credentials.AnonymousCredentials() + with mock.patch.object( + service_account.Credentials, "from_service_account_info" + ) as factory: + factory.return_value = creds + info = {"valid": True} + client = client_class.from_service_account_info(info) + assert client.transport._credentials == creds + assert isinstance(client, client_class) + + assert client.transport._host == "compute.googleapis.com:443" + + +@pytest.mark.parametrize( + "transport_class,transport_name", + [(transports.ImageFamilyViewsRestTransport, "rest"),], +) +def test_image_family_views_client_service_account_always_use_jwt( + transport_class, transport_name +): + with mock.patch.object( + service_account.Credentials, "with_always_use_jwt_access", create=True + ) as use_jwt: + creds = service_account.Credentials(None, None, None) + transport = transport_class(credentials=creds, always_use_jwt_access=True) + use_jwt.assert_called_once_with(True) + + with mock.patch.object( + service_account.Credentials, "with_always_use_jwt_access", create=True + ) as use_jwt: + creds = service_account.Credentials(None, None, None) + transport = transport_class(credentials=creds, always_use_jwt_access=False) + use_jwt.assert_not_called() + + +@pytest.mark.parametrize("client_class", [ImageFamilyViewsClient,]) +def test_image_family_views_client_from_service_account_file(client_class): + creds = ga_credentials.AnonymousCredentials() + with mock.patch.object( + service_account.Credentials, "from_service_account_file" + ) as factory: + factory.return_value = creds + client = client_class.from_service_account_file("dummy/file/path.json") + assert client.transport._credentials == creds + assert isinstance(client, client_class) + + client = client_class.from_service_account_json("dummy/file/path.json") + assert client.transport._credentials == creds + assert isinstance(client, client_class) + + assert client.transport._host == "compute.googleapis.com:443" + + +def test_image_family_views_client_get_transport_class(): + transport = ImageFamilyViewsClient.get_transport_class() + available_transports = [ + transports.ImageFamilyViewsRestTransport, + ] + assert transport in available_transports + + transport = ImageFamilyViewsClient.get_transport_class("rest") + assert transport == transports.ImageFamilyViewsRestTransport + + +@pytest.mark.parametrize( + "client_class,transport_class,transport_name", + [(ImageFamilyViewsClient, transports.ImageFamilyViewsRestTransport, "rest"),], +) +@mock.patch.object( + ImageFamilyViewsClient, + "DEFAULT_ENDPOINT", + modify_default_endpoint(ImageFamilyViewsClient), +) +def test_image_family_views_client_client_options( + client_class, transport_class, transport_name +): + # Check that if channel is provided we won't create a new one. + with mock.patch.object(ImageFamilyViewsClient, "get_transport_class") as gtc: + transport = transport_class(credentials=ga_credentials.AnonymousCredentials()) + client = client_class(transport=transport) + gtc.assert_not_called() + + # Check that if channel is provided via str we will create a new one. + with mock.patch.object(ImageFamilyViewsClient, "get_transport_class") as gtc: + client = client_class(transport=transport_name) + gtc.assert_called() + + # Check the case api_endpoint is provided. + options = client_options.ClientOptions(api_endpoint="squid.clam.whelk") + with mock.patch.object(transport_class, "__init__") as patched: + patched.return_value = None + client = client_class(client_options=options) + patched.assert_called_once_with( + credentials=None, + credentials_file=None, + host="squid.clam.whelk", + scopes=None, + client_cert_source_for_mtls=None, + quota_project_id=None, + client_info=transports.base.DEFAULT_CLIENT_INFO, + ) + + # Check the case api_endpoint is not provided and GOOGLE_API_USE_MTLS_ENDPOINT is + # "never". + with mock.patch.dict(os.environ, {"GOOGLE_API_USE_MTLS_ENDPOINT": "never"}): + with mock.patch.object(transport_class, "__init__") as patched: + patched.return_value = None + client = client_class() + patched.assert_called_once_with( + credentials=None, + credentials_file=None, + host=client.DEFAULT_ENDPOINT, + scopes=None, + client_cert_source_for_mtls=None, + quota_project_id=None, + client_info=transports.base.DEFAULT_CLIENT_INFO, + ) + + # Check the case api_endpoint is not provided and GOOGLE_API_USE_MTLS_ENDPOINT is + # "always". + with mock.patch.dict(os.environ, {"GOOGLE_API_USE_MTLS_ENDPOINT": "always"}): + with mock.patch.object(transport_class, "__init__") as patched: + patched.return_value = None + client = client_class() + patched.assert_called_once_with( + credentials=None, + credentials_file=None, + host=client.DEFAULT_MTLS_ENDPOINT, + scopes=None, + client_cert_source_for_mtls=None, + quota_project_id=None, + client_info=transports.base.DEFAULT_CLIENT_INFO, + ) + + # Check the case api_endpoint is not provided and GOOGLE_API_USE_MTLS_ENDPOINT has + # unsupported value. + with mock.patch.dict(os.environ, {"GOOGLE_API_USE_MTLS_ENDPOINT": "Unsupported"}): + with pytest.raises(MutualTLSChannelError): + client = client_class() + + # Check the case GOOGLE_API_USE_CLIENT_CERTIFICATE has unsupported value. + with mock.patch.dict( + os.environ, {"GOOGLE_API_USE_CLIENT_CERTIFICATE": "Unsupported"} + ): + with pytest.raises(ValueError): + client = client_class() + + # Check the case quota_project_id is provided + options = client_options.ClientOptions(quota_project_id="octopus") + with mock.patch.object(transport_class, "__init__") as patched: + patched.return_value = None + client = client_class(client_options=options) + patched.assert_called_once_with( + credentials=None, + credentials_file=None, + host=client.DEFAULT_ENDPOINT, + scopes=None, + client_cert_source_for_mtls=None, + quota_project_id="octopus", + client_info=transports.base.DEFAULT_CLIENT_INFO, + ) + + +@pytest.mark.parametrize( + "client_class,transport_class,transport_name,use_client_cert_env", + [ + ( + ImageFamilyViewsClient, + transports.ImageFamilyViewsRestTransport, + "rest", + "true", + ), + ( + ImageFamilyViewsClient, + transports.ImageFamilyViewsRestTransport, + "rest", + "false", + ), + ], +) +@mock.patch.object( + ImageFamilyViewsClient, + "DEFAULT_ENDPOINT", + modify_default_endpoint(ImageFamilyViewsClient), +) +@mock.patch.dict(os.environ, {"GOOGLE_API_USE_MTLS_ENDPOINT": "auto"}) +def test_image_family_views_client_mtls_env_auto( + client_class, transport_class, transport_name, use_client_cert_env +): + # This tests the endpoint autoswitch behavior. Endpoint is autoswitched to the default + # mtls endpoint, if GOOGLE_API_USE_CLIENT_CERTIFICATE is "true" and client cert exists. + + # Check the case client_cert_source is provided. Whether client cert is used depends on + # GOOGLE_API_USE_CLIENT_CERTIFICATE value. + with mock.patch.dict( + os.environ, {"GOOGLE_API_USE_CLIENT_CERTIFICATE": use_client_cert_env} + ): + options = client_options.ClientOptions( + client_cert_source=client_cert_source_callback + ) + with mock.patch.object(transport_class, "__init__") as patched: + patched.return_value = None + client = client_class(client_options=options) + + if use_client_cert_env == "false": + expected_client_cert_source = None + expected_host = client.DEFAULT_ENDPOINT + else: + expected_client_cert_source = client_cert_source_callback + expected_host = client.DEFAULT_MTLS_ENDPOINT + + patched.assert_called_once_with( + credentials=None, + credentials_file=None, + host=expected_host, + scopes=None, + client_cert_source_for_mtls=expected_client_cert_source, + quota_project_id=None, + client_info=transports.base.DEFAULT_CLIENT_INFO, + ) + + # Check the case ADC client cert is provided. Whether client cert is used depends on + # GOOGLE_API_USE_CLIENT_CERTIFICATE value. + with mock.patch.dict( + os.environ, {"GOOGLE_API_USE_CLIENT_CERTIFICATE": use_client_cert_env} + ): + with mock.patch.object(transport_class, "__init__") as patched: + with mock.patch( + "google.auth.transport.mtls.has_default_client_cert_source", + return_value=True, + ): + with mock.patch( + "google.auth.transport.mtls.default_client_cert_source", + return_value=client_cert_source_callback, + ): + if use_client_cert_env == "false": + expected_host = client.DEFAULT_ENDPOINT + expected_client_cert_source = None + else: + expected_host = client.DEFAULT_MTLS_ENDPOINT + expected_client_cert_source = client_cert_source_callback + + patched.return_value = None + client = client_class() + patched.assert_called_once_with( + credentials=None, + credentials_file=None, + host=expected_host, + scopes=None, + client_cert_source_for_mtls=expected_client_cert_source, + quota_project_id=None, + client_info=transports.base.DEFAULT_CLIENT_INFO, + ) + + # Check the case client_cert_source and ADC client cert are not provided. + with mock.patch.dict( + os.environ, {"GOOGLE_API_USE_CLIENT_CERTIFICATE": use_client_cert_env} + ): + with mock.patch.object(transport_class, "__init__") as patched: + with mock.patch( + "google.auth.transport.mtls.has_default_client_cert_source", + return_value=False, + ): + patched.return_value = None + client = client_class() + patched.assert_called_once_with( + credentials=None, + credentials_file=None, + host=client.DEFAULT_ENDPOINT, + scopes=None, + client_cert_source_for_mtls=None, + quota_project_id=None, + client_info=transports.base.DEFAULT_CLIENT_INFO, + ) + + +@pytest.mark.parametrize( + "client_class,transport_class,transport_name", + [(ImageFamilyViewsClient, transports.ImageFamilyViewsRestTransport, "rest"),], +) +def test_image_family_views_client_client_options_scopes( + client_class, transport_class, transport_name +): + # Check the case scopes are provided. + options = client_options.ClientOptions(scopes=["1", "2"],) + with mock.patch.object(transport_class, "__init__") as patched: + patched.return_value = None + client = client_class(client_options=options) + patched.assert_called_once_with( + credentials=None, + credentials_file=None, + host=client.DEFAULT_ENDPOINT, + scopes=["1", "2"], + client_cert_source_for_mtls=None, + quota_project_id=None, + client_info=transports.base.DEFAULT_CLIENT_INFO, + ) + + +@pytest.mark.parametrize( + "client_class,transport_class,transport_name", + [(ImageFamilyViewsClient, transports.ImageFamilyViewsRestTransport, "rest"),], +) +def test_image_family_views_client_client_options_credentials_file( + client_class, transport_class, transport_name +): + # Check the case credentials file is provided. + options = client_options.ClientOptions(credentials_file="credentials.json") + with mock.patch.object(transport_class, "__init__") as patched: + patched.return_value = None + client = client_class(client_options=options) + patched.assert_called_once_with( + credentials=None, + credentials_file="credentials.json", + host=client.DEFAULT_ENDPOINT, + scopes=None, + client_cert_source_for_mtls=None, + quota_project_id=None, + client_info=transports.base.DEFAULT_CLIENT_INFO, + ) + + +def test_get_rest( + transport: str = "rest", request_type=compute.GetImageFamilyViewRequest +): + client = ImageFamilyViewsClient( + credentials=ga_credentials.AnonymousCredentials(), transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # Designate an appropriate value for the returned response. + return_value = compute.ImageFamilyView( + image=compute.Image(archive_size_bytes=1922), + ) + + # Wrap the value into a proper Response obj + json_return_value = compute.ImageFamilyView.to_json(return_value) + response_value = Response() + response_value.status_code = 200 + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + response = client.get(request) + + # Establish that the response is the type that we expect. + assert isinstance(response, compute.ImageFamilyView) + assert response.image == compute.Image(archive_size_bytes=1922) + + +def test_get_rest_from_dict(): + test_get_rest(request_type=dict) + + +def test_get_rest_flattened(): + client = ImageFamilyViewsClient(credentials=ga_credentials.AnonymousCredentials(),) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # Designate an appropriate value for the returned response. + return_value = compute.ImageFamilyView() + + # Wrap the value into a proper Response obj + json_return_value = compute.ImageFamilyView.to_json(return_value) + response_value = Response() + response_value.status_code = 200 + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + client.get( + project="project_value", zone="zone_value", family="family_value", + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(req.mock_calls) == 1 + _, http_call, http_params = req.mock_calls[0] + body = http_params.get("data") + params = http_params.get("params") + assert "project_value" in http_call[1] + str(body) + str(params) + assert "zone_value" in http_call[1] + str(body) + str(params) + assert "family_value" in http_call[1] + str(body) + str(params) + + +def test_get_rest_flattened_error(): + client = ImageFamilyViewsClient(credentials=ga_credentials.AnonymousCredentials(),) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.get( + compute.GetImageFamilyViewRequest(), + project="project_value", + zone="zone_value", + family="family_value", + ) + + +def test_credentials_transport_error(): + # It is an error to provide credentials and a transport instance. + transport = transports.ImageFamilyViewsRestTransport( + credentials=ga_credentials.AnonymousCredentials(), + ) + with pytest.raises(ValueError): + client = ImageFamilyViewsClient( + credentials=ga_credentials.AnonymousCredentials(), transport=transport, + ) + + # It is an error to provide a credentials file and a transport instance. + transport = transports.ImageFamilyViewsRestTransport( + credentials=ga_credentials.AnonymousCredentials(), + ) + with pytest.raises(ValueError): + client = ImageFamilyViewsClient( + client_options={"credentials_file": "credentials.json"}, + transport=transport, + ) + + # It is an error to provide scopes and a transport instance. + transport = transports.ImageFamilyViewsRestTransport( + credentials=ga_credentials.AnonymousCredentials(), + ) + with pytest.raises(ValueError): + client = ImageFamilyViewsClient( + client_options={"scopes": ["1", "2"]}, transport=transport, + ) + + +def test_transport_instance(): + # A client may be instantiated with a custom transport instance. + transport = transports.ImageFamilyViewsRestTransport( + credentials=ga_credentials.AnonymousCredentials(), + ) + client = ImageFamilyViewsClient(transport=transport) + assert client.transport is transport + + +@pytest.mark.parametrize("transport_class", [transports.ImageFamilyViewsRestTransport,]) +def test_transport_adc(transport_class): + # Test default credentials are used if not provided. + with mock.patch.object(google.auth, "default") as adc: + adc.return_value = (ga_credentials.AnonymousCredentials(), None) + transport_class() + adc.assert_called_once() + + +def test_image_family_views_base_transport_error(): + # Passing both a credentials object and credentials_file should raise an error + with pytest.raises(core_exceptions.DuplicateCredentialArgs): + transport = transports.ImageFamilyViewsTransport( + credentials=ga_credentials.AnonymousCredentials(), + credentials_file="credentials.json", + ) + + +def test_image_family_views_base_transport(): + # Instantiate the base transport. + with mock.patch( + "google.cloud.compute_v1.services.image_family_views.transports.ImageFamilyViewsTransport.__init__" + ) as Transport: + Transport.return_value = None + transport = transports.ImageFamilyViewsTransport( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Every method on the transport should just blindly + # raise NotImplementedError. + methods = ("get",) + for method in methods: + with pytest.raises(NotImplementedError): + getattr(transport, method)(request=object()) + + +@requires_google_auth_gte_1_25_0 +def test_image_family_views_base_transport_with_credentials_file(): + # Instantiate the base transport with a credentials file + with mock.patch.object( + google.auth, "load_credentials_from_file", autospec=True + ) as load_creds, mock.patch( + "google.cloud.compute_v1.services.image_family_views.transports.ImageFamilyViewsTransport._prep_wrapped_messages" + ) as Transport: + Transport.return_value = None + load_creds.return_value = (ga_credentials.AnonymousCredentials(), None) + transport = transports.ImageFamilyViewsTransport( + credentials_file="credentials.json", quota_project_id="octopus", + ) + load_creds.assert_called_once_with( + "credentials.json", + scopes=None, + default_scopes=( + "https://www.googleapis.com/auth/compute.readonly", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/cloud-platform", + ), + quota_project_id="octopus", + ) + + +@requires_google_auth_lt_1_25_0 +def test_image_family_views_base_transport_with_credentials_file_old_google_auth(): + # Instantiate the base transport with a credentials file + with mock.patch.object( + google.auth, "load_credentials_from_file", autospec=True + ) as load_creds, mock.patch( + "google.cloud.compute_v1.services.image_family_views.transports.ImageFamilyViewsTransport._prep_wrapped_messages" + ) as Transport: + Transport.return_value = None + load_creds.return_value = (ga_credentials.AnonymousCredentials(), None) + transport = transports.ImageFamilyViewsTransport( + credentials_file="credentials.json", quota_project_id="octopus", + ) + load_creds.assert_called_once_with( + "credentials.json", + scopes=( + "https://www.googleapis.com/auth/compute.readonly", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/cloud-platform", + ), + quota_project_id="octopus", + ) + + +def test_image_family_views_base_transport_with_adc(): + # Test the default credentials are used if credentials and credentials_file are None. + with mock.patch.object(google.auth, "default", autospec=True) as adc, mock.patch( + "google.cloud.compute_v1.services.image_family_views.transports.ImageFamilyViewsTransport._prep_wrapped_messages" + ) as Transport: + Transport.return_value = None + adc.return_value = (ga_credentials.AnonymousCredentials(), None) + transport = transports.ImageFamilyViewsTransport() + adc.assert_called_once() + + +@requires_google_auth_gte_1_25_0 +def test_image_family_views_auth_adc(): + # If no credentials are provided, we should use ADC credentials. + with mock.patch.object(google.auth, "default", autospec=True) as adc: + adc.return_value = (ga_credentials.AnonymousCredentials(), None) + ImageFamilyViewsClient() + adc.assert_called_once_with( + scopes=None, + default_scopes=( + "https://www.googleapis.com/auth/compute.readonly", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/cloud-platform", + ), + quota_project_id=None, + ) + + +@requires_google_auth_lt_1_25_0 +def test_image_family_views_auth_adc_old_google_auth(): + # If no credentials are provided, we should use ADC credentials. + with mock.patch.object(google.auth, "default", autospec=True) as adc: + adc.return_value = (ga_credentials.AnonymousCredentials(), None) + ImageFamilyViewsClient() + adc.assert_called_once_with( + scopes=( + "https://www.googleapis.com/auth/compute.readonly", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/cloud-platform", + ), + quota_project_id=None, + ) + + +def test_image_family_views_http_transport_client_cert_source_for_mtls(): + cred = ga_credentials.AnonymousCredentials() + with mock.patch( + "google.auth.transport.requests.AuthorizedSession.configure_mtls_channel" + ) as mock_configure_mtls_channel: + transports.ImageFamilyViewsRestTransport( + credentials=cred, client_cert_source_for_mtls=client_cert_source_callback + ) + mock_configure_mtls_channel.assert_called_once_with(client_cert_source_callback) + + +def test_image_family_views_host_no_port(): + client = ImageFamilyViewsClient( + credentials=ga_credentials.AnonymousCredentials(), + client_options=client_options.ClientOptions( + api_endpoint="compute.googleapis.com" + ), + ) + assert client.transport._host == "compute.googleapis.com:443" + + +def test_image_family_views_host_with_port(): + client = ImageFamilyViewsClient( + credentials=ga_credentials.AnonymousCredentials(), + client_options=client_options.ClientOptions( + api_endpoint="compute.googleapis.com:8000" + ), + ) + assert client.transport._host == "compute.googleapis.com:8000" + + +def test_common_billing_account_path(): + billing_account = "squid" + expected = "billingAccounts/{billing_account}".format( + billing_account=billing_account, + ) + actual = ImageFamilyViewsClient.common_billing_account_path(billing_account) + assert expected == actual + + +def test_parse_common_billing_account_path(): + expected = { + "billing_account": "clam", + } + path = ImageFamilyViewsClient.common_billing_account_path(**expected) + + # Check that the path construction is reversible. + actual = ImageFamilyViewsClient.parse_common_billing_account_path(path) + assert expected == actual + + +def test_common_folder_path(): + folder = "whelk" + expected = "folders/{folder}".format(folder=folder,) + actual = ImageFamilyViewsClient.common_folder_path(folder) + assert expected == actual + + +def test_parse_common_folder_path(): + expected = { + "folder": "octopus", + } + path = ImageFamilyViewsClient.common_folder_path(**expected) + + # Check that the path construction is reversible. + actual = ImageFamilyViewsClient.parse_common_folder_path(path) + assert expected == actual + + +def test_common_organization_path(): + organization = "oyster" + expected = "organizations/{organization}".format(organization=organization,) + actual = ImageFamilyViewsClient.common_organization_path(organization) + assert expected == actual + + +def test_parse_common_organization_path(): + expected = { + "organization": "nudibranch", + } + path = ImageFamilyViewsClient.common_organization_path(**expected) + + # Check that the path construction is reversible. + actual = ImageFamilyViewsClient.parse_common_organization_path(path) + assert expected == actual + + +def test_common_project_path(): + project = "cuttlefish" + expected = "projects/{project}".format(project=project,) + actual = ImageFamilyViewsClient.common_project_path(project) + assert expected == actual + + +def test_parse_common_project_path(): + expected = { + "project": "mussel", + } + path = ImageFamilyViewsClient.common_project_path(**expected) + + # Check that the path construction is reversible. + actual = ImageFamilyViewsClient.parse_common_project_path(path) + assert expected == actual + + +def test_common_location_path(): + project = "winkle" + location = "nautilus" + expected = "projects/{project}/locations/{location}".format( + project=project, location=location, + ) + actual = ImageFamilyViewsClient.common_location_path(project, location) + assert expected == actual + + +def test_parse_common_location_path(): + expected = { + "project": "scallop", + "location": "abalone", + } + path = ImageFamilyViewsClient.common_location_path(**expected) + + # Check that the path construction is reversible. + actual = ImageFamilyViewsClient.parse_common_location_path(path) + assert expected == actual + + +def test_client_withDEFAULT_CLIENT_INFO(): + client_info = gapic_v1.client_info.ClientInfo() + + with mock.patch.object( + transports.ImageFamilyViewsTransport, "_prep_wrapped_messages" + ) as prep: + client = ImageFamilyViewsClient( + credentials=ga_credentials.AnonymousCredentials(), client_info=client_info, + ) + prep.assert_called_once_with(client_info) + + with mock.patch.object( + transports.ImageFamilyViewsTransport, "_prep_wrapped_messages" + ) as prep: + transport_class = ImageFamilyViewsClient.get_transport_class() + transport = transport_class( + credentials=ga_credentials.AnonymousCredentials(), client_info=client_info, + ) + prep.assert_called_once_with(client_info) diff --git a/tests/unit/gapic/compute_v1/test_instances.py b/tests/unit/gapic/compute_v1/test_instances.py index a4930d907..74f3870c3 100644 --- a/tests/unit/gapic/compute_v1/test_instances.py +++ b/tests/unit/gapic/compute_v1/test_instances.py @@ -504,7 +504,9 @@ def test_add_access_config_rest_flattened(): # Call the method with a truthy value for each flattened field, # using the keyword arguments to the method. - access_config_resource = compute.AccessConfig(kind="kind_value") + access_config_resource = compute.AccessConfig( + external_ipv6="external_ipv6_value" + ) client.add_access_config( project="project_value", zone="zone_value", @@ -542,7 +544,9 @@ def test_add_access_config_rest_flattened_error(): zone="zone_value", instance="instance_value", network_interface="network_interface_value", - access_config_resource=compute.AccessConfig(kind="kind_value"), + access_config_resource=compute.AccessConfig( + external_ipv6="external_ipv6_value" + ), ) @@ -1576,7 +1580,9 @@ def test_get_rest(transport: str = "rest", request_type=compute.GetInstanceReque name="name_value", network_interfaces=[ compute.NetworkInterface( - access_configs=[compute.AccessConfig(kind="kind_value")] + access_configs=[ + compute.AccessConfig(external_ipv6="external_ipv6_value") + ] ) ], private_ipv6_google_access=compute.Instance.PrivateIpv6GoogleAccess.ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE, @@ -1642,7 +1648,7 @@ def test_get_rest(transport: str = "rest", request_type=compute.GetInstanceReque assert response.name == "name_value" assert response.network_interfaces == [ compute.NetworkInterface( - access_configs=[compute.AccessConfig(kind="kind_value")] + access_configs=[compute.AccessConfig(external_ipv6="external_ipv6_value")] ) ] assert ( @@ -2974,6 +2980,88 @@ def test_reset_rest_flattened_error(): ) +def test_send_diagnostic_interrupt_rest( + transport: str = "rest", request_type=compute.SendDiagnosticInterruptInstanceRequest +): + client = InstancesClient( + credentials=ga_credentials.AnonymousCredentials(), transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # Designate an appropriate value for the returned response. + return_value = compute.SendDiagnosticInterruptInstanceResponse() + + # Wrap the value into a proper Response obj + json_return_value = compute.SendDiagnosticInterruptInstanceResponse.to_json( + return_value + ) + response_value = Response() + response_value.status_code = 200 + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + response = client.send_diagnostic_interrupt(request) + + # Establish that the response is the type that we expect. + assert isinstance(response, compute.SendDiagnosticInterruptInstanceResponse) + + +def test_send_diagnostic_interrupt_rest_from_dict(): + test_send_diagnostic_interrupt_rest(request_type=dict) + + +def test_send_diagnostic_interrupt_rest_flattened(): + client = InstancesClient(credentials=ga_credentials.AnonymousCredentials(),) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # Designate an appropriate value for the returned response. + return_value = compute.SendDiagnosticInterruptInstanceResponse() + + # Wrap the value into a proper Response obj + json_return_value = compute.SendDiagnosticInterruptInstanceResponse.to_json( + return_value + ) + response_value = Response() + response_value.status_code = 200 + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + client.send_diagnostic_interrupt( + project="project_value", zone="zone_value", instance="instance_value", + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(req.mock_calls) == 1 + _, http_call, http_params = req.mock_calls[0] + body = http_params.get("data") + params = http_params.get("params") + assert "project_value" in http_call[1] + str(body) + str(params) + assert "zone_value" in http_call[1] + str(body) + str(params) + assert "instance_value" in http_call[1] + str(body) + str(params) + + +def test_send_diagnostic_interrupt_rest_flattened_error(): + client = InstancesClient(credentials=ga_credentials.AnonymousCredentials(),) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.send_diagnostic_interrupt( + compute.SendDiagnosticInterruptInstanceRequest(), + project="project_value", + zone="zone_value", + instance="instance_value", + ) + + def test_set_deletion_protection_rest( transport: str = "rest", request_type=compute.SetDeletionProtectionInstanceRequest ): @@ -5516,7 +5604,9 @@ def test_update_access_config_rest_flattened(): # Call the method with a truthy value for each flattened field, # using the keyword arguments to the method. - access_config_resource = compute.AccessConfig(kind="kind_value") + access_config_resource = compute.AccessConfig( + external_ipv6="external_ipv6_value" + ) client.update_access_config( project="project_value", zone="zone_value", @@ -5554,7 +5644,9 @@ def test_update_access_config_rest_flattened_error(): zone="zone_value", instance="instance_value", network_interface="network_interface_value", - access_config_resource=compute.AccessConfig(kind="kind_value"), + access_config_resource=compute.AccessConfig( + external_ipv6="external_ipv6_value" + ), ) @@ -5798,7 +5890,7 @@ def test_update_network_interface_rest_flattened(): # Call the method with a truthy value for each flattened field, # using the keyword arguments to the method. network_interface_resource = compute.NetworkInterface( - access_configs=[compute.AccessConfig(kind="kind_value")] + access_configs=[compute.AccessConfig(external_ipv6="external_ipv6_value")] ) client.update_network_interface( project="project_value", @@ -5838,7 +5930,9 @@ def test_update_network_interface_rest_flattened_error(): instance="instance_value", network_interface="network_interface_value", network_interface_resource=compute.NetworkInterface( - access_configs=[compute.AccessConfig(kind="kind_value")] + access_configs=[ + compute.AccessConfig(external_ipv6="external_ipv6_value") + ] ), ) @@ -6077,6 +6171,7 @@ def test_instances_base_transport(): "list_referrers", "remove_resource_policies", "reset", + "send_diagnostic_interrupt", "set_deletion_protection", "set_disk_auto_delete", "set_iam_policy", diff --git a/tests/unit/gapic/compute_v1/test_interconnect_attachments.py b/tests/unit/gapic/compute_v1/test_interconnect_attachments.py index f325c86cc..5b689fac1 100644 --- a/tests/unit/gapic/compute_v1/test_interconnect_attachments.py +++ b/tests/unit/gapic/compute_v1/test_interconnect_attachments.py @@ -803,6 +803,7 @@ def test_get_rest( ), region="region_value", router="router_value", + satisfies_pzs=True, self_link="self_link_value", state=compute.InterconnectAttachment.State.ACTIVE, type_=compute.InterconnectAttachment.Type.DEDICATED, @@ -854,6 +855,7 @@ def test_get_rest( ) assert response.region == "region_value" assert response.router == "router_value" + assert response.satisfies_pzs is True assert response.self_link == "self_link_value" assert response.state == compute.InterconnectAttachment.State.ACTIVE assert response.type_ == compute.InterconnectAttachment.Type.DEDICATED diff --git a/tests/unit/gapic/compute_v1/test_interconnect_locations.py b/tests/unit/gapic/compute_v1/test_interconnect_locations.py index 7312bc97b..6a16bee3b 100644 --- a/tests/unit/gapic/compute_v1/test_interconnect_locations.py +++ b/tests/unit/gapic/compute_v1/test_interconnect_locations.py @@ -477,6 +477,7 @@ def test_get_rest( region_infos=[compute.InterconnectLocationRegionInfo(expected_rtt_ms=1610)], self_link="self_link_value", status=compute.InterconnectLocation.Status.AVAILABLE, + supports_pzs=True, ) # Wrap the value into a proper Response obj @@ -508,6 +509,7 @@ def test_get_rest( ] assert response.self_link == "self_link_value" assert response.status == compute.InterconnectLocation.Status.AVAILABLE + assert response.supports_pzs is True def test_get_rest_from_dict(): diff --git a/tests/unit/gapic/compute_v1/test_interconnects.py b/tests/unit/gapic/compute_v1/test_interconnects.py index e26bf7831..53937d7af 100644 --- a/tests/unit/gapic/compute_v1/test_interconnects.py +++ b/tests/unit/gapic/compute_v1/test_interconnects.py @@ -583,6 +583,7 @@ def test_get_rest(transport: str = "rest", request_type=compute.GetInterconnectR peer_ip_address="peer_ip_address_value", provisioned_link_count=2375, requested_link_count=2151, + satisfies_pzs=True, self_link="self_link_value", state=compute.Interconnect.State.ACTIVE, ) @@ -627,6 +628,7 @@ def test_get_rest(transport: str = "rest", request_type=compute.GetInterconnectR assert response.peer_ip_address == "peer_ip_address_value" assert response.provisioned_link_count == 2375 assert response.requested_link_count == 2151 + assert response.satisfies_pzs is True assert response.self_link == "self_link_value" assert response.state == compute.Interconnect.State.ACTIVE diff --git a/tests/unit/gapic/compute_v1/test_region_backend_services.py b/tests/unit/gapic/compute_v1/test_region_backend_services.py index e92ab0aa4..3121e0cfb 100644 --- a/tests/unit/gapic/compute_v1/test_region_backend_services.py +++ b/tests/unit/gapic/compute_v1/test_region_backend_services.py @@ -647,6 +647,9 @@ def test_get_rest( ), self_link="self_link_value", session_affinity=compute.BackendService.SessionAffinity.CLIENT_IP, + subsetting=compute.Subsetting( + policy=compute.Subsetting.Policy.CONSISTENT_HASH_SUBSETTING + ), timeout_sec=1185, ) @@ -718,6 +721,9 @@ def test_get_rest( ) assert response.self_link == "self_link_value" assert response.session_affinity == compute.BackendService.SessionAffinity.CLIENT_IP + assert response.subsetting == compute.Subsetting( + policy=compute.Subsetting.Policy.CONSISTENT_HASH_SUBSETTING + ) assert response.timeout_sec == 1185 diff --git a/tests/unit/gapic/compute_v1/test_region_commitments.py b/tests/unit/gapic/compute_v1/test_region_commitments.py index 646b10fe4..8f7db121b 100644 --- a/tests/unit/gapic/compute_v1/test_region_commitments.py +++ b/tests/unit/gapic/compute_v1/test_region_commitments.py @@ -625,6 +625,7 @@ def test_get_rest( start_timestamp="start_timestamp_value", status=compute.Commitment.Status.ACTIVE, status_message="status_message_value", + type_=compute.Commitment.Type.ACCELERATOR_OPTIMIZED, ) # Wrap the value into a proper Response obj @@ -655,6 +656,7 @@ def test_get_rest( assert response.start_timestamp == "start_timestamp_value" assert response.status == compute.Commitment.Status.ACTIVE assert response.status_message == "status_message_value" + assert response.type_ == compute.Commitment.Type.ACCELERATOR_OPTIMIZED def test_get_rest_from_dict(): diff --git a/tests/unit/gapic/compute_v1/test_routers.py b/tests/unit/gapic/compute_v1/test_routers.py index 10545aa69..92e1c8043 100644 --- a/tests/unit/gapic/compute_v1/test_routers.py +++ b/tests/unit/gapic/compute_v1/test_routers.py @@ -969,7 +969,7 @@ def test_get_router_status_rest( kind="kind_value", result=compute.RouterStatus( best_routes=[ - compute.Route(creation_timestamp="creation_timestamp_value") + compute.Route(as_paths=[compute.RouteAsPath(as_lists=[866])]) ] ), ) @@ -986,7 +986,7 @@ def test_get_router_status_rest( assert isinstance(response, compute.RouterStatusResponse) assert response.kind == "kind_value" assert response.result == compute.RouterStatus( - best_routes=[compute.Route(creation_timestamp="creation_timestamp_value")] + best_routes=[compute.Route(as_paths=[compute.RouteAsPath(as_lists=[866])])] ) diff --git a/tests/unit/gapic/compute_v1/test_routes.py b/tests/unit/gapic/compute_v1/test_routes.py index aed46e74a..bc31a26d7 100644 --- a/tests/unit/gapic/compute_v1/test_routes.py +++ b/tests/unit/gapic/compute_v1/test_routes.py @@ -535,6 +535,7 @@ def test_get_rest(transport: str = "rest", request_type=compute.GetRouteRequest) with mock.patch.object(Session, "request") as req: # Designate an appropriate value for the returned response. return_value = compute.Route( + as_paths=[compute.RouteAsPath(as_lists=[866])], creation_timestamp="creation_timestamp_value", description="description_value", dest_range="dest_range_value", @@ -550,6 +551,7 @@ def test_get_rest(transport: str = "rest", request_type=compute.GetRouteRequest) next_hop_peering="next_hop_peering_value", next_hop_vpn_tunnel="next_hop_vpn_tunnel_value", priority=898, + route_type=compute.Route.RouteType.BGP, self_link="self_link_value", tags=["tags_value"], warnings=[compute.Warnings(code=compute.Warnings.Code.CLEANUP_FAILED)], @@ -565,6 +567,7 @@ def test_get_rest(transport: str = "rest", request_type=compute.GetRouteRequest) # Establish that the response is the type that we expect. assert isinstance(response, compute.Route) + assert response.as_paths == [compute.RouteAsPath(as_lists=[866])] assert response.creation_timestamp == "creation_timestamp_value" assert response.description == "description_value" assert response.dest_range == "dest_range_value" @@ -580,6 +583,7 @@ def test_get_rest(transport: str = "rest", request_type=compute.GetRouteRequest) assert response.next_hop_peering == "next_hop_peering_value" assert response.next_hop_vpn_tunnel == "next_hop_vpn_tunnel_value" assert response.priority == 898 + assert response.route_type == compute.Route.RouteType.BGP assert response.self_link == "self_link_value" assert response.tags == ["tags_value"] assert response.warnings == [ @@ -731,7 +735,7 @@ def test_insert_rest_flattened(): # Call the method with a truthy value for each flattened field, # using the keyword arguments to the method. - route_resource = compute.Route(creation_timestamp="creation_timestamp_value") + route_resource = compute.Route(as_paths=[compute.RouteAsPath(as_lists=[866])]) client.insert( project="project_value", route_resource=route_resource, ) @@ -759,7 +763,9 @@ def test_insert_rest_flattened_error(): client.insert( compute.InsertRouteRequest(), project="project_value", - route_resource=compute.Route(creation_timestamp="creation_timestamp_value"), + route_resource=compute.Route( + as_paths=[compute.RouteAsPath(as_lists=[866])] + ), ) @@ -777,7 +783,7 @@ def test_list_rest(transport: str = "rest", request_type=compute.ListRoutesReque # Designate an appropriate value for the returned response. return_value = compute.RouteList( id="id_value", - items=[compute.Route(creation_timestamp="creation_timestamp_value")], + items=[compute.Route(as_paths=[compute.RouteAsPath(as_lists=[866])])], kind="kind_value", next_page_token="next_page_token_value", self_link="self_link_value", @@ -796,7 +802,7 @@ def test_list_rest(transport: str = "rest", request_type=compute.ListRoutesReque assert isinstance(response, pagers.ListPager) assert response.id == "id_value" assert response.items == [ - compute.Route(creation_timestamp="creation_timestamp_value") + compute.Route(as_paths=[compute.RouteAsPath(as_lists=[866])]) ] assert response.kind == "kind_value" assert response.next_page_token == "next_page_token_value" diff --git a/tests/unit/gapic/compute_v1/test_security_policies.py b/tests/unit/gapic/compute_v1/test_security_policies.py index 7db7b6e47..d923c3993 100644 --- a/tests/unit/gapic/compute_v1/test_security_policies.py +++ b/tests/unit/gapic/compute_v1/test_security_policies.py @@ -709,6 +709,14 @@ def test_get_rest( with mock.patch.object(Session, "request") as req: # Designate an appropriate value for the returned response. return_value = compute.SecurityPolicy( + adaptive_protection_config=compute.SecurityPolicyAdaptiveProtectionConfig( + layer7_ddos_defense_config=compute.SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig( + enable=True + ) + ), + advanced_options_config=compute.SecurityPolicyAdvancedOptionsConfig( + json_parsing=compute.SecurityPolicyAdvancedOptionsConfig.JsonParsing.DISABLED + ), creation_timestamp="creation_timestamp_value", description="description_value", fingerprint="fingerprint_value", @@ -729,6 +737,20 @@ def test_get_rest( # Establish that the response is the type that we expect. assert isinstance(response, compute.SecurityPolicy) + assert ( + response.adaptive_protection_config + == compute.SecurityPolicyAdaptiveProtectionConfig( + layer7_ddos_defense_config=compute.SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig( + enable=True + ) + ) + ) + assert ( + response.advanced_options_config + == compute.SecurityPolicyAdvancedOptionsConfig( + json_parsing=compute.SecurityPolicyAdvancedOptionsConfig.JsonParsing.DISABLED + ) + ) assert response.creation_timestamp == "creation_timestamp_value" assert response.description == "description_value" assert response.fingerprint == "fingerprint_value" @@ -985,7 +1007,11 @@ def test_insert_rest_flattened(): # Call the method with a truthy value for each flattened field, # using the keyword arguments to the method. security_policy_resource = compute.SecurityPolicy( - creation_timestamp="creation_timestamp_value" + adaptive_protection_config=compute.SecurityPolicyAdaptiveProtectionConfig( + layer7_ddos_defense_config=compute.SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig( + enable=True + ) + ) ) client.insert( project="project_value", security_policy_resource=security_policy_resource, @@ -1015,7 +1041,11 @@ def test_insert_rest_flattened_error(): compute.InsertSecurityPolicyRequest(), project="project_value", security_policy_resource=compute.SecurityPolicy( - creation_timestamp="creation_timestamp_value" + adaptive_protection_config=compute.SecurityPolicyAdaptiveProtectionConfig( + layer7_ddos_defense_config=compute.SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig( + enable=True + ) + ) ), ) @@ -1037,7 +1067,13 @@ def test_list_rest( return_value = compute.SecurityPolicyList( id="id_value", items=[ - compute.SecurityPolicy(creation_timestamp="creation_timestamp_value") + compute.SecurityPolicy( + adaptive_protection_config=compute.SecurityPolicyAdaptiveProtectionConfig( + layer7_ddos_defense_config=compute.SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig( + enable=True + ) + ) + ) ], kind="kind_value", next_page_token="next_page_token_value", @@ -1056,7 +1092,13 @@ def test_list_rest( assert isinstance(response, pagers.ListPager) assert response.id == "id_value" assert response.items == [ - compute.SecurityPolicy(creation_timestamp="creation_timestamp_value") + compute.SecurityPolicy( + adaptive_protection_config=compute.SecurityPolicyAdaptiveProtectionConfig( + layer7_ddos_defense_config=compute.SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig( + enable=True + ) + ) + ) ] assert response.kind == "kind_value" assert response.next_page_token == "next_page_token_value" @@ -1347,7 +1389,11 @@ def test_patch_rest_flattened(): # Call the method with a truthy value for each flattened field, # using the keyword arguments to the method. security_policy_resource = compute.SecurityPolicy( - creation_timestamp="creation_timestamp_value" + adaptive_protection_config=compute.SecurityPolicyAdaptiveProtectionConfig( + layer7_ddos_defense_config=compute.SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig( + enable=True + ) + ) ) client.patch( project="project_value", @@ -1381,7 +1427,11 @@ def test_patch_rest_flattened_error(): project="project_value", security_policy="security_policy_value", security_policy_resource=compute.SecurityPolicy( - creation_timestamp="creation_timestamp_value" + adaptive_protection_config=compute.SecurityPolicyAdaptiveProtectionConfig( + layer7_ddos_defense_config=compute.SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig( + enable=True + ) + ) ), ) diff --git a/tests/unit/gapic/compute_v1/test_service_attachments.py b/tests/unit/gapic/compute_v1/test_service_attachments.py new file mode 100644 index 000000000..34da9328a --- /dev/null +++ b/tests/unit/gapic/compute_v1/test_service_attachments.py @@ -0,0 +1,1997 @@ +# -*- coding: utf-8 -*- +# Copyright 2020 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +import os +import mock +import packaging.version + +import grpc +from grpc.experimental import aio +import math +import pytest +from proto.marshal.rules.dates import DurationRule, TimestampRule + +from requests import Response +from requests.sessions import Session + +from google.api_core import client_options +from google.api_core import exceptions as core_exceptions +from google.api_core import gapic_v1 +from google.api_core import grpc_helpers +from google.api_core import grpc_helpers_async +from google.auth import credentials as ga_credentials +from google.auth.exceptions import MutualTLSChannelError +from google.cloud.compute_v1.services.service_attachments import ( + ServiceAttachmentsClient, +) +from google.cloud.compute_v1.services.service_attachments import pagers +from google.cloud.compute_v1.services.service_attachments import transports +from google.cloud.compute_v1.services.service_attachments.transports.base import ( + _GOOGLE_AUTH_VERSION, +) +from google.cloud.compute_v1.types import compute +from google.oauth2 import service_account +import google.auth + + +# TODO(busunkim): Once google-auth >= 1.25.0 is required transitively +# through google-api-core: +# - Delete the auth "less than" test cases +# - Delete these pytest markers (Make the "greater than or equal to" tests the default). +requires_google_auth_lt_1_25_0 = pytest.mark.skipif( + packaging.version.parse(_GOOGLE_AUTH_VERSION) >= packaging.version.parse("1.25.0"), + reason="This test requires google-auth < 1.25.0", +) +requires_google_auth_gte_1_25_0 = pytest.mark.skipif( + packaging.version.parse(_GOOGLE_AUTH_VERSION) < packaging.version.parse("1.25.0"), + reason="This test requires google-auth >= 1.25.0", +) + + +def client_cert_source_callback(): + return b"cert bytes", b"key bytes" + + +# If default endpoint is localhost, then default mtls endpoint will be the same. +# This method modifies the default endpoint so the client can produce a different +# mtls endpoint for endpoint testing purposes. +def modify_default_endpoint(client): + return ( + "foo.googleapis.com" + if ("localhost" in client.DEFAULT_ENDPOINT) + else client.DEFAULT_ENDPOINT + ) + + +def test__get_default_mtls_endpoint(): + api_endpoint = "example.googleapis.com" + api_mtls_endpoint = "example.mtls.googleapis.com" + sandbox_endpoint = "example.sandbox.googleapis.com" + sandbox_mtls_endpoint = "example.mtls.sandbox.googleapis.com" + non_googleapi = "api.example.com" + + assert ServiceAttachmentsClient._get_default_mtls_endpoint(None) is None + assert ( + ServiceAttachmentsClient._get_default_mtls_endpoint(api_endpoint) + == api_mtls_endpoint + ) + assert ( + ServiceAttachmentsClient._get_default_mtls_endpoint(api_mtls_endpoint) + == api_mtls_endpoint + ) + assert ( + ServiceAttachmentsClient._get_default_mtls_endpoint(sandbox_endpoint) + == sandbox_mtls_endpoint + ) + assert ( + ServiceAttachmentsClient._get_default_mtls_endpoint(sandbox_mtls_endpoint) + == sandbox_mtls_endpoint + ) + assert ( + ServiceAttachmentsClient._get_default_mtls_endpoint(non_googleapi) + == non_googleapi + ) + + +@pytest.mark.parametrize("client_class", [ServiceAttachmentsClient,]) +def test_service_attachments_client_from_service_account_info(client_class): + creds = ga_credentials.AnonymousCredentials() + with mock.patch.object( + service_account.Credentials, "from_service_account_info" + ) as factory: + factory.return_value = creds + info = {"valid": True} + client = client_class.from_service_account_info(info) + assert client.transport._credentials == creds + assert isinstance(client, client_class) + + assert client.transport._host == "compute.googleapis.com:443" + + +@pytest.mark.parametrize( + "transport_class,transport_name", + [(transports.ServiceAttachmentsRestTransport, "rest"),], +) +def test_service_attachments_client_service_account_always_use_jwt( + transport_class, transport_name +): + with mock.patch.object( + service_account.Credentials, "with_always_use_jwt_access", create=True + ) as use_jwt: + creds = service_account.Credentials(None, None, None) + transport = transport_class(credentials=creds, always_use_jwt_access=True) + use_jwt.assert_called_once_with(True) + + with mock.patch.object( + service_account.Credentials, "with_always_use_jwt_access", create=True + ) as use_jwt: + creds = service_account.Credentials(None, None, None) + transport = transport_class(credentials=creds, always_use_jwt_access=False) + use_jwt.assert_not_called() + + +@pytest.mark.parametrize("client_class", [ServiceAttachmentsClient,]) +def test_service_attachments_client_from_service_account_file(client_class): + creds = ga_credentials.AnonymousCredentials() + with mock.patch.object( + service_account.Credentials, "from_service_account_file" + ) as factory: + factory.return_value = creds + client = client_class.from_service_account_file("dummy/file/path.json") + assert client.transport._credentials == creds + assert isinstance(client, client_class) + + client = client_class.from_service_account_json("dummy/file/path.json") + assert client.transport._credentials == creds + assert isinstance(client, client_class) + + assert client.transport._host == "compute.googleapis.com:443" + + +def test_service_attachments_client_get_transport_class(): + transport = ServiceAttachmentsClient.get_transport_class() + available_transports = [ + transports.ServiceAttachmentsRestTransport, + ] + assert transport in available_transports + + transport = ServiceAttachmentsClient.get_transport_class("rest") + assert transport == transports.ServiceAttachmentsRestTransport + + +@pytest.mark.parametrize( + "client_class,transport_class,transport_name", + [(ServiceAttachmentsClient, transports.ServiceAttachmentsRestTransport, "rest"),], +) +@mock.patch.object( + ServiceAttachmentsClient, + "DEFAULT_ENDPOINT", + modify_default_endpoint(ServiceAttachmentsClient), +) +def test_service_attachments_client_client_options( + client_class, transport_class, transport_name +): + # Check that if channel is provided we won't create a new one. + with mock.patch.object(ServiceAttachmentsClient, "get_transport_class") as gtc: + transport = transport_class(credentials=ga_credentials.AnonymousCredentials()) + client = client_class(transport=transport) + gtc.assert_not_called() + + # Check that if channel is provided via str we will create a new one. + with mock.patch.object(ServiceAttachmentsClient, "get_transport_class") as gtc: + client = client_class(transport=transport_name) + gtc.assert_called() + + # Check the case api_endpoint is provided. + options = client_options.ClientOptions(api_endpoint="squid.clam.whelk") + with mock.patch.object(transport_class, "__init__") as patched: + patched.return_value = None + client = client_class(client_options=options) + patched.assert_called_once_with( + credentials=None, + credentials_file=None, + host="squid.clam.whelk", + scopes=None, + client_cert_source_for_mtls=None, + quota_project_id=None, + client_info=transports.base.DEFAULT_CLIENT_INFO, + ) + + # Check the case api_endpoint is not provided and GOOGLE_API_USE_MTLS_ENDPOINT is + # "never". + with mock.patch.dict(os.environ, {"GOOGLE_API_USE_MTLS_ENDPOINT": "never"}): + with mock.patch.object(transport_class, "__init__") as patched: + patched.return_value = None + client = client_class() + patched.assert_called_once_with( + credentials=None, + credentials_file=None, + host=client.DEFAULT_ENDPOINT, + scopes=None, + client_cert_source_for_mtls=None, + quota_project_id=None, + client_info=transports.base.DEFAULT_CLIENT_INFO, + ) + + # Check the case api_endpoint is not provided and GOOGLE_API_USE_MTLS_ENDPOINT is + # "always". + with mock.patch.dict(os.environ, {"GOOGLE_API_USE_MTLS_ENDPOINT": "always"}): + with mock.patch.object(transport_class, "__init__") as patched: + patched.return_value = None + client = client_class() + patched.assert_called_once_with( + credentials=None, + credentials_file=None, + host=client.DEFAULT_MTLS_ENDPOINT, + scopes=None, + client_cert_source_for_mtls=None, + quota_project_id=None, + client_info=transports.base.DEFAULT_CLIENT_INFO, + ) + + # Check the case api_endpoint is not provided and GOOGLE_API_USE_MTLS_ENDPOINT has + # unsupported value. + with mock.patch.dict(os.environ, {"GOOGLE_API_USE_MTLS_ENDPOINT": "Unsupported"}): + with pytest.raises(MutualTLSChannelError): + client = client_class() + + # Check the case GOOGLE_API_USE_CLIENT_CERTIFICATE has unsupported value. + with mock.patch.dict( + os.environ, {"GOOGLE_API_USE_CLIENT_CERTIFICATE": "Unsupported"} + ): + with pytest.raises(ValueError): + client = client_class() + + # Check the case quota_project_id is provided + options = client_options.ClientOptions(quota_project_id="octopus") + with mock.patch.object(transport_class, "__init__") as patched: + patched.return_value = None + client = client_class(client_options=options) + patched.assert_called_once_with( + credentials=None, + credentials_file=None, + host=client.DEFAULT_ENDPOINT, + scopes=None, + client_cert_source_for_mtls=None, + quota_project_id="octopus", + client_info=transports.base.DEFAULT_CLIENT_INFO, + ) + + +@pytest.mark.parametrize( + "client_class,transport_class,transport_name,use_client_cert_env", + [ + ( + ServiceAttachmentsClient, + transports.ServiceAttachmentsRestTransport, + "rest", + "true", + ), + ( + ServiceAttachmentsClient, + transports.ServiceAttachmentsRestTransport, + "rest", + "false", + ), + ], +) +@mock.patch.object( + ServiceAttachmentsClient, + "DEFAULT_ENDPOINT", + modify_default_endpoint(ServiceAttachmentsClient), +) +@mock.patch.dict(os.environ, {"GOOGLE_API_USE_MTLS_ENDPOINT": "auto"}) +def test_service_attachments_client_mtls_env_auto( + client_class, transport_class, transport_name, use_client_cert_env +): + # This tests the endpoint autoswitch behavior. Endpoint is autoswitched to the default + # mtls endpoint, if GOOGLE_API_USE_CLIENT_CERTIFICATE is "true" and client cert exists. + + # Check the case client_cert_source is provided. Whether client cert is used depends on + # GOOGLE_API_USE_CLIENT_CERTIFICATE value. + with mock.patch.dict( + os.environ, {"GOOGLE_API_USE_CLIENT_CERTIFICATE": use_client_cert_env} + ): + options = client_options.ClientOptions( + client_cert_source=client_cert_source_callback + ) + with mock.patch.object(transport_class, "__init__") as patched: + patched.return_value = None + client = client_class(client_options=options) + + if use_client_cert_env == "false": + expected_client_cert_source = None + expected_host = client.DEFAULT_ENDPOINT + else: + expected_client_cert_source = client_cert_source_callback + expected_host = client.DEFAULT_MTLS_ENDPOINT + + patched.assert_called_once_with( + credentials=None, + credentials_file=None, + host=expected_host, + scopes=None, + client_cert_source_for_mtls=expected_client_cert_source, + quota_project_id=None, + client_info=transports.base.DEFAULT_CLIENT_INFO, + ) + + # Check the case ADC client cert is provided. Whether client cert is used depends on + # GOOGLE_API_USE_CLIENT_CERTIFICATE value. + with mock.patch.dict( + os.environ, {"GOOGLE_API_USE_CLIENT_CERTIFICATE": use_client_cert_env} + ): + with mock.patch.object(transport_class, "__init__") as patched: + with mock.patch( + "google.auth.transport.mtls.has_default_client_cert_source", + return_value=True, + ): + with mock.patch( + "google.auth.transport.mtls.default_client_cert_source", + return_value=client_cert_source_callback, + ): + if use_client_cert_env == "false": + expected_host = client.DEFAULT_ENDPOINT + expected_client_cert_source = None + else: + expected_host = client.DEFAULT_MTLS_ENDPOINT + expected_client_cert_source = client_cert_source_callback + + patched.return_value = None + client = client_class() + patched.assert_called_once_with( + credentials=None, + credentials_file=None, + host=expected_host, + scopes=None, + client_cert_source_for_mtls=expected_client_cert_source, + quota_project_id=None, + client_info=transports.base.DEFAULT_CLIENT_INFO, + ) + + # Check the case client_cert_source and ADC client cert are not provided. + with mock.patch.dict( + os.environ, {"GOOGLE_API_USE_CLIENT_CERTIFICATE": use_client_cert_env} + ): + with mock.patch.object(transport_class, "__init__") as patched: + with mock.patch( + "google.auth.transport.mtls.has_default_client_cert_source", + return_value=False, + ): + patched.return_value = None + client = client_class() + patched.assert_called_once_with( + credentials=None, + credentials_file=None, + host=client.DEFAULT_ENDPOINT, + scopes=None, + client_cert_source_for_mtls=None, + quota_project_id=None, + client_info=transports.base.DEFAULT_CLIENT_INFO, + ) + + +@pytest.mark.parametrize( + "client_class,transport_class,transport_name", + [(ServiceAttachmentsClient, transports.ServiceAttachmentsRestTransport, "rest"),], +) +def test_service_attachments_client_client_options_scopes( + client_class, transport_class, transport_name +): + # Check the case scopes are provided. + options = client_options.ClientOptions(scopes=["1", "2"],) + with mock.patch.object(transport_class, "__init__") as patched: + patched.return_value = None + client = client_class(client_options=options) + patched.assert_called_once_with( + credentials=None, + credentials_file=None, + host=client.DEFAULT_ENDPOINT, + scopes=["1", "2"], + client_cert_source_for_mtls=None, + quota_project_id=None, + client_info=transports.base.DEFAULT_CLIENT_INFO, + ) + + +@pytest.mark.parametrize( + "client_class,transport_class,transport_name", + [(ServiceAttachmentsClient, transports.ServiceAttachmentsRestTransport, "rest"),], +) +def test_service_attachments_client_client_options_credentials_file( + client_class, transport_class, transport_name +): + # Check the case credentials file is provided. + options = client_options.ClientOptions(credentials_file="credentials.json") + with mock.patch.object(transport_class, "__init__") as patched: + patched.return_value = None + client = client_class(client_options=options) + patched.assert_called_once_with( + credentials=None, + credentials_file="credentials.json", + host=client.DEFAULT_ENDPOINT, + scopes=None, + client_cert_source_for_mtls=None, + quota_project_id=None, + client_info=transports.base.DEFAULT_CLIENT_INFO, + ) + + +def test_aggregated_list_rest( + transport: str = "rest", + request_type=compute.AggregatedListServiceAttachmentsRequest, +): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # Designate an appropriate value for the returned response. + return_value = compute.ServiceAttachmentAggregatedList( + id="id_value", + items={ + "key_value": compute.ServiceAttachmentsScopedList( + service_attachments=[ + compute.ServiceAttachment( + connected_endpoints=[ + compute.ServiceAttachmentConnectedEndpoint( + endpoint="endpoint_value" + ) + ] + ) + ] + ) + }, + kind="kind_value", + next_page_token="next_page_token_value", + self_link="self_link_value", + unreachables=["unreachables_value"], + warning=compute.Warning(code=compute.Warning.Code.CLEANUP_FAILED), + ) + + # Wrap the value into a proper Response obj + json_return_value = compute.ServiceAttachmentAggregatedList.to_json( + return_value + ) + response_value = Response() + response_value.status_code = 200 + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + response = client.aggregated_list(request) + + # Establish that the response is the type that we expect. + assert isinstance(response, pagers.AggregatedListPager) + assert response.id == "id_value" + assert response.items == { + "key_value": compute.ServiceAttachmentsScopedList( + service_attachments=[ + compute.ServiceAttachment( + connected_endpoints=[ + compute.ServiceAttachmentConnectedEndpoint( + endpoint="endpoint_value" + ) + ] + ) + ] + ) + } + assert response.kind == "kind_value" + assert response.next_page_token == "next_page_token_value" + assert response.self_link == "self_link_value" + assert response.unreachables == ["unreachables_value"] + assert response.warning == compute.Warning(code=compute.Warning.Code.CLEANUP_FAILED) + + +def test_aggregated_list_rest_from_dict(): + test_aggregated_list_rest(request_type=dict) + + +def test_aggregated_list_rest_flattened(): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # Designate an appropriate value for the returned response. + return_value = compute.ServiceAttachmentAggregatedList() + + # Wrap the value into a proper Response obj + json_return_value = compute.ServiceAttachmentAggregatedList.to_json( + return_value + ) + response_value = Response() + response_value.status_code = 200 + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + client.aggregated_list(project="project_value",) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(req.mock_calls) == 1 + _, http_call, http_params = req.mock_calls[0] + body = http_params.get("data") + params = http_params.get("params") + assert "project_value" in http_call[1] + str(body) + str(params) + + +def test_aggregated_list_rest_flattened_error(): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.aggregated_list( + compute.AggregatedListServiceAttachmentsRequest(), project="project_value", + ) + + +def test_aggregated_list_pager(): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # Set the response as a series of pages + response = ( + compute.ServiceAttachmentAggregatedList( + items={ + "a": compute.ServiceAttachmentsScopedList(), + "b": compute.ServiceAttachmentsScopedList(), + "c": compute.ServiceAttachmentsScopedList(), + }, + next_page_token="abc", + ), + compute.ServiceAttachmentAggregatedList(items={}, next_page_token="def",), + compute.ServiceAttachmentAggregatedList( + items={"g": compute.ServiceAttachmentsScopedList(),}, + next_page_token="ghi", + ), + compute.ServiceAttachmentAggregatedList( + items={ + "h": compute.ServiceAttachmentsScopedList(), + "i": compute.ServiceAttachmentsScopedList(), + }, + ), + ) + # Two responses for two calls + response = response + response + + # Wrap the values into proper Response objs + response = tuple( + compute.ServiceAttachmentAggregatedList.to_json(x) for x in response + ) + return_values = tuple(Response() for i in response) + for return_val, response_val in zip(return_values, response): + return_val._content = response_val.encode("UTF-8") + return_val.status_code = 200 + req.side_effect = return_values + + metadata = () + pager = client.aggregated_list(request={}) + + assert pager._metadata == metadata + + assert isinstance(pager.get("a"), compute.ServiceAttachmentsScopedList) + assert pager.get("h") is None + + results = list(pager) + assert len(results) == 6 + assert all(isinstance(i, tuple) for i in results) + for result in results: + assert isinstance(result, tuple) + assert tuple(type(t) for t in result) == ( + str, + compute.ServiceAttachmentsScopedList, + ) + + assert pager.get("a") is None + assert isinstance(pager.get("h"), compute.ServiceAttachmentsScopedList) + + pages = list(client.aggregated_list(request={}).pages) + for page_, token in zip(pages, ["abc", "def", "ghi", ""]): + assert page_.raw_page.next_page_token == token + + +def test_delete_rest( + transport: str = "rest", request_type=compute.DeleteServiceAttachmentRequest +): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # Designate an appropriate value for the returned response. + return_value = compute.Operation( + client_operation_id="client_operation_id_value", + creation_timestamp="creation_timestamp_value", + description="description_value", + end_time="end_time_value", + error=compute.Error(errors=[compute.Errors(code="code_value")]), + http_error_message="http_error_message_value", + http_error_status_code=2374, + id=205, + insert_time="insert_time_value", + kind="kind_value", + name="name_value", + operation_group_id="operation_group_id_value", + operation_type="operation_type_value", + progress=885, + region="region_value", + self_link="self_link_value", + start_time="start_time_value", + status=compute.Operation.Status.DONE, + status_message="status_message_value", + target_id=947, + target_link="target_link_value", + user="user_value", + warnings=[compute.Warnings(code=compute.Warnings.Code.CLEANUP_FAILED)], + zone="zone_value", + ) + + # Wrap the value into a proper Response obj + json_return_value = compute.Operation.to_json(return_value) + response_value = Response() + response_value.status_code = 200 + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + response = client.delete(request) + + # Establish that the response is the type that we expect. + assert isinstance(response, compute.Operation) + assert response.client_operation_id == "client_operation_id_value" + assert response.creation_timestamp == "creation_timestamp_value" + assert response.description == "description_value" + assert response.end_time == "end_time_value" + assert response.error == compute.Error(errors=[compute.Errors(code="code_value")]) + assert response.http_error_message == "http_error_message_value" + assert response.http_error_status_code == 2374 + assert response.id == 205 + assert response.insert_time == "insert_time_value" + assert response.kind == "kind_value" + assert response.name == "name_value" + assert response.operation_group_id == "operation_group_id_value" + assert response.operation_type == "operation_type_value" + assert response.progress == 885 + assert response.region == "region_value" + assert response.self_link == "self_link_value" + assert response.start_time == "start_time_value" + assert response.status == compute.Operation.Status.DONE + assert response.status_message == "status_message_value" + assert response.target_id == 947 + assert response.target_link == "target_link_value" + assert response.user == "user_value" + assert response.warnings == [ + compute.Warnings(code=compute.Warnings.Code.CLEANUP_FAILED) + ] + assert response.zone == "zone_value" + + +def test_delete_rest_from_dict(): + test_delete_rest(request_type=dict) + + +def test_delete_rest_flattened(): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # Designate an appropriate value for the returned response. + return_value = compute.Operation() + + # Wrap the value into a proper Response obj + json_return_value = compute.Operation.to_json(return_value) + response_value = Response() + response_value.status_code = 200 + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + client.delete( + project="project_value", + region="region_value", + service_attachment="service_attachment_value", + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(req.mock_calls) == 1 + _, http_call, http_params = req.mock_calls[0] + body = http_params.get("data") + params = http_params.get("params") + assert "project_value" in http_call[1] + str(body) + str(params) + assert "region_value" in http_call[1] + str(body) + str(params) + assert "service_attachment_value" in http_call[1] + str(body) + str(params) + + +def test_delete_rest_flattened_error(): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.delete( + compute.DeleteServiceAttachmentRequest(), + project="project_value", + region="region_value", + service_attachment="service_attachment_value", + ) + + +def test_get_rest( + transport: str = "rest", request_type=compute.GetServiceAttachmentRequest +): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # Designate an appropriate value for the returned response. + return_value = compute.ServiceAttachment( + connected_endpoints=[ + compute.ServiceAttachmentConnectedEndpoint(endpoint="endpoint_value") + ], + connection_preference=compute.ServiceAttachment.ConnectionPreference.ACCEPT_AUTOMATIC, + consumer_accept_lists=[ + compute.ServiceAttachmentConsumerProjectLimit(connection_limit=1710) + ], + consumer_reject_lists=["consumer_reject_lists_value"], + creation_timestamp="creation_timestamp_value", + description="description_value", + enable_proxy_protocol=True, + fingerprint="fingerprint_value", + id=205, + kind="kind_value", + name="name_value", + nat_subnets=["nat_subnets_value"], + producer_forwarding_rule="producer_forwarding_rule_value", + psc_service_attachment_id=compute.Uint128(high=416), + region="region_value", + self_link="self_link_value", + target_service="target_service_value", + ) + + # Wrap the value into a proper Response obj + json_return_value = compute.ServiceAttachment.to_json(return_value) + response_value = Response() + response_value.status_code = 200 + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + response = client.get(request) + + # Establish that the response is the type that we expect. + assert isinstance(response, compute.ServiceAttachment) + assert response.connected_endpoints == [ + compute.ServiceAttachmentConnectedEndpoint(endpoint="endpoint_value") + ] + assert ( + response.connection_preference + == compute.ServiceAttachment.ConnectionPreference.ACCEPT_AUTOMATIC + ) + assert response.consumer_accept_lists == [ + compute.ServiceAttachmentConsumerProjectLimit(connection_limit=1710) + ] + assert response.consumer_reject_lists == ["consumer_reject_lists_value"] + assert response.creation_timestamp == "creation_timestamp_value" + assert response.description == "description_value" + assert response.enable_proxy_protocol is True + assert response.fingerprint == "fingerprint_value" + assert response.id == 205 + assert response.kind == "kind_value" + assert response.name == "name_value" + assert response.nat_subnets == ["nat_subnets_value"] + assert response.producer_forwarding_rule == "producer_forwarding_rule_value" + assert response.psc_service_attachment_id == compute.Uint128(high=416) + assert response.region == "region_value" + assert response.self_link == "self_link_value" + assert response.target_service == "target_service_value" + + +def test_get_rest_from_dict(): + test_get_rest(request_type=dict) + + +def test_get_rest_flattened(): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # Designate an appropriate value for the returned response. + return_value = compute.ServiceAttachment() + + # Wrap the value into a proper Response obj + json_return_value = compute.ServiceAttachment.to_json(return_value) + response_value = Response() + response_value.status_code = 200 + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + client.get( + project="project_value", + region="region_value", + service_attachment="service_attachment_value", + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(req.mock_calls) == 1 + _, http_call, http_params = req.mock_calls[0] + body = http_params.get("data") + params = http_params.get("params") + assert "project_value" in http_call[1] + str(body) + str(params) + assert "region_value" in http_call[1] + str(body) + str(params) + assert "service_attachment_value" in http_call[1] + str(body) + str(params) + + +def test_get_rest_flattened_error(): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.get( + compute.GetServiceAttachmentRequest(), + project="project_value", + region="region_value", + service_attachment="service_attachment_value", + ) + + +def test_get_iam_policy_rest( + transport: str = "rest", request_type=compute.GetIamPolicyServiceAttachmentRequest +): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # Designate an appropriate value for the returned response. + return_value = compute.Policy( + audit_configs=[ + compute.AuditConfig( + audit_log_configs=[ + compute.AuditLogConfig( + exempted_members=["exempted_members_value"] + ) + ] + ) + ], + bindings=[compute.Binding(binding_id="binding_id_value")], + etag="etag_value", + iam_owned=True, + rules=[compute.Rule(action=compute.Rule.Action.ALLOW)], + version=774, + ) + + # Wrap the value into a proper Response obj + json_return_value = compute.Policy.to_json(return_value) + response_value = Response() + response_value.status_code = 200 + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + response = client.get_iam_policy(request) + + # Establish that the response is the type that we expect. + assert isinstance(response, compute.Policy) + assert response.audit_configs == [ + compute.AuditConfig( + audit_log_configs=[ + compute.AuditLogConfig(exempted_members=["exempted_members_value"]) + ] + ) + ] + assert response.bindings == [compute.Binding(binding_id="binding_id_value")] + assert response.etag == "etag_value" + assert response.iam_owned is True + assert response.rules == [compute.Rule(action=compute.Rule.Action.ALLOW)] + assert response.version == 774 + + +def test_get_iam_policy_rest_from_dict(): + test_get_iam_policy_rest(request_type=dict) + + +def test_get_iam_policy_rest_flattened(): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # Designate an appropriate value for the returned response. + return_value = compute.Policy() + + # Wrap the value into a proper Response obj + json_return_value = compute.Policy.to_json(return_value) + response_value = Response() + response_value.status_code = 200 + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + client.get_iam_policy( + project="project_value", region="region_value", resource="resource_value", + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(req.mock_calls) == 1 + _, http_call, http_params = req.mock_calls[0] + body = http_params.get("data") + params = http_params.get("params") + assert "project_value" in http_call[1] + str(body) + str(params) + assert "region_value" in http_call[1] + str(body) + str(params) + assert "resource_value" in http_call[1] + str(body) + str(params) + + +def test_get_iam_policy_rest_flattened_error(): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.get_iam_policy( + compute.GetIamPolicyServiceAttachmentRequest(), + project="project_value", + region="region_value", + resource="resource_value", + ) + + +def test_insert_rest( + transport: str = "rest", request_type=compute.InsertServiceAttachmentRequest +): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # Designate an appropriate value for the returned response. + return_value = compute.Operation( + client_operation_id="client_operation_id_value", + creation_timestamp="creation_timestamp_value", + description="description_value", + end_time="end_time_value", + error=compute.Error(errors=[compute.Errors(code="code_value")]), + http_error_message="http_error_message_value", + http_error_status_code=2374, + id=205, + insert_time="insert_time_value", + kind="kind_value", + name="name_value", + operation_group_id="operation_group_id_value", + operation_type="operation_type_value", + progress=885, + region="region_value", + self_link="self_link_value", + start_time="start_time_value", + status=compute.Operation.Status.DONE, + status_message="status_message_value", + target_id=947, + target_link="target_link_value", + user="user_value", + warnings=[compute.Warnings(code=compute.Warnings.Code.CLEANUP_FAILED)], + zone="zone_value", + ) + + # Wrap the value into a proper Response obj + json_return_value = compute.Operation.to_json(return_value) + response_value = Response() + response_value.status_code = 200 + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + response = client.insert(request) + + # Establish that the response is the type that we expect. + assert isinstance(response, compute.Operation) + assert response.client_operation_id == "client_operation_id_value" + assert response.creation_timestamp == "creation_timestamp_value" + assert response.description == "description_value" + assert response.end_time == "end_time_value" + assert response.error == compute.Error(errors=[compute.Errors(code="code_value")]) + assert response.http_error_message == "http_error_message_value" + assert response.http_error_status_code == 2374 + assert response.id == 205 + assert response.insert_time == "insert_time_value" + assert response.kind == "kind_value" + assert response.name == "name_value" + assert response.operation_group_id == "operation_group_id_value" + assert response.operation_type == "operation_type_value" + assert response.progress == 885 + assert response.region == "region_value" + assert response.self_link == "self_link_value" + assert response.start_time == "start_time_value" + assert response.status == compute.Operation.Status.DONE + assert response.status_message == "status_message_value" + assert response.target_id == 947 + assert response.target_link == "target_link_value" + assert response.user == "user_value" + assert response.warnings == [ + compute.Warnings(code=compute.Warnings.Code.CLEANUP_FAILED) + ] + assert response.zone == "zone_value" + + +def test_insert_rest_from_dict(): + test_insert_rest(request_type=dict) + + +def test_insert_rest_flattened(): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # Designate an appropriate value for the returned response. + return_value = compute.Operation() + + # Wrap the value into a proper Response obj + json_return_value = compute.Operation.to_json(return_value) + response_value = Response() + response_value.status_code = 200 + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + service_attachment_resource = compute.ServiceAttachment( + connected_endpoints=[ + compute.ServiceAttachmentConnectedEndpoint(endpoint="endpoint_value") + ] + ) + client.insert( + project="project_value", + region="region_value", + service_attachment_resource=service_attachment_resource, + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(req.mock_calls) == 1 + _, http_call, http_params = req.mock_calls[0] + body = http_params.get("data") + params = http_params.get("params") + assert "project_value" in http_call[1] + str(body) + str(params) + assert "region_value" in http_call[1] + str(body) + str(params) + assert compute.ServiceAttachment.to_json( + service_attachment_resource, + including_default_value_fields=False, + use_integers_for_enums=False, + ) in http_call[1] + str(body) + str(params) + + +def test_insert_rest_flattened_error(): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.insert( + compute.InsertServiceAttachmentRequest(), + project="project_value", + region="region_value", + service_attachment_resource=compute.ServiceAttachment( + connected_endpoints=[ + compute.ServiceAttachmentConnectedEndpoint( + endpoint="endpoint_value" + ) + ] + ), + ) + + +def test_list_rest( + transport: str = "rest", request_type=compute.ListServiceAttachmentsRequest +): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # Designate an appropriate value for the returned response. + return_value = compute.ServiceAttachmentList( + id="id_value", + items=[ + compute.ServiceAttachment( + connected_endpoints=[ + compute.ServiceAttachmentConnectedEndpoint( + endpoint="endpoint_value" + ) + ] + ) + ], + kind="kind_value", + next_page_token="next_page_token_value", + self_link="self_link_value", + warning=compute.Warning(code=compute.Warning.Code.CLEANUP_FAILED), + ) + + # Wrap the value into a proper Response obj + json_return_value = compute.ServiceAttachmentList.to_json(return_value) + response_value = Response() + response_value.status_code = 200 + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + response = client.list(request) + + # Establish that the response is the type that we expect. + assert isinstance(response, pagers.ListPager) + assert response.id == "id_value" + assert response.items == [ + compute.ServiceAttachment( + connected_endpoints=[ + compute.ServiceAttachmentConnectedEndpoint(endpoint="endpoint_value") + ] + ) + ] + assert response.kind == "kind_value" + assert response.next_page_token == "next_page_token_value" + assert response.self_link == "self_link_value" + assert response.warning == compute.Warning(code=compute.Warning.Code.CLEANUP_FAILED) + + +def test_list_rest_from_dict(): + test_list_rest(request_type=dict) + + +def test_list_rest_flattened(): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # Designate an appropriate value for the returned response. + return_value = compute.ServiceAttachmentList() + + # Wrap the value into a proper Response obj + json_return_value = compute.ServiceAttachmentList.to_json(return_value) + response_value = Response() + response_value.status_code = 200 + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + client.list( + project="project_value", region="region_value", + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(req.mock_calls) == 1 + _, http_call, http_params = req.mock_calls[0] + body = http_params.get("data") + params = http_params.get("params") + assert "project_value" in http_call[1] + str(body) + str(params) + assert "region_value" in http_call[1] + str(body) + str(params) + + +def test_list_rest_flattened_error(): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.list( + compute.ListServiceAttachmentsRequest(), + project="project_value", + region="region_value", + ) + + +def test_list_pager(): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # Set the response as a series of pages + response = ( + compute.ServiceAttachmentList( + items=[ + compute.ServiceAttachment(), + compute.ServiceAttachment(), + compute.ServiceAttachment(), + ], + next_page_token="abc", + ), + compute.ServiceAttachmentList(items=[], next_page_token="def",), + compute.ServiceAttachmentList( + items=[compute.ServiceAttachment(),], next_page_token="ghi", + ), + compute.ServiceAttachmentList( + items=[compute.ServiceAttachment(), compute.ServiceAttachment(),], + ), + ) + # Two responses for two calls + response = response + response + + # Wrap the values into proper Response objs + response = tuple(compute.ServiceAttachmentList.to_json(x) for x in response) + return_values = tuple(Response() for i in response) + for return_val, response_val in zip(return_values, response): + return_val._content = response_val.encode("UTF-8") + return_val.status_code = 200 + req.side_effect = return_values + + metadata = () + pager = client.list(request={}) + + assert pager._metadata == metadata + + results = list(pager) + assert len(results) == 6 + assert all(isinstance(i, compute.ServiceAttachment) for i in results) + + pages = list(client.list(request={}).pages) + for page_, token in zip(pages, ["abc", "def", "ghi", ""]): + assert page_.raw_page.next_page_token == token + + +def test_patch_rest( + transport: str = "rest", request_type=compute.PatchServiceAttachmentRequest +): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # Designate an appropriate value for the returned response. + return_value = compute.Operation( + client_operation_id="client_operation_id_value", + creation_timestamp="creation_timestamp_value", + description="description_value", + end_time="end_time_value", + error=compute.Error(errors=[compute.Errors(code="code_value")]), + http_error_message="http_error_message_value", + http_error_status_code=2374, + id=205, + insert_time="insert_time_value", + kind="kind_value", + name="name_value", + operation_group_id="operation_group_id_value", + operation_type="operation_type_value", + progress=885, + region="region_value", + self_link="self_link_value", + start_time="start_time_value", + status=compute.Operation.Status.DONE, + status_message="status_message_value", + target_id=947, + target_link="target_link_value", + user="user_value", + warnings=[compute.Warnings(code=compute.Warnings.Code.CLEANUP_FAILED)], + zone="zone_value", + ) + + # Wrap the value into a proper Response obj + json_return_value = compute.Operation.to_json(return_value) + response_value = Response() + response_value.status_code = 200 + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + response = client.patch(request) + + # Establish that the response is the type that we expect. + assert isinstance(response, compute.Operation) + assert response.client_operation_id == "client_operation_id_value" + assert response.creation_timestamp == "creation_timestamp_value" + assert response.description == "description_value" + assert response.end_time == "end_time_value" + assert response.error == compute.Error(errors=[compute.Errors(code="code_value")]) + assert response.http_error_message == "http_error_message_value" + assert response.http_error_status_code == 2374 + assert response.id == 205 + assert response.insert_time == "insert_time_value" + assert response.kind == "kind_value" + assert response.name == "name_value" + assert response.operation_group_id == "operation_group_id_value" + assert response.operation_type == "operation_type_value" + assert response.progress == 885 + assert response.region == "region_value" + assert response.self_link == "self_link_value" + assert response.start_time == "start_time_value" + assert response.status == compute.Operation.Status.DONE + assert response.status_message == "status_message_value" + assert response.target_id == 947 + assert response.target_link == "target_link_value" + assert response.user == "user_value" + assert response.warnings == [ + compute.Warnings(code=compute.Warnings.Code.CLEANUP_FAILED) + ] + assert response.zone == "zone_value" + + +def test_patch_rest_from_dict(): + test_patch_rest(request_type=dict) + + +def test_patch_rest_flattened(): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # Designate an appropriate value for the returned response. + return_value = compute.Operation() + + # Wrap the value into a proper Response obj + json_return_value = compute.Operation.to_json(return_value) + response_value = Response() + response_value.status_code = 200 + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + service_attachment_resource = compute.ServiceAttachment( + connected_endpoints=[ + compute.ServiceAttachmentConnectedEndpoint(endpoint="endpoint_value") + ] + ) + client.patch( + project="project_value", + region="region_value", + service_attachment="service_attachment_value", + service_attachment_resource=service_attachment_resource, + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(req.mock_calls) == 1 + _, http_call, http_params = req.mock_calls[0] + body = http_params.get("data") + params = http_params.get("params") + assert "project_value" in http_call[1] + str(body) + str(params) + assert "region_value" in http_call[1] + str(body) + str(params) + assert "service_attachment_value" in http_call[1] + str(body) + str(params) + assert compute.ServiceAttachment.to_json( + service_attachment_resource, + including_default_value_fields=False, + use_integers_for_enums=False, + ) in http_call[1] + str(body) + str(params) + + +def test_patch_rest_flattened_error(): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.patch( + compute.PatchServiceAttachmentRequest(), + project="project_value", + region="region_value", + service_attachment="service_attachment_value", + service_attachment_resource=compute.ServiceAttachment( + connected_endpoints=[ + compute.ServiceAttachmentConnectedEndpoint( + endpoint="endpoint_value" + ) + ] + ), + ) + + +def test_set_iam_policy_rest( + transport: str = "rest", request_type=compute.SetIamPolicyServiceAttachmentRequest +): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # Designate an appropriate value for the returned response. + return_value = compute.Policy( + audit_configs=[ + compute.AuditConfig( + audit_log_configs=[ + compute.AuditLogConfig( + exempted_members=["exempted_members_value"] + ) + ] + ) + ], + bindings=[compute.Binding(binding_id="binding_id_value")], + etag="etag_value", + iam_owned=True, + rules=[compute.Rule(action=compute.Rule.Action.ALLOW)], + version=774, + ) + + # Wrap the value into a proper Response obj + json_return_value = compute.Policy.to_json(return_value) + response_value = Response() + response_value.status_code = 200 + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + response = client.set_iam_policy(request) + + # Establish that the response is the type that we expect. + assert isinstance(response, compute.Policy) + assert response.audit_configs == [ + compute.AuditConfig( + audit_log_configs=[ + compute.AuditLogConfig(exempted_members=["exempted_members_value"]) + ] + ) + ] + assert response.bindings == [compute.Binding(binding_id="binding_id_value")] + assert response.etag == "etag_value" + assert response.iam_owned is True + assert response.rules == [compute.Rule(action=compute.Rule.Action.ALLOW)] + assert response.version == 774 + + +def test_set_iam_policy_rest_from_dict(): + test_set_iam_policy_rest(request_type=dict) + + +def test_set_iam_policy_rest_flattened(): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # Designate an appropriate value for the returned response. + return_value = compute.Policy() + + # Wrap the value into a proper Response obj + json_return_value = compute.Policy.to_json(return_value) + response_value = Response() + response_value.status_code = 200 + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + region_set_policy_request_resource = compute.RegionSetPolicyRequest( + bindings=[compute.Binding(binding_id="binding_id_value")] + ) + client.set_iam_policy( + project="project_value", + region="region_value", + resource="resource_value", + region_set_policy_request_resource=region_set_policy_request_resource, + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(req.mock_calls) == 1 + _, http_call, http_params = req.mock_calls[0] + body = http_params.get("data") + params = http_params.get("params") + assert "project_value" in http_call[1] + str(body) + str(params) + assert "region_value" in http_call[1] + str(body) + str(params) + assert "resource_value" in http_call[1] + str(body) + str(params) + assert compute.RegionSetPolicyRequest.to_json( + region_set_policy_request_resource, + including_default_value_fields=False, + use_integers_for_enums=False, + ) in http_call[1] + str(body) + str(params) + + +def test_set_iam_policy_rest_flattened_error(): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.set_iam_policy( + compute.SetIamPolicyServiceAttachmentRequest(), + project="project_value", + region="region_value", + resource="resource_value", + region_set_policy_request_resource=compute.RegionSetPolicyRequest( + bindings=[compute.Binding(binding_id="binding_id_value")] + ), + ) + + +def test_test_iam_permissions_rest( + transport: str = "rest", + request_type=compute.TestIamPermissionsServiceAttachmentRequest, +): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # Designate an appropriate value for the returned response. + return_value = compute.TestPermissionsResponse( + permissions=["permissions_value"], + ) + + # Wrap the value into a proper Response obj + json_return_value = compute.TestPermissionsResponse.to_json(return_value) + response_value = Response() + response_value.status_code = 200 + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + response = client.test_iam_permissions(request) + + # Establish that the response is the type that we expect. + assert isinstance(response, compute.TestPermissionsResponse) + assert response.permissions == ["permissions_value"] + + +def test_test_iam_permissions_rest_from_dict(): + test_test_iam_permissions_rest(request_type=dict) + + +def test_test_iam_permissions_rest_flattened(): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # Designate an appropriate value for the returned response. + return_value = compute.TestPermissionsResponse() + + # Wrap the value into a proper Response obj + json_return_value = compute.TestPermissionsResponse.to_json(return_value) + response_value = Response() + response_value.status_code = 200 + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + test_permissions_request_resource = compute.TestPermissionsRequest( + permissions=["permissions_value"] + ) + client.test_iam_permissions( + project="project_value", + region="region_value", + resource="resource_value", + test_permissions_request_resource=test_permissions_request_resource, + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(req.mock_calls) == 1 + _, http_call, http_params = req.mock_calls[0] + body = http_params.get("data") + params = http_params.get("params") + assert "project_value" in http_call[1] + str(body) + str(params) + assert "region_value" in http_call[1] + str(body) + str(params) + assert "resource_value" in http_call[1] + str(body) + str(params) + assert compute.TestPermissionsRequest.to_json( + test_permissions_request_resource, + including_default_value_fields=False, + use_integers_for_enums=False, + ) in http_call[1] + str(body) + str(params) + + +def test_test_iam_permissions_rest_flattened_error(): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.test_iam_permissions( + compute.TestIamPermissionsServiceAttachmentRequest(), + project="project_value", + region="region_value", + resource="resource_value", + test_permissions_request_resource=compute.TestPermissionsRequest( + permissions=["permissions_value"] + ), + ) + + +def test_credentials_transport_error(): + # It is an error to provide credentials and a transport instance. + transport = transports.ServiceAttachmentsRestTransport( + credentials=ga_credentials.AnonymousCredentials(), + ) + with pytest.raises(ValueError): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), transport=transport, + ) + + # It is an error to provide a credentials file and a transport instance. + transport = transports.ServiceAttachmentsRestTransport( + credentials=ga_credentials.AnonymousCredentials(), + ) + with pytest.raises(ValueError): + client = ServiceAttachmentsClient( + client_options={"credentials_file": "credentials.json"}, + transport=transport, + ) + + # It is an error to provide scopes and a transport instance. + transport = transports.ServiceAttachmentsRestTransport( + credentials=ga_credentials.AnonymousCredentials(), + ) + with pytest.raises(ValueError): + client = ServiceAttachmentsClient( + client_options={"scopes": ["1", "2"]}, transport=transport, + ) + + +def test_transport_instance(): + # A client may be instantiated with a custom transport instance. + transport = transports.ServiceAttachmentsRestTransport( + credentials=ga_credentials.AnonymousCredentials(), + ) + client = ServiceAttachmentsClient(transport=transport) + assert client.transport is transport + + +@pytest.mark.parametrize( + "transport_class", [transports.ServiceAttachmentsRestTransport,] +) +def test_transport_adc(transport_class): + # Test default credentials are used if not provided. + with mock.patch.object(google.auth, "default") as adc: + adc.return_value = (ga_credentials.AnonymousCredentials(), None) + transport_class() + adc.assert_called_once() + + +def test_service_attachments_base_transport_error(): + # Passing both a credentials object and credentials_file should raise an error + with pytest.raises(core_exceptions.DuplicateCredentialArgs): + transport = transports.ServiceAttachmentsTransport( + credentials=ga_credentials.AnonymousCredentials(), + credentials_file="credentials.json", + ) + + +def test_service_attachments_base_transport(): + # Instantiate the base transport. + with mock.patch( + "google.cloud.compute_v1.services.service_attachments.transports.ServiceAttachmentsTransport.__init__" + ) as Transport: + Transport.return_value = None + transport = transports.ServiceAttachmentsTransport( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Every method on the transport should just blindly + # raise NotImplementedError. + methods = ( + "aggregated_list", + "delete", + "get", + "get_iam_policy", + "insert", + "list", + "patch", + "set_iam_policy", + "test_iam_permissions", + ) + for method in methods: + with pytest.raises(NotImplementedError): + getattr(transport, method)(request=object()) + + +@requires_google_auth_gte_1_25_0 +def test_service_attachments_base_transport_with_credentials_file(): + # Instantiate the base transport with a credentials file + with mock.patch.object( + google.auth, "load_credentials_from_file", autospec=True + ) as load_creds, mock.patch( + "google.cloud.compute_v1.services.service_attachments.transports.ServiceAttachmentsTransport._prep_wrapped_messages" + ) as Transport: + Transport.return_value = None + load_creds.return_value = (ga_credentials.AnonymousCredentials(), None) + transport = transports.ServiceAttachmentsTransport( + credentials_file="credentials.json", quota_project_id="octopus", + ) + load_creds.assert_called_once_with( + "credentials.json", + scopes=None, + default_scopes=( + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/cloud-platform", + ), + quota_project_id="octopus", + ) + + +@requires_google_auth_lt_1_25_0 +def test_service_attachments_base_transport_with_credentials_file_old_google_auth(): + # Instantiate the base transport with a credentials file + with mock.patch.object( + google.auth, "load_credentials_from_file", autospec=True + ) as load_creds, mock.patch( + "google.cloud.compute_v1.services.service_attachments.transports.ServiceAttachmentsTransport._prep_wrapped_messages" + ) as Transport: + Transport.return_value = None + load_creds.return_value = (ga_credentials.AnonymousCredentials(), None) + transport = transports.ServiceAttachmentsTransport( + credentials_file="credentials.json", quota_project_id="octopus", + ) + load_creds.assert_called_once_with( + "credentials.json", + scopes=( + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/cloud-platform", + ), + quota_project_id="octopus", + ) + + +def test_service_attachments_base_transport_with_adc(): + # Test the default credentials are used if credentials and credentials_file are None. + with mock.patch.object(google.auth, "default", autospec=True) as adc, mock.patch( + "google.cloud.compute_v1.services.service_attachments.transports.ServiceAttachmentsTransport._prep_wrapped_messages" + ) as Transport: + Transport.return_value = None + adc.return_value = (ga_credentials.AnonymousCredentials(), None) + transport = transports.ServiceAttachmentsTransport() + adc.assert_called_once() + + +@requires_google_auth_gte_1_25_0 +def test_service_attachments_auth_adc(): + # If no credentials are provided, we should use ADC credentials. + with mock.patch.object(google.auth, "default", autospec=True) as adc: + adc.return_value = (ga_credentials.AnonymousCredentials(), None) + ServiceAttachmentsClient() + adc.assert_called_once_with( + scopes=None, + default_scopes=( + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/cloud-platform", + ), + quota_project_id=None, + ) + + +@requires_google_auth_lt_1_25_0 +def test_service_attachments_auth_adc_old_google_auth(): + # If no credentials are provided, we should use ADC credentials. + with mock.patch.object(google.auth, "default", autospec=True) as adc: + adc.return_value = (ga_credentials.AnonymousCredentials(), None) + ServiceAttachmentsClient() + adc.assert_called_once_with( + scopes=( + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/cloud-platform", + ), + quota_project_id=None, + ) + + +def test_service_attachments_http_transport_client_cert_source_for_mtls(): + cred = ga_credentials.AnonymousCredentials() + with mock.patch( + "google.auth.transport.requests.AuthorizedSession.configure_mtls_channel" + ) as mock_configure_mtls_channel: + transports.ServiceAttachmentsRestTransport( + credentials=cred, client_cert_source_for_mtls=client_cert_source_callback + ) + mock_configure_mtls_channel.assert_called_once_with(client_cert_source_callback) + + +def test_service_attachments_host_no_port(): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), + client_options=client_options.ClientOptions( + api_endpoint="compute.googleapis.com" + ), + ) + assert client.transport._host == "compute.googleapis.com:443" + + +def test_service_attachments_host_with_port(): + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), + client_options=client_options.ClientOptions( + api_endpoint="compute.googleapis.com:8000" + ), + ) + assert client.transport._host == "compute.googleapis.com:8000" + + +def test_common_billing_account_path(): + billing_account = "squid" + expected = "billingAccounts/{billing_account}".format( + billing_account=billing_account, + ) + actual = ServiceAttachmentsClient.common_billing_account_path(billing_account) + assert expected == actual + + +def test_parse_common_billing_account_path(): + expected = { + "billing_account": "clam", + } + path = ServiceAttachmentsClient.common_billing_account_path(**expected) + + # Check that the path construction is reversible. + actual = ServiceAttachmentsClient.parse_common_billing_account_path(path) + assert expected == actual + + +def test_common_folder_path(): + folder = "whelk" + expected = "folders/{folder}".format(folder=folder,) + actual = ServiceAttachmentsClient.common_folder_path(folder) + assert expected == actual + + +def test_parse_common_folder_path(): + expected = { + "folder": "octopus", + } + path = ServiceAttachmentsClient.common_folder_path(**expected) + + # Check that the path construction is reversible. + actual = ServiceAttachmentsClient.parse_common_folder_path(path) + assert expected == actual + + +def test_common_organization_path(): + organization = "oyster" + expected = "organizations/{organization}".format(organization=organization,) + actual = ServiceAttachmentsClient.common_organization_path(organization) + assert expected == actual + + +def test_parse_common_organization_path(): + expected = { + "organization": "nudibranch", + } + path = ServiceAttachmentsClient.common_organization_path(**expected) + + # Check that the path construction is reversible. + actual = ServiceAttachmentsClient.parse_common_organization_path(path) + assert expected == actual + + +def test_common_project_path(): + project = "cuttlefish" + expected = "projects/{project}".format(project=project,) + actual = ServiceAttachmentsClient.common_project_path(project) + assert expected == actual + + +def test_parse_common_project_path(): + expected = { + "project": "mussel", + } + path = ServiceAttachmentsClient.common_project_path(**expected) + + # Check that the path construction is reversible. + actual = ServiceAttachmentsClient.parse_common_project_path(path) + assert expected == actual + + +def test_common_location_path(): + project = "winkle" + location = "nautilus" + expected = "projects/{project}/locations/{location}".format( + project=project, location=location, + ) + actual = ServiceAttachmentsClient.common_location_path(project, location) + assert expected == actual + + +def test_parse_common_location_path(): + expected = { + "project": "scallop", + "location": "abalone", + } + path = ServiceAttachmentsClient.common_location_path(**expected) + + # Check that the path construction is reversible. + actual = ServiceAttachmentsClient.parse_common_location_path(path) + assert expected == actual + + +def test_client_withDEFAULT_CLIENT_INFO(): + client_info = gapic_v1.client_info.ClientInfo() + + with mock.patch.object( + transports.ServiceAttachmentsTransport, "_prep_wrapped_messages" + ) as prep: + client = ServiceAttachmentsClient( + credentials=ga_credentials.AnonymousCredentials(), client_info=client_info, + ) + prep.assert_called_once_with(client_info) + + with mock.patch.object( + transports.ServiceAttachmentsTransport, "_prep_wrapped_messages" + ) as prep: + transport_class = ServiceAttachmentsClient.get_transport_class() + transport = transport_class( + credentials=ga_credentials.AnonymousCredentials(), client_info=client_info, + ) + prep.assert_called_once_with(client_info) diff --git a/tests/unit/gapic/compute_v1/test_subnetworks.py b/tests/unit/gapic/compute_v1/test_subnetworks.py index cb7294140..a5c494835 100644 --- a/tests/unit/gapic/compute_v1/test_subnetworks.py +++ b/tests/unit/gapic/compute_v1/test_subnetworks.py @@ -861,10 +861,12 @@ def test_get_rest(transport: str = "rest", request_type=compute.GetSubnetworkReq creation_timestamp="creation_timestamp_value", description="description_value", enable_flow_logs=True, + external_ipv6_prefix="external_ipv6_prefix_value", fingerprint="fingerprint_value", gateway_address="gateway_address_value", id=205, ip_cidr_range="ip_cidr_range_value", + ipv6_access_type=compute.Subnetwork.Ipv6AccessType.EXTERNAL, ipv6_cidr_range="ipv6_cidr_range_value", kind="kind_value", log_config=compute.SubnetworkLogConfig( @@ -881,6 +883,7 @@ def test_get_rest(transport: str = "rest", request_type=compute.GetSubnetworkReq compute.SubnetworkSecondaryRange(ip_cidr_range="ip_cidr_range_value") ], self_link="self_link_value", + stack_type=compute.Subnetwork.StackType.IPV4_IPV6, state=compute.Subnetwork.State.DRAINING, ) @@ -897,10 +900,12 @@ def test_get_rest(transport: str = "rest", request_type=compute.GetSubnetworkReq assert response.creation_timestamp == "creation_timestamp_value" assert response.description == "description_value" assert response.enable_flow_logs is True + assert response.external_ipv6_prefix == "external_ipv6_prefix_value" assert response.fingerprint == "fingerprint_value" assert response.gateway_address == "gateway_address_value" assert response.id == 205 assert response.ip_cidr_range == "ip_cidr_range_value" + assert response.ipv6_access_type == compute.Subnetwork.Ipv6AccessType.EXTERNAL assert response.ipv6_cidr_range == "ipv6_cidr_range_value" assert response.kind == "kind_value" assert response.log_config == compute.SubnetworkLogConfig( @@ -920,6 +925,7 @@ def test_get_rest(transport: str = "rest", request_type=compute.GetSubnetworkReq compute.SubnetworkSecondaryRange(ip_cidr_range="ip_cidr_range_value") ] assert response.self_link == "self_link_value" + assert response.stack_type == compute.Subnetwork.StackType.IPV4_IPV6 assert response.state == compute.Subnetwork.State.DRAINING diff --git a/tests/unit/gapic/compute_v1/test_target_instances.py b/tests/unit/gapic/compute_v1/test_target_instances.py index 08451015d..4a0498ee5 100644 --- a/tests/unit/gapic/compute_v1/test_target_instances.py +++ b/tests/unit/gapic/compute_v1/test_target_instances.py @@ -745,6 +745,7 @@ def test_get_rest( kind="kind_value", name="name_value", nat_policy=compute.TargetInstance.NatPolicy.NO_NAT, + network="network_value", self_link="self_link_value", zone="zone_value", ) @@ -766,6 +767,7 @@ def test_get_rest( assert response.kind == "kind_value" assert response.name == "name_value" assert response.nat_policy == compute.TargetInstance.NatPolicy.NO_NAT + assert response.network == "network_value" assert response.self_link == "self_link_value" assert response.zone == "zone_value"