diff --git a/artifact-registry/Cargo.toml b/artifact-registry/Cargo.toml index c08ced2d..9bf215b1 100644 --- a/artifact-registry/Cargo.toml +++ b/artifact-registry/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "gcloud-artifact-registry" -version = "1.2.0" +version = "1.2.1" edition = "2021" authors = ["yoshidan "] repository = "https://github.com/yoshidan/google-cloud-rust/tree/main/artifact-registry" @@ -16,7 +16,7 @@ doctest = false [dependencies] token-source = "1.0" google-cloud-auth = { package = "gcloud-auth", optional = true, version = "1.1.0", path="../foundation/auth", default-features=false } -google-cloud-googleapis = { package = "gcloud-googleapis", version="1.1.0", path = "../googleapis", features=["artifact-registry"]} +google-cloud-googleapis = { package = "gcloud-googleapis", version="1.2.0", path = "../googleapis", features=["artifact-registry"]} google-cloud-gax = { package = "gcloud-gax", version = "1.2.0", path = "../foundation/gax"} google-cloud-longrunning = { package = "gcloud-longrunning", version = "1.2.0", path = "../foundation/longrunning" } tracing = "0.1" diff --git a/bigquery/Cargo.toml b/bigquery/Cargo.toml index cdc6d99f..47fdc31f 100644 --- a/bigquery/Cargo.toml +++ b/bigquery/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "gcloud-bigquery" -version = "1.2.0" +version = "1.3.0" edition = "2021" authors = ["yoshidan "] repository = "https://github.com/yoshidan/google-cloud-rust/tree/main/bigquery" @@ -16,7 +16,7 @@ doctest = false [dependencies] async-trait = "0.1" token-source = "1.0" -google-cloud-googleapis = { package = "gcloud-googleapis", version="1.1.0", path = "../googleapis", features=["bigquery"]} +google-cloud-googleapis = { package = "gcloud-googleapis", version="1.2.0", path = "../googleapis", features=["bigquery"]} google-cloud-gax = { package = "gcloud-gax", version = "1.2.0", path = "../foundation/gax"} thiserror = "1.0" tracing = "0.1" diff --git a/foundation/longrunning/Cargo.toml b/foundation/longrunning/Cargo.toml index c74ac792..f27207bb 100644 --- a/foundation/longrunning/Cargo.toml +++ b/foundation/longrunning/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "gcloud-longrunning" -version = "1.2.0" +version = "1.2.1" authors = ["yoshidan "] edition = "2021" repository = "https://github.com/yoshidan/google-cloud-rust/tree/main/foundation/longrunning" @@ -13,7 +13,7 @@ description = "Google Cloud Platform longrunning library." doctest = false [dependencies] -google-cloud-googleapis = { package = "gcloud-googleapis", version = "1.1.0", path = "../../googleapis" } +google-cloud-googleapis = { package = "gcloud-googleapis", version = "1.2.0", path = "../../googleapis" } google-cloud-gax = { package = "gcloud-gax", version = "1.2.0", path = "../gax" } tonic = { version = "0.13", default-features = false } prost = "0.13" diff --git a/googleapis/Cargo.toml b/googleapis/Cargo.toml index 72f341e3..ed5f74f5 100644 --- a/googleapis/Cargo.toml +++ b/googleapis/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "gcloud-googleapis" -version = "1.1.0" +version = "1.2.0" authors = ["yoshidan "] edition = "2021" repository = "https://github.com/yoshidan/google-cloud-rust/tree/main/googleapis" diff --git a/googleapis/googleapis b/googleapis/googleapis index 453b0cc0..da24f941 160000 --- a/googleapis/googleapis +++ b/googleapis/googleapis @@ -1 +1 @@ -Subproject commit 453b0cc093f83796765503ead7ec9f5f8196125f +Subproject commit da24f941319741abf7a9f6fc8451b636bcb61a20 diff --git a/googleapis/src/bytes/google.cloud.kms.v1.rs b/googleapis/src/bytes/google.cloud.kms.v1.rs index 5d8e08c1..457bbdde 100644 --- a/googleapis/src/bytes/google.cloud.kms.v1.rs +++ b/googleapis/src/bytes/google.cloud.kms.v1.rs @@ -478,6 +478,7 @@ pub mod crypto_key_version { /// The suffix following `HMAC_` corresponds to the hash algorithm being used /// (eg. SHA256). /// + /// Algorithms beginning with `PQ_` are post-quantum. /// /// For more information, see \[Key purposes and algorithms\] /// (). @@ -704,7 +705,7 @@ pub mod crypto_key_version { /// [ENABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.ENABLED] /// state. Disabled = 2, - /// This version is destroyed, and the key material is no longer stored. + /// The key material of this version is destroyed and no longer stored. /// This version may only become /// [ENABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.ENABLED] /// again if this version is @@ -1567,6 +1568,10 @@ pub struct ListKeyRingsResponse { pub next_page_token: ::prost::alloc::string::String, /// The total number of [KeyRings][google.cloud.kms.v1.KeyRing] that matched /// the query. + /// + /// This field is not populated if + /// [ListKeyRingsRequest.filter][google.cloud.kms.v1.ListKeyRingsRequest.filter] + /// is applied. #[prost(int32, tag = "3")] pub total_size: i32, } @@ -1584,6 +1589,10 @@ pub struct ListCryptoKeysResponse { pub next_page_token: ::prost::alloc::string::String, /// The total number of [CryptoKeys][google.cloud.kms.v1.CryptoKey] that /// matched the query. + /// + /// This field is not populated if + /// [ListCryptoKeysRequest.filter][google.cloud.kms.v1.ListCryptoKeysRequest.filter] + /// is applied. #[prost(int32, tag = "3")] pub total_size: i32, } @@ -1602,6 +1611,10 @@ pub struct ListCryptoKeyVersionsResponse { /// The total number of /// [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion] that matched the /// query. + /// + /// This field is not populated if + /// [ListCryptoKeyVersionsRequest.filter][google.cloud.kms.v1.ListCryptoKeyVersionsRequest.filter] + /// is applied. #[prost(int32, tag = "3")] pub total_size: i32, } @@ -1619,6 +1632,10 @@ pub struct ListImportJobsResponse { pub next_page_token: ::prost::alloc::string::String, /// The total number of [ImportJobs][google.cloud.kms.v1.ImportJob] that /// matched the query. + /// + /// This field is not populated if + /// [ListImportJobsRequest.filter][google.cloud.kms.v1.ListImportJobsRequest.filter] + /// is applied. #[prost(int32, tag = "3")] pub total_size: i32, } @@ -4076,6 +4093,10 @@ pub struct ListEkmConnectionsResponse { pub next_page_token: ::prost::alloc::string::String, /// The total number of [EkmConnections][google.cloud.kms.v1.EkmConnection] /// that matched the query. + /// + /// This field is not populated if + /// [ListEkmConnectionsRequest.filter][google.cloud.kms.v1.ListEkmConnectionsRequest.filter] + /// is applied. #[prost(int32, tag = "3")] pub total_size: i32, } diff --git a/googleapis/src/bytes/google.pubsub.v1.rs b/googleapis/src/bytes/google.pubsub.v1.rs index ec3c9b5d..4d666d8b 100644 --- a/googleapis/src/bytes/google.pubsub.v1.rs +++ b/googleapis/src/bytes/google.pubsub.v1.rs @@ -1153,7 +1153,7 @@ pub struct IngestionFailureEvent { /// Required. Error details explaining why ingestion to Pub/Sub has failed. #[prost(string, tag = "2")] pub error_message: ::prost::alloc::string::String, - #[prost(oneof = "ingestion_failure_event::Failure", tags = "3, 4, 5, 6")] + #[prost(oneof = "ingestion_failure_event::Failure", tags = "3, 4, 5, 6, 7")] pub failure: ::core::option::Option, } /// Nested message and enum types in `IngestionFailureEvent`. @@ -1172,6 +1172,10 @@ pub mod ingestion_failure_event { /// occurs, one or more Avro objects won't be ingested. #[derive(Clone, Copy, PartialEq, ::prost::Message)] pub struct AvroFailureReason {} + /// Set when a Pub/Sub message fails to get published due to a schema + /// validation violation. + #[derive(Clone, Copy, PartialEq, ::prost::Message)] + pub struct SchemaViolationReason {} /// Failure when ingesting from a Cloud Storage source. #[derive(Clone, PartialEq, ::prost::Message)] pub struct CloudStorageFailure { @@ -1187,7 +1191,7 @@ pub mod ingestion_failure_event { #[prost(int64, tag = "3")] pub object_generation: i64, /// Reason why ingestion failed for the specified object. - #[prost(oneof = "cloud_storage_failure::Reason", tags = "5, 6")] + #[prost(oneof = "cloud_storage_failure::Reason", tags = "5, 6, 7")] pub reason: ::core::option::Option, } /// Nested message and enum types in `CloudStorageFailure`. @@ -1202,6 +1206,9 @@ pub mod ingestion_failure_event { /// being published. #[prost(message, tag = "6")] ApiViolationReason(super::ApiViolationReason), + /// Optional. The Pub/Sub message failed schema validation. + #[prost(message, tag = "7")] + SchemaViolationReason(super::SchemaViolationReason), } } /// Failure when ingesting from an Amazon MSK source. @@ -1221,7 +1228,7 @@ pub mod ingestion_failure_event { #[prost(int64, tag = "4")] pub offset: i64, /// Reason why ingestion failed for the specified message. - #[prost(oneof = "aws_msk_failure_reason::Reason", tags = "5")] + #[prost(oneof = "aws_msk_failure_reason::Reason", tags = "5, 6")] pub reason: ::core::option::Option, } /// Nested message and enum types in `AwsMskFailureReason`. @@ -1233,6 +1240,9 @@ pub mod ingestion_failure_event { /// being published. #[prost(message, tag = "5")] ApiViolationReason(super::ApiViolationReason), + /// Optional. The Pub/Sub message failed schema validation. + #[prost(message, tag = "6")] + SchemaViolationReason(super::SchemaViolationReason), } } /// Failure when ingesting from an Azure Event Hubs source. @@ -1252,7 +1262,7 @@ pub mod ingestion_failure_event { #[prost(int64, tag = "4")] pub offset: i64, /// Reason why ingestion failed for the specified message. - #[prost(oneof = "azure_event_hubs_failure_reason::Reason", tags = "5")] + #[prost(oneof = "azure_event_hubs_failure_reason::Reason", tags = "5, 6")] pub reason: ::core::option::Option, } /// Nested message and enum types in `AzureEventHubsFailureReason`. @@ -1264,6 +1274,9 @@ pub mod ingestion_failure_event { /// being published. #[prost(message, tag = "5")] ApiViolationReason(super::ApiViolationReason), + /// Optional. The Pub/Sub message failed schema validation. + #[prost(message, tag = "6")] + SchemaViolationReason(super::SchemaViolationReason), } } /// Failure when ingesting from a Confluent Cloud source. @@ -1283,7 +1296,7 @@ pub mod ingestion_failure_event { #[prost(int64, tag = "4")] pub offset: i64, /// Reason why ingestion failed for the specified message. - #[prost(oneof = "confluent_cloud_failure_reason::Reason", tags = "5")] + #[prost(oneof = "confluent_cloud_failure_reason::Reason", tags = "5, 6")] pub reason: ::core::option::Option, } /// Nested message and enum types in `ConfluentCloudFailureReason`. @@ -1295,6 +1308,35 @@ pub mod ingestion_failure_event { /// being published. #[prost(message, tag = "5")] ApiViolationReason(super::ApiViolationReason), + /// Optional. The Pub/Sub message failed schema validation. + #[prost(message, tag = "6")] + SchemaViolationReason(super::SchemaViolationReason), + } + } + /// Failure when ingesting from an AWS Kinesis source. + #[derive(Clone, PartialEq, ::prost::Message)] + pub struct AwsKinesisFailureReason { + /// Optional. The stream ARN of the Kinesis stream being ingested from. + #[prost(string, tag = "1")] + pub stream_arn: ::prost::alloc::string::String, + /// Optional. The partition key of the message that failed to be ingested. + #[prost(string, tag = "2")] + pub partition_key: ::prost::alloc::string::String, + /// Optional. The sequence number of the message that failed to be ingested. + #[prost(string, tag = "3")] + pub sequence_number: ::prost::alloc::string::String, + /// Reason why ingestion failed for the specified message. + #[prost(oneof = "aws_kinesis_failure_reason::Reason", tags = "4")] + pub reason: ::core::option::Option, + } + /// Nested message and enum types in `AwsKinesisFailureReason`. + pub mod aws_kinesis_failure_reason { + /// Reason why ingestion failed for the specified message. + #[derive(Clone, Copy, PartialEq, ::prost::Oneof)] + pub enum Reason { + /// Optional. The Pub/Sub message failed schema validation. + #[prost(message, tag = "4")] + SchemaViolationReason(super::SchemaViolationReason), } } #[derive(Clone, PartialEq, ::prost::Oneof)] @@ -1311,6 +1353,9 @@ pub mod ingestion_failure_event { /// Optional. Failure when ingesting from Confluent Cloud. #[prost(message, tag = "6")] ConfluentCloudFailure(ConfluentCloudFailureReason), + /// Optional. Failure when ingesting from AWS Kinesis. + #[prost(message, tag = "7")] + AwsKinesisFailure(AwsKinesisFailureReason), } } /// User-defined JavaScript function that can transform or filter a Pub/Sub @@ -1769,8 +1814,8 @@ pub struct Subscription { /// /// If not set, the default retry policy is applied. This generally implies /// that messages will be retried as soon as possible for healthy subscribers. - /// RetryPolicy will be triggered on NACKs or acknowledgement deadline - /// exceeded events for a given message. + /// RetryPolicy will be triggered on NACKs or acknowledgment deadline exceeded + /// events for a given message. #[prost(message, optional, tag = "14")] pub retry_policy: ::core::option::Option, /// Optional. Indicates whether the subscription is detached from its topic. @@ -1785,7 +1830,7 @@ pub struct Subscription { /// subscription: /// /// * The message sent to a subscriber is guaranteed not to be resent - /// before the message's acknowledgement deadline expires. + /// before the message's acknowledgment deadline expires. /// * An acknowledged message will not be resent to a subscriber. /// /// Note that subscribers may still receive multiple copies of a message @@ -1873,7 +1918,7 @@ pub mod subscription { /// Retry delay will be exponential based on provided minimum and maximum /// backoffs. /// -/// RetryPolicy will be triggered on NACKs or acknowledgement deadline exceeded +/// RetryPolicy will be triggered on NACKs or acknowledgment deadline exceeded /// events for a given message. /// /// Retry Policy is implemented on a best effort basis. At times, the delay @@ -1913,7 +1958,7 @@ pub struct DeadLetterPolicy { /// value must be between 5 and 100. /// /// The number of delivery attempts is defined as 1 + (the sum of number of - /// NACKs and number of times the acknowledgement deadline has been exceeded + /// NACKs and number of times the acknowledgment deadline has been exceeded /// for the message). /// /// A NACK is any call to ModifyAckDeadline with a 0 deadline. Note that @@ -2168,7 +2213,7 @@ pub struct CloudStorageConfig { pub filename_datetime_format: ::prost::alloc::string::String, /// Optional. The maximum duration that can elapse before a new Cloud Storage /// file is created. Min 1 minute, max 10 minutes, default 5 minutes. May not - /// exceed the subscription's acknowledgement deadline. + /// exceed the subscription's acknowledgment deadline. #[prost(message, optional, tag = "6")] pub max_duration: ::core::option::Option<::prost_types::Duration>, /// Optional. The maximum bytes that can be written to a Cloud Storage file @@ -2450,7 +2495,7 @@ pub struct AcknowledgeRequest { pub ack_ids: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, } /// Request for the `StreamingPull` streaming RPC method. This request is used to -/// establish the initial stream as well as to stream acknowledgements and ack +/// establish the initial stream as well as to stream acknowledgments and ack /// deadline modifications from the client to the server. #[derive(Clone, PartialEq, ::prost::Message)] pub struct StreamingPullRequest { @@ -2460,12 +2505,11 @@ pub struct StreamingPullRequest { /// Format is `projects/{project}/subscriptions/{sub}`. #[prost(string, tag = "1")] pub subscription: ::prost::alloc::string::String, - /// Optional. List of acknowledgement IDs for acknowledging previously received + /// Optional. List of acknowledgment IDs for acknowledging previously received /// messages (received on this stream or a different stream). If an ack ID has /// expired, the corresponding message may be redelivered later. Acknowledging - /// a message more than once will not result in an error. If the - /// acknowledgement ID is malformed, the stream will be aborted with status - /// `INVALID_ARGUMENT`. + /// a message more than once will not result in an error. If the acknowledgment + /// ID is malformed, the stream will be aborted with status `INVALID_ARGUMENT`. #[prost(string, repeated, tag = "2")] pub ack_ids: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, /// Optional. The list of new ack deadlines for the IDs listed in @@ -2481,7 +2525,7 @@ pub struct StreamingPullRequest { /// be aborted with status `INVALID_ARGUMENT`. #[prost(int32, repeated, packed = "false", tag = "3")] pub modify_deadline_seconds: ::prost::alloc::vec::Vec, - /// Optional. List of acknowledgement IDs whose deadline will be modified based + /// Optional. List of acknowledgment IDs whose deadline will be modified based /// on the corresponding element in `modify_deadline_seconds`. This field can /// be used to indicate that more time is needed to process a message by the /// subscriber, or to make the message available for redelivery if the @@ -2547,37 +2591,37 @@ pub struct StreamingPullResponse { } /// Nested message and enum types in `StreamingPullResponse`. pub mod streaming_pull_response { - /// Acknowledgement IDs sent in one or more previous requests to acknowledge a + /// Acknowledgment IDs sent in one or more previous requests to acknowledge a /// previously received message. #[derive(Clone, PartialEq, ::prost::Message)] pub struct AcknowledgeConfirmation { - /// Optional. Successfully processed acknowledgement IDs. + /// Optional. Successfully processed acknowledgment IDs. #[prost(string, repeated, tag = "1")] pub ack_ids: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, - /// Optional. List of acknowledgement IDs that were malformed or whose - /// acknowledgement deadline has expired. + /// Optional. List of acknowledgment IDs that were malformed or whose + /// acknowledgment deadline has expired. #[prost(string, repeated, tag = "2")] pub invalid_ack_ids: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, - /// Optional. List of acknowledgement IDs that were out of order. + /// Optional. List of acknowledgment IDs that were out of order. #[prost(string, repeated, tag = "3")] pub unordered_ack_ids: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, - /// Optional. List of acknowledgement IDs that failed processing with + /// Optional. List of acknowledgment IDs that failed processing with /// temporary issues. #[prost(string, repeated, tag = "4")] pub temporary_failed_ack_ids: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, } - /// Acknowledgement IDs sent in one or more previous requests to modify the + /// Acknowledgment IDs sent in one or more previous requests to modify the /// deadline for a specific message. #[derive(Clone, PartialEq, ::prost::Message)] pub struct ModifyAckDeadlineConfirmation { - /// Optional. Successfully processed acknowledgement IDs. + /// Optional. Successfully processed acknowledgment IDs. #[prost(string, repeated, tag = "1")] pub ack_ids: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, - /// Optional. List of acknowledgement IDs that were malformed or whose - /// acknowledgement deadline has expired. + /// Optional. List of acknowledgment IDs that were malformed or whose + /// acknowledgment deadline has expired. #[prost(string, repeated, tag = "2")] pub invalid_ack_ids: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, - /// Optional. List of acknowledgement IDs that failed processing with + /// Optional. List of acknowledgment IDs that failed processing with /// temporary issues. #[prost(string, repeated, tag = "3")] pub temporary_failed_ack_ids: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, @@ -3233,7 +3277,7 @@ pub mod subscriber_client { self.inner.unary(req, path, codec).await } /// Establishes a stream with the server, which sends messages down to the - /// client. The client streams acknowledgements and ack deadline modifications + /// client. The client streams acknowledgments and ack deadline modifications /// back to the server. The server will close the stream and return the status /// on any error. The server may close the stream with status `UNAVAILABLE` to /// reassign server-side resources, in which case, the client should diff --git a/googleapis/src/bytes/google.spanner.admin.database.v1.rs b/googleapis/src/bytes/google.spanner.admin.database.v1.rs index 440ce6e1..222552f0 100644 --- a/googleapis/src/bytes/google.spanner.admin.database.v1.rs +++ b/googleapis/src/bytes/google.spanner.admin.database.v1.rs @@ -1449,6 +1449,11 @@ pub struct UpdateDatabaseDdlRequest { /// description](). #[prost(bytes = "bytes", tag = "4")] pub proto_descriptors: ::prost::bytes::Bytes, + /// Optional. This field is exposed to be used by the Spanner Migration Tool. + /// For more details, see + /// [SMT](). + #[prost(bool, tag = "5")] + pub throughput_mode: bool, } /// Action information extracted from a DDL statement. This proto is used to /// display the brief info of the DDL statement for the operation diff --git a/googleapis/src/bytes/google.storage.v2.rs b/googleapis/src/bytes/google.storage.v2.rs index b6dbfb4a..8cf4469a 100644 --- a/googleapis/src/bytes/google.storage.v2.rs +++ b/googleapis/src/bytes/google.storage.v2.rs @@ -36,10 +36,12 @@ pub struct GetBucketRequest { /// Request message for CreateBucket. #[derive(Clone, PartialEq, ::prost::Message)] pub struct CreateBucketRequest { - /// Required. The project to which this bucket will belong. + /// Required. The project to which this bucket will belong. This field must + /// either be empty or `projects/_`. The project ID that owns this bucket + /// should be specified in the `bucket.project` field. #[prost(string, tag = "1")] pub parent: ::prost::alloc::string::String, - /// Properties of the new bucket being inserted. + /// Optional. Properties of the new bucket being inserted. /// The name of the bucket is specified in the `bucket_id` field. Populating /// `bucket.name` field will result in an error. /// The project of the bucket must be specified in the `bucket.project` field. @@ -53,13 +55,13 @@ pub struct CreateBucketRequest { /// result in a bucket with the name `projects/123456/buckets/foo`. #[prost(string, tag = "3")] pub bucket_id: ::prost::alloc::string::String, - /// Apply a predefined set of access controls to this bucket. + /// Optional. Apply a predefined set of access controls to this bucket. /// Valid values are "authenticatedRead", "private", "projectPrivate", /// "publicRead", or "publicReadWrite". #[prost(string, tag = "6")] pub predefined_acl: ::prost::alloc::string::String, - /// Apply a predefined set of default object access controls to this bucket. - /// Valid values are "authenticatedRead", "bucketOwnerFullControl", + /// Optional. Apply a predefined set of default object access controls to this + /// bucket. Valid values are "authenticatedRead", "bucketOwnerFullControl", /// "bucketOwnerRead", "private", "projectPrivate", or "publicRead". #[prost(string, tag = "7")] pub predefined_default_object_acl: ::prost::alloc::string::String, @@ -70,17 +72,17 @@ pub struct ListBucketsRequest { /// Required. The project whose buckets we are listing. #[prost(string, tag = "1")] pub parent: ::prost::alloc::string::String, - /// Maximum number of buckets to return in a single response. The service will - /// use this parameter or 1,000 items, whichever is smaller. If "acl" is - /// present in the read_mask, the service will use this parameter of 200 items, - /// whichever is smaller. + /// Optional. Maximum number of buckets to return in a single response. The + /// service will use this parameter or 1,000 items, whichever is smaller. If + /// "acl" is present in the read_mask, the service will use this parameter of + /// 200 items, whichever is smaller. #[prost(int32, tag = "2")] pub page_size: i32, - /// A previously-returned page token representing part of the larger set of - /// results to view. + /// Optional. A previously-returned page token representing part of the larger + /// set of results to view. #[prost(string, tag = "3")] pub page_token: ::prost::alloc::string::String, - /// Filter results to buckets whose names begin with this prefix. + /// Optional. Filter results to buckets whose names begin with this prefix. #[prost(string, tag = "4")] pub prefix: ::prost::alloc::string::String, /// Mask specifying which fields to read from each result. @@ -127,13 +129,13 @@ pub struct UpdateBucketRequest { /// this value. #[prost(int64, optional, tag = "3")] pub if_metageneration_not_match: ::core::option::Option, - /// Apply a predefined set of access controls to this bucket. + /// Optional. Apply a predefined set of access controls to this bucket. /// Valid values are "authenticatedRead", "private", "projectPrivate", /// "publicRead", or "publicReadWrite". #[prost(string, tag = "8")] pub predefined_acl: ::prost::alloc::string::String, - /// Apply a predefined set of default object access controls to this bucket. - /// Valid values are "authenticatedRead", "bucketOwnerFullControl", + /// Optional. Apply a predefined set of default object access controls to this + /// bucket. Valid values are "authenticatedRead", "bucketOwnerFullControl", /// "bucketOwnerRead", "private", "projectPrivate", or "publicRead". #[prost(string, tag = "9")] pub predefined_default_object_acl: ::prost::alloc::string::String, @@ -154,11 +156,12 @@ pub struct ComposeObjectRequest { /// Required. Properties of the resulting object. #[prost(message, optional, tag = "1")] pub destination: ::core::option::Option, - /// The list of source objects that will be concatenated into a single object. + /// Optional. The list of source objects that will be concatenated into a + /// single object. #[prost(message, repeated, tag = "2")] pub source_objects: ::prost::alloc::vec::Vec, - /// Apply a predefined set of access controls to the destination object. - /// Valid values are "authenticatedRead", "bucketOwnerFullControl", + /// Optional. Apply a predefined set of access controls to the destination + /// object. Valid values are "authenticatedRead", "bucketOwnerFullControl", /// "bucketOwnerRead", "private", "projectPrivate", or "publicRead". #[prost(string, tag = "9")] pub destination_predefined_acl: ::prost::alloc::string::String, @@ -171,17 +174,18 @@ pub struct ComposeObjectRequest { /// metageneration matches the given value. #[prost(int64, optional, tag = "5")] pub if_metageneration_match: ::core::option::Option, - /// Resource name of the Cloud KMS key, of the form + /// Optional. Resource name of the Cloud KMS key, of the form /// `projects/my-project/locations/my-location/keyRings/my-kr/cryptoKeys/my-key`, /// that will be used to encrypt the object. Overrides the object /// metadata's `kms_key_name` value, if any. #[prost(string, tag = "6")] pub kms_key: ::prost::alloc::string::String, - /// A set of parameters common to Storage API requests concerning an object. + /// Optional. A set of parameters common to Storage API requests concerning an + /// object. #[prost(message, optional, tag = "7")] pub common_object_request_params: ::core::option::Option, - /// The checksums of the complete object. This will be validated against the - /// combined checksums of the component objects. + /// Optional. The checksums of the complete object. This will be validated + /// against the combined checksums of the component objects. #[prost(message, optional, tag = "10")] pub object_checksums: ::core::option::Option, } @@ -194,10 +198,10 @@ pub mod compose_object_request { /// same bucket. #[prost(string, tag = "1")] pub name: ::prost::alloc::string::String, - /// The generation of this object to use as the source. + /// Optional. The generation of this object to use as the source. #[prost(int64, tag = "2")] pub generation: i64, - /// Conditions that must be met for this operation to execute. + /// Optional. Conditions that must be met for this operation to execute. #[prost(message, optional, tag = "3")] pub object_preconditions: ::core::option::Option< source_object::ObjectPreconditions, @@ -228,8 +232,8 @@ pub struct DeleteObjectRequest { /// `CancelResumableWrite`. #[prost(string, tag = "2")] pub object: ::prost::alloc::string::String, - /// If present, permanently deletes a specific revision of this object (as - /// opposed to the latest version, the default). + /// Optional. If present, permanently deletes a specific revision of this + /// object (as opposed to the latest version, the default). #[prost(int64, tag = "4")] pub generation: i64, /// Makes the operation conditional on whether the object's current generation @@ -251,7 +255,8 @@ pub struct DeleteObjectRequest { /// metageneration does not match the given value. #[prost(int64, optional, tag = "8")] pub if_metageneration_not_match: ::core::option::Option, - /// A set of parameters common to Storage API requests concerning an object. + /// Optional. A set of parameters common to Storage API requests concerning an + /// object. #[prost(message, optional, tag = "10")] pub common_object_request_params: ::core::option::Option, } @@ -299,7 +304,8 @@ pub struct RestoreObjectRequest { /// Return an error if bucket has UBLA enabled. #[prost(bool, optional, tag = "9")] pub copy_source_acl: ::core::option::Option, - /// A set of parameters common to Storage API requests concerning an object. + /// Optional. A set of parameters common to Storage API requests concerning an + /// object. #[prost(message, optional, tag = "8")] pub common_object_request_params: ::core::option::Option, } @@ -325,12 +331,12 @@ pub struct ReadObjectRequest { /// Required. The name of the object to read. #[prost(string, tag = "2")] pub object: ::prost::alloc::string::String, - /// If present, selects a specific revision of this object (as opposed - /// to the latest version, the default). + /// Optional. If present, selects a specific revision of this object (as + /// opposed to the latest version, the default). #[prost(int64, tag = "3")] pub generation: i64, - /// The offset for the first byte to return in the read, relative to the start - /// of the object. + /// Optional. The offset for the first byte to return in the read, relative to + /// the start of the object. /// /// A negative `read_offset` value will be interpreted as the number of bytes /// back from the end of the object to be returned. For example, if an object's @@ -340,9 +346,10 @@ pub struct ReadObjectRequest { /// return the entire object. #[prost(int64, tag = "4")] pub read_offset: i64, - /// The maximum number of `data` bytes the server is allowed to return in the - /// sum of all `Object` messages. A `read_limit` of zero indicates that there - /// is no limit, and a negative `read_limit` will cause an error. + /// Optional. The maximum number of `data` bytes the server is allowed to + /// return in the sum of all `Object` messages. A `read_limit` of zero + /// indicates that there is no limit, and a negative `read_limit` will cause an + /// error. /// /// If the stream returns fewer bytes than allowed by the `read_limit` and no /// error occurred, the stream includes all data from the `read_offset` to the @@ -368,7 +375,8 @@ pub struct ReadObjectRequest { /// metageneration does not match the given value. #[prost(int64, optional, tag = "9")] pub if_metageneration_not_match: ::core::option::Option, - /// A set of parameters common to Storage API requests concerning an object. + /// Optional. A set of parameters common to Storage API requests concerning an + /// object. #[prost(message, optional, tag = "10")] pub common_object_request_params: ::core::option::Option, /// Mask specifying which fields to read. @@ -388,8 +396,8 @@ pub struct GetObjectRequest { /// Required. Name of the object. #[prost(string, tag = "2")] pub object: ::prost::alloc::string::String, - /// If present, selects a specific revision of this object (as opposed to the - /// latest version, the default). + /// Optional. If present, selects a specific revision of this object (as + /// opposed to the latest version, the default). #[prost(int64, tag = "3")] pub generation: i64, /// If true, return the soft-deleted version of this object. @@ -414,7 +422,8 @@ pub struct GetObjectRequest { /// metageneration does not match the given value. #[prost(int64, optional, tag = "7")] pub if_metageneration_not_match: ::core::option::Option, - /// A set of parameters common to Storage API requests concerning an object. + /// Optional. A set of parameters common to Storage API requests concerning an + /// object. #[prost(message, optional, tag = "8")] pub common_object_request_params: ::core::option::Option, /// Mask specifying which fields to read. @@ -464,8 +473,8 @@ pub struct BidiReadObjectSpec { /// Required. The name of the object to read. #[prost(string, tag = "2")] pub object: ::prost::alloc::string::String, - /// If present, selects a specific revision of this object (as opposed - /// to the latest version, the default). + /// Optional. If present, selects a specific revision of this object (as + /// opposed to the latest version, the default). #[prost(int64, tag = "3")] pub generation: i64, /// Makes the operation conditional on whether the object's current generation @@ -487,7 +496,8 @@ pub struct BidiReadObjectSpec { /// metageneration does not match the given value. #[prost(int64, optional, tag = "7")] pub if_metageneration_not_match: ::core::option::Option, - /// A set of parameters common to Storage API requests concerning an object. + /// Optional. A set of parameters common to Storage API requests concerning an + /// object. #[prost(message, optional, tag = "8")] pub common_object_request_params: ::core::option::Option, /// Mask specifying which fields to read. @@ -514,16 +524,17 @@ pub struct BidiReadObjectSpec { /// Request message for BidiReadObject. #[derive(Clone, PartialEq, ::prost::Message)] pub struct BidiReadObjectRequest { - /// The first message of each stream should set this field. If this is not - /// the first message, an error will be returned. Describes the object to read. + /// Optional. The first message of each stream should set this field. If this + /// is not the first message, an error will be returned. Describes the object + /// to read. #[prost(message, optional, tag = "1")] pub read_object_spec: ::core::option::Option, - /// Provides a list of 0 or more (up to 100) ranges to read. If a single range - /// is large enough to require multiple responses, they are guaranteed to be - /// delivered in increasing offset order. There are no ordering guarantees - /// across ranges. When no ranges are provided, the response message will not - /// include ObjectRangeData. For full object downloads, the offset and size can - /// be set to 0. + /// Optional. Provides a list of 0 or more (up to 100) ranges to read. If a + /// single range is large enough to require multiple responses, they are + /// guaranteed to be delivered in increasing offset order. There are no + /// ordering guarantees across ranges. When no ranges are provided, the + /// response message will not include ObjectRangeData. For full object + /// downloads, the offset and size can be set to 0. #[prost(message, repeated, tag = "8")] pub read_ranges: ::prost::alloc::vec::Vec, } @@ -669,7 +680,7 @@ pub struct WriteObjectSpec { /// Required. Destination object, including its name and its metadata. #[prost(message, optional, tag = "1")] pub resource: ::core::option::Option, - /// Apply a predefined set of access controls to this object. + /// Optional. Apply a predefined set of access controls to this object. /// Valid values are "authenticatedRead", "bucketOwnerFullControl", /// "bucketOwnerRead", "private", "projectPrivate", or "publicRead". #[prost(string, tag = "7")] @@ -725,13 +736,13 @@ pub struct WriteObjectRequest { /// An incorrect value will cause an error. #[prost(int64, tag = "3")] pub write_offset: i64, - /// Checksums for the complete object. If the checksums computed by the service - /// don't match the specified checksums the call will fail. May only be - /// provided in the first or last request (either with first_message, or - /// finish_write set). + /// Optional. Checksums for the complete object. If the checksums computed by + /// the service don't match the specified checksums the call will fail. May + /// only be provided in the first or last request (either with first_message, + /// or finish_write set). #[prost(message, optional, tag = "6")] pub object_checksums: ::core::option::Option, - /// If `true`, this indicates that the write is complete. Sending any + /// Optional. If `true`, this indicates that the write is complete. Sending any /// `WriteObjectRequest`s subsequent to one in which `finish_write` is `true` /// will cause an error. /// For a non-resumable write (where the upload_id was not set in the first @@ -739,7 +750,8 @@ pub struct WriteObjectRequest { /// stream. #[prost(bool, tag = "7")] pub finish_write: bool, - /// A set of parameters common to Storage API requests concerning an object. + /// Optional. A set of parameters common to Storage API requests concerning an + /// object. #[prost(message, optional, tag = "8")] pub common_object_request_params: ::core::option::Option, /// The first message of each stream should set one of the following. @@ -841,31 +853,31 @@ pub struct BidiWriteObjectRequest { /// An invalid value will cause an error. #[prost(int64, tag = "3")] pub write_offset: i64, - /// Checksums for the complete object. If the checksums computed by the service - /// don't match the specified checksums the call will fail. May only be - /// provided in the first request or the - /// last request (with finish_write set). + /// Optional. Checksums for the complete object. If the checksums computed by + /// the service don't match the specified checksums the call will fail. May + /// only be provided in the first request or the last request (with + /// finish_write set). #[prost(message, optional, tag = "6")] pub object_checksums: ::core::option::Option, - /// For each BidiWriteObjectRequest where state_lookup is `true` or the client - /// closes the stream, the service will send a BidiWriteObjectResponse - /// containing the current persisted size. The persisted size sent in responses - /// covers all the bytes the server has persisted thus far and can be used to - /// decide what data is safe for the client to drop. Note that the object's - /// current size reported by the BidiWriteObjectResponse may lag behind the - /// number of bytes written by the client. This field is ignored if - /// `finish_write` is set to true. + /// Optional. For each BidiWriteObjectRequest where state_lookup is `true` or + /// the client closes the stream, the service will send a + /// BidiWriteObjectResponse containing the current persisted size. The + /// persisted size sent in responses covers all the bytes the server has + /// persisted thus far and can be used to decide what data is safe for the + /// client to drop. Note that the object's current size reported by the + /// BidiWriteObjectResponse may lag behind the number of bytes written by the + /// client. This field is ignored if `finish_write` is set to true. #[prost(bool, tag = "7")] pub state_lookup: bool, - /// Persists data written on the stream, up to and including the current - /// message, to permanent storage. This option should be used sparingly as it - /// may reduce performance. Ongoing writes will periodically be persisted on - /// the server even when `flush` is not set. This field is ignored if + /// Optional. Persists data written on the stream, up to and including the + /// current message, to permanent storage. This option should be used sparingly + /// as it may reduce performance. Ongoing writes will periodically be persisted + /// on the server even when `flush` is not set. This field is ignored if /// `finish_write` is set to true since there's no need to checkpoint or flush /// if this message completes the write. #[prost(bool, tag = "8")] pub flush: bool, - /// If `true`, this indicates that the write is complete. Sending any + /// Optional. If `true`, this indicates that the write is complete. Sending any /// `WriteObjectRequest`s subsequent to one in which `finish_write` is `true` /// will cause an error. /// For a non-resumable write (where the upload_id was not set in the first @@ -873,7 +885,8 @@ pub struct BidiWriteObjectRequest { /// stream. #[prost(bool, tag = "9")] pub finish_write: bool, - /// A set of parameters common to Storage API requests concerning an object. + /// Optional. A set of parameters common to Storage API requests concerning an + /// object. #[prost(message, optional, tag = "10")] pub common_object_request_params: ::core::option::Option, /// The first message of each stream should set one of the following. @@ -942,33 +955,32 @@ pub struct ListObjectsRequest { /// Required. Name of the bucket in which to look for objects. #[prost(string, tag = "1")] pub parent: ::prost::alloc::string::String, - /// Maximum number of `items` plus `prefixes` to return + /// Optional. Maximum number of `items` plus `prefixes` to return /// in a single page of responses. As duplicate `prefixes` are /// omitted, fewer total results may be returned than requested. The service /// will use this parameter or 1,000 items, whichever is smaller. #[prost(int32, tag = "2")] pub page_size: i32, - /// A previously-returned page token representing part of the larger set of - /// results to view. + /// Optional. A previously-returned page token representing part of the larger + /// set of results to view. #[prost(string, tag = "3")] pub page_token: ::prost::alloc::string::String, - /// If set, returns results in a directory-like mode. `items` will contain - /// only objects whose names, aside from the `prefix`, do not - /// contain `delimiter`. Objects whose names, aside from the - /// `prefix`, contain `delimiter` will have their name, - /// truncated after the `delimiter`, returned in - /// `prefixes`. Duplicate `prefixes` are omitted. + /// Optional. If set, returns results in a directory-like mode. `items` will + /// contain only objects whose names, aside from the `prefix`, do not contain + /// `delimiter`. Objects whose names, aside from the `prefix`, contain + /// `delimiter` will have their name, truncated after the `delimiter`, returned + /// in `prefixes`. Duplicate `prefixes` are omitted. #[prost(string, tag = "4")] pub delimiter: ::prost::alloc::string::String, - /// If true, objects that end in exactly one instance of `delimiter` + /// Optional. If true, objects that end in exactly one instance of `delimiter` /// will have their metadata included in `items` in addition to /// `prefixes`. #[prost(bool, tag = "5")] pub include_trailing_delimiter: bool, - /// Filter results to objects whose names begin with this prefix. + /// Optional. Filter results to objects whose names begin with this prefix. #[prost(string, tag = "6")] pub prefix: ::prost::alloc::string::String, - /// If `true`, lists all versions of an object as distinct results. + /// Optional. If `true`, lists all versions of an object as distinct results. /// For more information, see /// [Object /// Versioning](). @@ -1014,7 +1026,8 @@ pub struct QueryWriteStatusRequest { /// being requested. #[prost(string, tag = "1")] pub upload_id: ::prost::alloc::string::String, - /// A set of parameters common to Storage API requests concerning an object. + /// Optional. A set of parameters common to Storage API requests concerning an + /// object. #[prost(message, optional, tag = "2")] pub common_object_request_params: ::core::option::Option, } @@ -1065,14 +1078,14 @@ pub struct RewriteObjectRequest { /// object. #[prost(string, tag = "25")] pub destination_bucket: ::prost::alloc::string::String, - /// The name of the Cloud KMS key that will be used to encrypt the destination - /// object. The Cloud KMS key must be located in same location as the object. - /// If the parameter is not specified, the request uses the destination - /// bucket's default encryption key, if any, or else the Google-managed - /// encryption key. + /// Optional. The name of the Cloud KMS key that will be used to encrypt the + /// destination object. The Cloud KMS key must be located in same location as + /// the object. If the parameter is not specified, the request uses the + /// destination bucket's default encryption key, if any, or else the + /// Google-managed encryption key. #[prost(string, tag = "27")] pub destination_kms_key: ::prost::alloc::string::String, - /// Properties of the destination, post-rewrite object. + /// Optional. Properties of the destination, post-rewrite object. /// The `name`, `bucket` and `kms_key` fields must not be populated (these /// values are specified in the `destination_name`, `destination_bucket`, and /// `destination_kms_key` fields). @@ -1087,19 +1100,19 @@ pub struct RewriteObjectRequest { /// Required. Name of the source object. #[prost(string, tag = "3")] pub source_object: ::prost::alloc::string::String, - /// If present, selects a specific revision of the source object (as opposed to - /// the latest version, the default). + /// Optional. If present, selects a specific revision of the source object (as + /// opposed to the latest version, the default). #[prost(int64, tag = "4")] pub source_generation: i64, - /// Include this field (from the previous rewrite response) on each rewrite - /// request after the first one, until the rewrite response 'done' flag is - /// true. Calls that provide a rewriteToken can omit all other request fields, - /// but if included those fields must match the values provided in the first - /// rewrite request. + /// Optional. Include this field (from the previous rewrite response) on each + /// rewrite request after the first one, until the rewrite response 'done' flag + /// is true. Calls that provide a rewriteToken can omit all other request + /// fields, but if included those fields must match the values provided in the + /// first rewrite request. #[prost(string, tag = "5")] pub rewrite_token: ::prost::alloc::string::String, - /// Apply a predefined set of access controls to the destination object. - /// Valid values are "authenticatedRead", "bucketOwnerFullControl", + /// Optional. Apply a predefined set of access controls to the destination + /// object. Valid values are "authenticatedRead", "bucketOwnerFullControl", /// "bucketOwnerRead", "private", "projectPrivate", or "publicRead". #[prost(string, tag = "28")] pub destination_predefined_acl: ::prost::alloc::string::String, @@ -1138,35 +1151,35 @@ pub struct RewriteObjectRequest { /// metageneration does not match the given value. #[prost(int64, optional, tag = "14")] pub if_source_metageneration_not_match: ::core::option::Option, - /// The maximum number of bytes that will be rewritten per rewrite request. - /// Most callers - /// shouldn't need to specify this parameter - it is primarily in place to - /// support testing. If specified the value must be an integral multiple of - /// 1 MiB (1048576). Also, this only applies to requests where the source and - /// destination span locations and/or storage classes. Finally, this value must - /// not change across rewrite calls else you'll get an error that the - /// `rewriteToken` is invalid. + /// Optional. The maximum number of bytes that will be rewritten per rewrite + /// request. Most callers shouldn't need to specify this parameter - it is + /// primarily in place to support testing. If specified the value must be an + /// integral multiple of 1 MiB (1048576). Also, this only applies to requests + /// where the source and destination span locations and/or storage classes. + /// Finally, this value must not change across rewrite calls else you'll get an + /// error that the `rewriteToken` is invalid. #[prost(int64, tag = "15")] pub max_bytes_rewritten_per_call: i64, - /// The algorithm used to encrypt the source object, if any. Used if the source - /// object was encrypted with a Customer-Supplied Encryption Key. + /// Optional. The algorithm used to encrypt the source object, if any. Used if + /// the source object was encrypted with a Customer-Supplied Encryption Key. #[prost(string, tag = "16")] pub copy_source_encryption_algorithm: ::prost::alloc::string::String, - /// The raw bytes (not base64-encoded) AES-256 encryption key used to encrypt - /// the source object, if it was encrypted with a Customer-Supplied Encryption - /// Key. + /// Optional. The raw bytes (not base64-encoded) AES-256 encryption key used to + /// encrypt the source object, if it was encrypted with a Customer-Supplied + /// Encryption Key. #[prost(bytes = "bytes", tag = "21")] pub copy_source_encryption_key_bytes: ::prost::bytes::Bytes, - /// The raw bytes (not base64-encoded) SHA256 hash of the encryption key used - /// to encrypt the source object, if it was encrypted with a Customer-Supplied - /// Encryption Key. + /// Optional. The raw bytes (not base64-encoded) SHA256 hash of the encryption + /// key used to encrypt the source object, if it was encrypted with a + /// Customer-Supplied Encryption Key. #[prost(bytes = "bytes", tag = "22")] pub copy_source_encryption_key_sha256_bytes: ::prost::bytes::Bytes, - /// A set of parameters common to Storage API requests concerning an object. + /// Optional. A set of parameters common to Storage API requests concerning an + /// object. #[prost(message, optional, tag = "19")] pub common_object_request_params: ::core::option::Option, - /// The checksums of the complete object. This will be used to validate the - /// destination object after rewriting. + /// Optional. The checksums of the complete object. This will be used to + /// validate the destination object after rewriting. #[prost(message, optional, tag = "29")] pub object_checksums: ::core::option::Option, } @@ -1269,12 +1282,13 @@ pub struct StartResumableWriteRequest { /// Required. Contains the information necessary to start a resumable write. #[prost(message, optional, tag = "1")] pub write_object_spec: ::core::option::Option, - /// A set of parameters common to Storage API requests related to an object. + /// Optional. A set of parameters common to Storage API requests related to an + /// object. #[prost(message, optional, tag = "3")] pub common_object_request_params: ::core::option::Option, - /// The checksums of the complete object. This is used to validate the - /// uploaded object. For each upload, `object_checksums` can be provided when - /// initiating a resumable upload with`StartResumableWriteRequest` or when + /// Optional. The checksums of the complete object. This is used to validate + /// the uploaded object. For each upload, `object_checksums` can be provided + /// when initiating a resumable upload with`StartResumableWriteRequest` or when /// completing a write with `WriteObjectRequest` with /// `finish_write` set to `true`. #[prost(message, optional, tag = "5")] @@ -1320,7 +1334,7 @@ pub struct UpdateObjectRequest { /// metageneration does not match the given value. #[prost(int64, optional, tag = "5")] pub if_metageneration_not_match: ::core::option::Option, - /// Apply a predefined set of access controls to this object. + /// Optional. Apply a predefined set of access controls to this object. /// Valid values are "authenticatedRead", "bucketOwnerFullControl", /// "bucketOwnerRead", "private", "projectPrivate", or "publicRead". #[prost(string, tag = "10")] @@ -1335,23 +1349,24 @@ pub struct UpdateObjectRequest { /// Not specifying any fields is an error. #[prost(message, optional, tag = "7")] pub update_mask: ::core::option::Option<::prost_types::FieldMask>, - /// A set of parameters common to Storage API requests concerning an object. + /// Optional. A set of parameters common to Storage API requests concerning an + /// object. #[prost(message, optional, tag = "8")] pub common_object_request_params: ::core::option::Option, } /// Parameters that can be passed to any object request. #[derive(Clone, PartialEq, ::prost::Message)] pub struct CommonObjectRequestParams { - /// Encryption algorithm used with the Customer-Supplied Encryption Keys - /// feature. + /// Optional. Encryption algorithm used with the Customer-Supplied Encryption + /// Keys feature. #[prost(string, tag = "1")] pub encryption_algorithm: ::prost::alloc::string::String, - /// Encryption key used with the Customer-Supplied Encryption Keys feature. - /// In raw bytes format (not base64-encoded). + /// Optional. Encryption key used with the Customer-Supplied Encryption Keys + /// feature. In raw bytes format (not base64-encoded). #[prost(bytes = "bytes", tag = "4")] pub encryption_key_bytes: ::prost::bytes::Bytes, - /// SHA256 hash of encryption key used with the Customer-Supplied Encryption - /// Keys feature. + /// Optional. SHA256 hash of encryption key used with the Customer-Supplied + /// Encryption Keys feature. #[prost(bytes = "bytes", tag = "5")] pub encryption_key_sha256_bytes: ::prost::bytes::Bytes, } @@ -1505,7 +1520,7 @@ pub mod service_constants { /// A bucket. #[derive(Clone, PartialEq, ::prost::Message)] pub struct Bucket { - /// Immutable. The name of the bucket. + /// Identifier. The name of the bucket. /// Format: `projects/{project}/buckets/{bucket}` #[prost(string, tag = "1")] pub name: ::prost::alloc::string::String, @@ -1522,6 +1537,7 @@ pub struct Bucket { /// Immutable. The project which owns this bucket, in the format of /// "projects/{projectIdentifier}". /// {projectIdentifier} can be the project ID or project number. + /// Output values will always be in project number format. #[prost(string, tag = "3")] pub project: ::prost::alloc::string::String, /// Output only. The metadata generation of this bucket. @@ -1539,33 +1555,33 @@ pub struct Bucket { /// multi-region, etc). #[prost(string, tag = "6")] pub location_type: ::prost::alloc::string::String, - /// The bucket's default storage class, used whenever no storageClass is - /// specified for a newly-created object. This defines how objects in the + /// Optional. The bucket's default storage class, used whenever no storageClass + /// is specified for a newly-created object. This defines how objects in the /// bucket are stored and determines the SLA and the cost of storage. /// If this value is not specified when the bucket is created, it will default /// to `STANDARD`. For more information, see /// #[prost(string, tag = "7")] pub storage_class: ::prost::alloc::string::String, - /// The recovery point objective for cross-region replication of the bucket. - /// Applicable only for dual- and multi-region buckets. "DEFAULT" uses default - /// replication. "ASYNC_TURBO" enables turbo replication, valid for dual-region - /// buckets only. If rpo is not specified when the bucket is created, it - /// defaults to "DEFAULT". For more information, see + /// Optional. The recovery point objective for cross-region replication of the + /// bucket. Applicable only for dual- and multi-region buckets. "DEFAULT" uses + /// default replication. "ASYNC_TURBO" enables turbo replication, valid for + /// dual-region buckets only. If rpo is not specified when the bucket is + /// created, it defaults to "DEFAULT". For more information, see /// #[prost(string, tag = "27")] pub rpo: ::prost::alloc::string::String, - /// Access controls on the bucket. + /// Optional. Access controls on the bucket. /// If iam_config.uniform_bucket_level_access is enabled on this bucket, /// requests to set, read, or modify acl is an error. #[prost(message, repeated, tag = "8")] pub acl: ::prost::alloc::vec::Vec, - /// Default access controls to apply to new objects when no ACL is provided. - /// If iam_config.uniform_bucket_level_access is enabled on this bucket, - /// requests to set, read, or modify acl is an error. + /// Optional. Default access controls to apply to new objects when no ACL is + /// provided. If iam_config.uniform_bucket_level_access is enabled on this + /// bucket, requests to set, read, or modify acl is an error. #[prost(message, repeated, tag = "9")] pub default_object_acl: ::prost::alloc::vec::Vec, - /// The bucket's lifecycle config. See + /// Optional. The bucket's lifecycle config. See /// \[ Management] /// for more information. #[prost(message, optional, tag = "10")] @@ -1573,44 +1589,44 @@ pub struct Bucket { /// Output only. The creation time of the bucket. #[prost(message, optional, tag = "11")] pub create_time: ::core::option::Option<::prost_types::Timestamp>, - /// The bucket's [ Resource Sharing] - /// (CORS) config. + /// Optional. The bucket's [ Resource + /// Sharing] (CORS) config. #[prost(message, repeated, tag = "12")] pub cors: ::prost::alloc::vec::Vec, /// Output only. The modification time of the bucket. #[prost(message, optional, tag = "13")] pub update_time: ::core::option::Option<::prost_types::Timestamp>, - /// The default value for event-based hold on newly created objects in this - /// bucket. Event-based hold is a way to retain objects indefinitely until an - /// event occurs, signified by the - /// hold's release. After being released, such objects will be subject to - /// bucket-level retention (if any). One sample use case of this flag is for - /// banks to hold loan documents for at least 3 years after loan is paid in - /// full. Here, bucket-level retention is 3 years and the event is loan being - /// paid in full. In this example, these objects will be held intact for any - /// number of years until the event has occurred (event-based hold on the - /// object is released) and then 3 more years after that. That means retention - /// duration of the objects begins from the moment event-based hold - /// transitioned from true to false. Objects under event-based hold cannot be - /// deleted, overwritten or archived until the hold is removed. + /// Optional. The default value for event-based hold on newly created objects + /// in this bucket. Event-based hold is a way to retain objects indefinitely + /// until an event occurs, signified by the hold's release. After being + /// released, such objects will be subject to bucket-level retention (if any). + /// One sample use case of this flag is for banks to hold loan documents for at + /// least 3 years after loan is paid in full. Here, bucket-level retention is 3 + /// years and the event is loan being paid in full. In this example, these + /// objects will be held intact for any number of years until the event has + /// occurred (event-based hold on the object is released) and then 3 more years + /// after that. That means retention duration of the objects begins from the + /// moment event-based hold transitioned from true to false. Objects under + /// event-based hold cannot be deleted, overwritten or archived until the hold + /// is removed. #[prost(bool, tag = "14")] pub default_event_based_hold: bool, - /// User-provided labels, in key/value pairs. + /// Optional. User-provided labels, in key/value pairs. #[prost(map = "string, string", tag = "15")] pub labels: ::std::collections::HashMap< ::prost::alloc::string::String, ::prost::alloc::string::String, >, - /// The bucket's website config, controlling how the service behaves + /// Optional. The bucket's website config, controlling how the service behaves /// when accessing bucket contents as a web site. See the /// [ Website /// Examples] for more information. #[prost(message, optional, tag = "16")] pub website: ::core::option::Option, - /// The bucket's versioning config. + /// Optional. The bucket's versioning config. #[prost(message, optional, tag = "17")] pub versioning: ::core::option::Option, - /// The bucket's logging config, which defines the destination bucket + /// Optional. The bucket's logging config, which defines the destination bucket /// and name prefix (if any) for the current bucket's logs. #[prost(message, optional, tag = "18")] pub logging: ::core::option::Option, @@ -1618,36 +1634,38 @@ pub struct Bucket { /// owner group. #[prost(message, optional, tag = "19")] pub owner: ::core::option::Option, - /// Encryption config for a bucket. + /// Optional. Encryption config for a bucket. #[prost(message, optional, tag = "20")] pub encryption: ::core::option::Option, - /// The bucket's billing config. + /// Optional. The bucket's billing config. #[prost(message, optional, tag = "21")] pub billing: ::core::option::Option, - /// The bucket's retention policy. The retention policy enforces a minimum - /// retention time for all objects contained in the bucket, based on their - /// creation time. Any attempt to overwrite or delete objects younger than the - /// retention period will result in a PERMISSION_DENIED error. An unlocked - /// retention policy can be modified or removed from the bucket via a + /// Optional. The bucket's retention policy. The retention policy enforces a + /// minimum retention time for all objects contained in the bucket, based on + /// their creation time. Any attempt to overwrite or delete objects younger + /// than the retention period will result in a PERMISSION_DENIED error. An + /// unlocked retention policy can be modified or removed from the bucket via a /// storage.buckets.update operation. A locked retention policy cannot be /// removed or shortened in duration for the lifetime of the bucket. /// Attempting to remove or decrease period of a locked retention policy will /// result in a PERMISSION_DENIED error. #[prost(message, optional, tag = "22")] pub retention_policy: ::core::option::Option, - /// The bucket's IAM config. + /// Optional. The bucket's IAM config. #[prost(message, optional, tag = "23")] pub iam_config: ::core::option::Option, - /// Reserved for future use. + /// Optional. Reserved for future use. #[prost(bool, tag = "25")] pub satisfies_pzs: bool, - /// Configuration that, if present, specifies the data placement for a + /// Optional. Configuration that, if present, specifies the data placement for + /// a /// [ /// dual-region]. #[prost(message, optional, tag = "26")] pub custom_placement_config: ::core::option::Option, - /// The bucket's Autoclass configuration. If there is no configuration, the - /// Autoclass feature will be disabled and have no effect on the bucket. + /// Optional. The bucket's Autoclass configuration. If there is no + /// configuration, the Autoclass feature will be disabled and have no effect on + /// the bucket. #[prost(message, optional, tag = "28")] pub autoclass: ::core::option::Option, /// Optional. The bucket's hierarchical namespace configuration. If there is no @@ -1659,13 +1677,16 @@ pub struct Bucket { /// soft-deleted objects from being permanently deleted. #[prost(message, optional, tag = "31")] pub soft_delete_policy: ::core::option::Option, + /// Optional. The bucket's IP filter configuration. + #[prost(message, optional, tag = "38")] + pub ip_filter: ::core::option::Option, } /// Nested message and enum types in `Bucket`. pub mod bucket { /// Billing properties of a bucket. #[derive(Clone, Copy, PartialEq, ::prost::Message)] pub struct Billing { - /// When set to true, Requester Pays is enabled for this bucket. + /// Optional. When set to true, Requester Pays is enabled for this bucket. #[prost(bool, tag = "1")] pub requester_pays: bool, } @@ -1675,22 +1696,23 @@ pub mod bucket { /// For more on CORS in general, see #[derive(Clone, PartialEq, ::prost::Message)] pub struct Cors { - /// The list of Origins eligible to receive CORS response headers. See - /// [ 6454] for more on origins. + /// Optional. The list of Origins eligible to receive CORS response headers. + /// See [ 6454] for more on origins. /// Note: "*" is permitted in the list of origins, and means "any Origin". #[prost(string, repeated, tag = "1")] pub origin: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, - /// The list of HTTP methods on which to include CORS response headers, + /// Optional. The list of HTTP methods on which to include CORS response + /// headers, /// (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of /// methods, and means "any method". #[prost(string, repeated, tag = "2")] pub method: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, - /// The list of HTTP headers other than the + /// Optional. The list of HTTP headers other than the /// [ response /// headers] to give permission for the user-agent to share across domains. #[prost(string, repeated, tag = "3")] pub response_header: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, - /// The value, in seconds, to return in the + /// Optional. The value, in seconds, to return in the /// [ /// header] used in preflight responses. #[prost(int32, tag = "4")] @@ -1699,21 +1721,21 @@ pub mod bucket { /// Encryption properties of a bucket. #[derive(Clone, PartialEq, ::prost::Message)] pub struct Encryption { - /// The name of the Cloud KMS key that will be used to encrypt objects - /// inserted into this bucket, if no encryption method is specified. + /// Optional. The name of the Cloud KMS key that will be used to encrypt + /// objects inserted into this bucket, if no encryption method is specified. #[prost(string, tag = "1")] pub default_kms_key: ::prost::alloc::string::String, } /// Bucket restriction options. #[derive(Clone, PartialEq, ::prost::Message)] pub struct IamConfig { - /// Bucket restriction options currently enforced on the bucket. + /// Optional. Bucket restriction options currently enforced on the bucket. #[prost(message, optional, tag = "1")] pub uniform_bucket_level_access: ::core::option::Option< iam_config::UniformBucketLevelAccess, >, - /// Whether IAM will enforce public access prevention. Valid values are - /// "enforced" or "inherited". + /// Optional. Whether IAM will enforce public access prevention. Valid values + /// are "enforced" or "inherited". #[prost(string, tag = "3")] pub public_access_prevention: ::prost::alloc::string::String, } @@ -1723,10 +1745,11 @@ pub mod bucket { /// See #[derive(Clone, Copy, PartialEq, ::prost::Message)] pub struct UniformBucketLevelAccess { - /// If set, access checks only use bucket-level IAM policies or above. + /// Optional. If set, access checks only use bucket-level IAM policies or + /// above. #[prost(bool, tag = "1")] pub enabled: bool, - /// The deadline time for changing + /// Optional. The deadline time for changing /// `iam_config.uniform_bucket_level_access.enabled` from `true` to /// `false`. Mutable until the specified deadline is reached, but not /// afterward. @@ -1738,8 +1761,8 @@ pub mod bucket { /// For more information, see #[derive(Clone, PartialEq, ::prost::Message)] pub struct Lifecycle { - /// A lifecycle management rule, which is made of an action to take and the - /// condition(s) under which the action will be taken. + /// Optional. A lifecycle management rule, which is made of an action to take + /// and the condition(s) under which the action will be taken. #[prost(message, repeated, tag = "1")] pub rule: ::prost::alloc::vec::Vec, } @@ -1749,10 +1772,10 @@ pub mod bucket { /// condition which will trigger that action. #[derive(Clone, PartialEq, ::prost::Message)] pub struct Rule { - /// The action to take. + /// Optional. The action to take. #[prost(message, optional, tag = "1")] pub action: ::core::option::Option, - /// The condition(s) under which the action will be taken. + /// Optional. The condition(s) under which the action will be taken. #[prost(message, optional, tag = "2")] pub condition: ::core::option::Option, } @@ -1761,12 +1784,13 @@ pub mod bucket { /// An action to take on an object. #[derive(Clone, PartialEq, ::prost::Message)] pub struct Action { - /// Type of the action. Currently, only `Delete`, `SetStorageClass`, and - /// `AbortIncompleteMultipartUpload` are supported. + /// Optional. Type of the action. Currently, only `Delete`, + /// `SetStorageClass`, and `AbortIncompleteMultipartUpload` are + /// supported. #[prost(string, tag = "1")] pub r#type: ::prost::alloc::string::String, - /// Target storage class. Required iff the type of the action is - /// SetStorageClass. + /// Optional. Target storage class. Required iff the type of the action + /// is SetStorageClass. #[prost(string, tag = "2")] pub storage_class: ::prost::alloc::string::String, } @@ -1779,8 +1803,8 @@ pub mod bucket { /// condition. #[prost(int32, optional, tag = "1")] pub age_days: ::core::option::Option, - /// This condition is satisfied when an object is created before midnight - /// of the specified date in UTC. + /// Optional. This condition is satisfied when an object is created + /// before midnight of the specified date in UTC. #[prost(message, optional, tag = "2")] pub created_before: ::core::option::Option< super::super::super::super::super::r#type::Date, @@ -1795,9 +1819,9 @@ pub mod bucket { /// the live version) newer than this version of the object. #[prost(int32, optional, tag = "4")] pub num_newer_versions: ::core::option::Option, - /// Objects having any of the storage classes specified by this condition - /// will be matched. Values include `MULTI_REGIONAL`, `REGIONAL`, - /// `NEARLINE`, `COLDLINE`, `STANDARD`, and + /// Optional. Objects having any of the storage classes specified by this + /// condition will be matched. Values include `MULTI_REGIONAL`, + /// `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and /// `DURABLE_REDUCED_AVAILABILITY`. #[prost(string, repeated, tag = "5")] pub matches_storage_class: ::prost::alloc::vec::Vec< @@ -1808,8 +1832,8 @@ pub mod bucket { /// The value of the field must be a nonnegative integer. #[prost(int32, optional, tag = "7")] pub days_since_custom_time: ::core::option::Option, - /// An object matches this condition if the custom timestamp set on the - /// object is before the specified date in UTC. + /// Optional. An object matches this condition if the custom timestamp + /// set on the object is before the specified date in UTC. #[prost(message, optional, tag = "8")] pub custom_time_before: ::core::option::Option< super::super::super::super::super::r#type::Date, @@ -1821,21 +1845,21 @@ pub mod bucket { /// eligible for Lifecycle action as soon as it becomes noncurrent. #[prost(int32, optional, tag = "9")] pub days_since_noncurrent_time: ::core::option::Option, - /// This condition is relevant only for versioned objects. An object - /// version satisfies this condition only if it became noncurrent before - /// the specified date in UTC. + /// Optional. This condition is relevant only for versioned objects. An + /// object version satisfies this condition only if it became noncurrent + /// before the specified date in UTC. #[prost(message, optional, tag = "10")] pub noncurrent_time_before: ::core::option::Option< super::super::super::super::super::r#type::Date, >, - /// List of object name prefixes. If any prefix exactly matches the - /// beginning of the object name, the condition evaluates to true. + /// Optional. List of object name prefixes. If any prefix exactly matches + /// the beginning of the object name, the condition evaluates to true. #[prost(string, repeated, tag = "11")] pub matches_prefix: ::prost::alloc::vec::Vec< ::prost::alloc::string::String, >, - /// List of object name suffixes. If any suffix exactly matches the - /// end of the object name, the condition evaluates to true. + /// Optional. List of object name suffixes. If any suffix exactly matches + /// the end of the object name, the condition evaluates to true. #[prost(string, repeated, tag = "12")] pub matches_suffix: ::prost::alloc::vec::Vec< ::prost::alloc::string::String, @@ -1846,29 +1870,29 @@ pub mod bucket { /// Logging-related properties of a bucket. #[derive(Clone, PartialEq, ::prost::Message)] pub struct Logging { - /// The destination bucket where the current bucket's logs should be placed, - /// using path format (like `projects/123456/buckets/foo`). + /// Optional. The destination bucket where the current bucket's logs should + /// be placed, using path format (like `projects/123456/buckets/foo`). #[prost(string, tag = "1")] pub log_bucket: ::prost::alloc::string::String, - /// A prefix for log object names. + /// Optional. A prefix for log object names. #[prost(string, tag = "2")] pub log_object_prefix: ::prost::alloc::string::String, } /// Retention policy properties of a bucket. #[derive(Clone, Copy, PartialEq, ::prost::Message)] pub struct RetentionPolicy { - /// Server-determined value that indicates the time from which policy was - /// enforced and effective. + /// Optional. Server-determined value that indicates the time from which + /// policy was enforced and effective. #[prost(message, optional, tag = "1")] pub effective_time: ::core::option::Option<::prost_types::Timestamp>, - /// Once locked, an object retention policy cannot be modified. + /// Optional. Once locked, an object retention policy cannot be modified. #[prost(bool, tag = "2")] pub is_locked: bool, - /// The duration that objects need to be retained. Retention duration must be - /// greater than zero and less than 100 years. Note that enforcement of - /// retention periods less than a day is not guaranteed. Such periods should - /// only be used for testing purposes. Any `nanos` value specified will be - /// rounded down to the nearest second. + /// Optional. The duration that objects need to be retained. Retention + /// duration must be greater than zero and less than 100 years. Note that + /// enforcement of retention periods less than a day is not guaranteed. Such + /// periods should only be used for testing purposes. Any `nanos` value + /// specified will be rounded down to the nearest second. #[prost(message, optional, tag = "4")] pub retention_duration: ::core::option::Option<::prost_types::Duration>, } @@ -1889,7 +1913,7 @@ pub mod bucket { /// #[derive(Clone, Copy, PartialEq, ::prost::Message)] pub struct Versioning { - /// While set to true, versioning is fully enabled for this bucket. + /// Optional. While set to true, versioning is fully enabled for this bucket. #[prost(bool, tag = "1")] pub enabled: bool, } @@ -1898,13 +1922,13 @@ pub mod bucket { /// #[derive(Clone, PartialEq, ::prost::Message)] pub struct Website { - /// If the requested object path is missing, the service will ensure the path - /// has a trailing '/', append this suffix, and attempt to retrieve the - /// resulting object. This allows the creation of `index.html` + /// Optional. If the requested object path is missing, the service will + /// ensure the path has a trailing '/', append this suffix, and attempt to + /// retrieve the resulting object. This allows the creation of `index.html` /// objects to represent directory pages. #[prost(string, tag = "1")] pub main_page_suffix: ::prost::alloc::string::String, - /// If the requested object path is missing, and any + /// Optional. If the requested object path is missing, and any /// `mainPageSuffix` object is missing, if applicable, the service /// will return the named object from this bucket as the content for a /// [ Not Found] @@ -1917,14 +1941,14 @@ pub mod bucket { /// may be found [ #[derive(Clone, PartialEq, ::prost::Message)] pub struct CustomPlacementConfig { - /// List of locations to use for data placement. + /// Optional. List of locations to use for data placement. #[prost(string, repeated, tag = "1")] pub data_locations: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, } /// Configuration for a bucket's Autoclass feature. #[derive(Clone, PartialEq, ::prost::Message)] pub struct Autoclass { - /// Enables Autoclass. + /// Optional. Enables Autoclass. #[prost(bool, tag = "1")] pub enabled: bool, /// Output only. Latest instant at which the `enabled` field was set to true @@ -1947,6 +1971,69 @@ pub mod bucket { ::prost_types::Timestamp, >, } + /// The [bucket IP + /// filtering]() + /// configuration. Specifies the network sources that can access the bucket, as + /// well as its underlying objects. + #[derive(Clone, PartialEq, ::prost::Message)] + pub struct IpFilter { + /// The state of the IP filter configuration. Valid values are `Enabled` and + /// `Disabled`. When set to `Enabled`, IP filtering rules are applied to a + /// bucket and all incoming requests to the bucket are evaluated against + /// these rules. When set to `Disabled`, IP filtering rules are not applied + /// to a bucket.". + #[prost(string, optional, tag = "1")] + pub mode: ::core::option::Option<::prost::alloc::string::String>, + /// Public IPs allowed to operate or access the bucket. + #[prost(message, optional, tag = "2")] + pub public_network_source: ::core::option::Option< + ip_filter::PublicNetworkSource, + >, + /// Optional. The list of network sources that are allowed to access + /// operations on the bucket or the underlying objects. + #[prost(message, repeated, tag = "3")] + pub vpc_network_sources: ::prost::alloc::vec::Vec, + /// Optional. Whether or not to allow VPCs from orgs different than the + /// bucket's parent org to access the bucket. When set to true, validations + /// on the existence of the VPCs won't be performed. If set to false, each + /// VPC network source will be checked to belong to the same org as the + /// bucket as well as validated for existence. + #[prost(bool, tag = "4")] + pub allow_cross_org_vpcs: bool, + } + /// Nested message and enum types in `IpFilter`. + pub mod ip_filter { + /// The public network IP address ranges that can access the bucket and its + /// data. + #[derive(Clone, PartialEq, ::prost::Message)] + pub struct PublicNetworkSource { + /// Optional. The list of IPv4 and IPv6 cidr blocks that are allowed to + /// operate or access the bucket and its underlying objects. + #[prost(string, repeated, tag = "1")] + pub allowed_ip_cidr_ranges: ::prost::alloc::vec::Vec< + ::prost::alloc::string::String, + >, + } + /// The list of VPC networks that can access the bucket. + #[derive(Clone, PartialEq, ::prost::Message)] + pub struct VpcNetworkSource { + /// Name of the network. + /// + /// Format: `projects/PROJECT_ID/global/networks/NETWORK_NAME` + #[prost(string, optional, tag = "1")] + pub network: ::core::option::Option<::prost::alloc::string::String>, + /// Optional. The list of public or private IPv4 and IPv6 CIDR ranges that + /// can access the bucket. In the CIDR IP address block, the specified IP + /// address must be properly truncated, meaning all the host bits must be + /// zero or else the input is considered malformed. For example, + /// `192.0.2.0/24` is accepted but `192.0.2.1/24` is not. Similarly, for + /// IPv6, `2001:db8::/32` is accepted whereas `2001:db8::1/32` is not. + #[prost(string, repeated, tag = "2")] + pub allowed_ip_cidr_ranges: ::prost::alloc::vec::Vec< + ::prost::alloc::string::String, + >, + } + } /// Configuration for a bucket's hierarchical namespace feature. #[derive(Clone, Copy, PartialEq, ::prost::Message)] pub struct HierarchicalNamespace { @@ -1958,13 +2045,13 @@ pub mod bucket { /// An access-control entry. #[derive(Clone, PartialEq, ::prost::Message)] pub struct BucketAccessControl { - /// The access permission for the entity. + /// Optional. The access permission for the entity. #[prost(string, tag = "1")] pub role: ::prost::alloc::string::String, - /// The ID of the access-control entry. + /// Optional. The ID of the access-control entry. #[prost(string, tag = "2")] pub id: ::prost::alloc::string::String, - /// The entity holding the permission, in one of the following forms: + /// Optional. The entity holding the permission, in one of the following forms: /// * `user-{userid}` /// * `user-{email}` /// * `group-{groupid}` @@ -1988,22 +2075,22 @@ pub struct BucketAccessControl { /// entities, `project-{team}-{projectid}` format will be returned on response. #[prost(string, tag = "9")] pub entity_alt: ::prost::alloc::string::String, - /// The ID for the entity, if any. + /// Optional. The ID for the entity, if any. #[prost(string, tag = "4")] pub entity_id: ::prost::alloc::string::String, - /// The etag of the BucketAccessControl. + /// Optional. The etag of the BucketAccessControl. /// If included in the metadata of an update or delete request message, the /// operation operation will only be performed if the etag matches that of the /// bucket's BucketAccessControl. #[prost(string, tag = "8")] pub etag: ::prost::alloc::string::String, - /// The email address associated with the entity, if any. + /// Optional. The email address associated with the entity, if any. #[prost(string, tag = "5")] pub email: ::prost::alloc::string::String, - /// The domain associated with the entity, if any. + /// Optional. The domain associated with the entity, if any. #[prost(string, tag = "6")] pub domain: ::prost::alloc::string::String, - /// The project team associated with the entity, if any. + /// Optional. The project team associated with the entity, if any. #[prost(message, optional, tag = "7")] pub project_team: ::core::option::Option, } @@ -2027,7 +2114,7 @@ pub struct ObjectChecksums { /// object matches this checksum. #[prost(fixed32, optional, tag = "1")] pub crc32c: ::core::option::Option, - /// 128 bit MD5 hash of the object data. + /// Optional. 128 bit MD5 hash of the object data. /// For more information about using the MD5 hash, see /// [ and /// ETags: Best Practices]. @@ -2041,10 +2128,10 @@ pub struct ObjectChecksums { /// Object's data at rest. #[derive(Clone, PartialEq, ::prost::Message)] pub struct CustomerEncryption { - /// The encryption algorithm. + /// Optional. The encryption algorithm. #[prost(string, tag = "1")] pub encryption_algorithm: ::prost::alloc::string::String, - /// SHA256 hash value of the encryption key. + /// Optional. SHA256 hash value of the encryption key. /// In raw bytes format (not base64-encoded). #[prost(bytes = "bytes", tag = "3")] pub key_sha256_bytes: ::prost::bytes::Bytes, @@ -2064,7 +2151,7 @@ pub struct Object { /// Immutable. The name of the bucket containing this object. #[prost(string, tag = "2")] pub bucket: ::prost::alloc::string::String, - /// The etag of the object. + /// Optional. The etag of the object. /// If included in the metadata of an update or delete request message, the /// operation will only be performed if the etag matches that of the live /// object. @@ -2085,33 +2172,33 @@ pub struct Object { /// generation of a particular object. #[prost(int64, tag = "4")] pub metageneration: i64, - /// Storage class of the object. + /// Optional. Storage class of the object. #[prost(string, tag = "5")] pub storage_class: ::prost::alloc::string::String, /// Output only. Content-Length of the object data in bytes, matching /// [ 7230 §3.3.2]. #[prost(int64, tag = "6")] pub size: i64, - /// Content-Encoding of the object data, matching + /// Optional. Content-Encoding of the object data, matching /// [ 7231 §3.1.2.2] #[prost(string, tag = "7")] pub content_encoding: ::prost::alloc::string::String, - /// Content-Disposition of the object data, matching + /// Optional. Content-Disposition of the object data, matching /// [ 6266]. #[prost(string, tag = "8")] pub content_disposition: ::prost::alloc::string::String, - /// Cache-Control directive for the object data, matching + /// Optional. Cache-Control directive for the object data, matching /// [ 7234 §5.2]. /// If omitted, and the object is accessible to all anonymous users, the /// default will be `public, max-age=3600`. #[prost(string, tag = "9")] pub cache_control: ::prost::alloc::string::String, - /// Access controls on the object. + /// Optional. Access controls on the object. /// If iam_config.uniform_bucket_level_access is enabled on the parent /// bucket, requests to set, read, or modify acl is an error. #[prost(message, repeated, tag = "10")] pub acl: ::prost::alloc::vec::Vec, - /// Content-Language of the object data, matching + /// Optional. Content-Language of the object data, matching /// [ 7231 §3.1.3.2]. #[prost(string, tag = "11")] pub content_language: ::prost::alloc::string::String, @@ -2122,7 +2209,7 @@ pub struct Object { /// Output only. The time when the object was finalized. #[prost(message, optional, tag = "36")] pub finalize_time: ::core::option::Option<::prost_types::Timestamp>, - /// Content-Type of the object data, matching + /// Optional. Content-Type of the object data, matching /// [ 7231 §3.1.1.5]. /// If an object is stored without a Content-Type, it is served as /// `application/octet-stream`. @@ -2150,31 +2237,31 @@ pub struct Object { /// Object Lifecycle Configuration. #[prost(message, optional, tag = "17")] pub update_time: ::core::option::Option<::prost_types::Timestamp>, - /// Cloud KMS Key used to encrypt this object, if the object is encrypted by - /// such a key. + /// Optional. Cloud KMS Key used to encrypt this object, if the object is + /// encrypted by such a key. #[prost(string, tag = "18")] pub kms_key: ::prost::alloc::string::String, /// Output only. The time at which the object's storage class was last changed. /// When the object is initially created, it will be set to time_created. #[prost(message, optional, tag = "19")] pub update_storage_class_time: ::core::option::Option<::prost_types::Timestamp>, - /// Whether an object is under temporary hold. While this flag is set to true, - /// the object is protected against deletion and overwrites. A common use case - /// of this flag is regulatory investigations where objects need to be retained - /// while the investigation is ongoing. Note that unlike event-based hold, - /// temporary hold does not impact retention expiration time of an object. + /// Optional. Whether an object is under temporary hold. While this flag is set + /// to true, the object is protected against deletion and overwrites. A common + /// use case of this flag is regulatory investigations where objects need to be + /// retained while the investigation is ongoing. Note that unlike event-based + /// hold, temporary hold does not impact retention expiration time of an + /// object. #[prost(bool, tag = "20")] pub temporary_hold: bool, - /// A server-determined value that specifies the earliest time that the - /// object's retention period expires. - /// Note 1: This field is not provided for objects with an active event-based - /// hold, since retention expiration is unknown until the hold is removed. - /// Note 2: This value can be provided even when temporary hold is set (so that - /// the user can reason about policy without having to first unset the - /// temporary hold). + /// Optional. A server-determined value that specifies the earliest time that + /// the object's retention period expires. Note 1: This field is not provided + /// for objects with an active event-based hold, since retention expiration is + /// unknown until the hold is removed. Note 2: This value can be provided even + /// when temporary hold is set (so that the user can reason about policy + /// without having to first unset the temporary hold). #[prost(message, optional, tag = "21")] pub retention_expire_time: ::core::option::Option<::prost_types::Timestamp>, - /// User-provided metadata, in key/value pairs. + /// Optional. User-provided metadata, in key/value pairs. #[prost(map = "string, string", tag = "22")] pub metadata: ::std::collections::HashMap< ::prost::alloc::string::String, @@ -2197,11 +2284,11 @@ pub struct Object { /// the object. #[prost(message, optional, tag = "24")] pub owner: ::core::option::Option, - /// Metadata of Customer-Supplied Encryption Key, if the object is encrypted by - /// such a key. + /// Optional. Metadata of Customer-Supplied Encryption Key, if the object is + /// encrypted by such a key. #[prost(message, optional, tag = "25")] pub customer_encryption: ::core::option::Option, - /// A user-specified timestamp set on an object. + /// Optional. A user-specified timestamp set on an object. #[prost(message, optional, tag = "26")] pub custom_time: ::core::option::Option<::prost_types::Timestamp>, /// Output only. This is the time when the object became soft-deleted. @@ -2216,20 +2303,90 @@ pub struct Object { /// Otherwise, the object will not be accessible. #[prost(message, optional, tag = "29")] pub hard_delete_time: ::core::option::Option<::prost_types::Timestamp>, + /// Optional. Retention configuration of this object. + /// May only be configured if the bucket has object retention enabled. + #[prost(message, optional, tag = "30")] + pub retention: ::core::option::Option, +} +/// Nested message and enum types in `Object`. +pub mod object { + /// Specifies retention parameters of the object. Objects under retention + /// cannot be deleted or overwritten until their retention expires. + #[derive(Clone, Copy, PartialEq, ::prost::Message)] + pub struct Retention { + /// Optional. The mode of the Retention. + #[prost(enumeration = "retention::Mode", tag = "1")] + pub mode: i32, + /// Optional. The timestamp that the object needs to be retained until. + /// Value cannot be set in the past or more than 100 years in the future. + #[prost(message, optional, tag = "2")] + pub retain_until_time: ::core::option::Option<::prost_types::Timestamp>, + } + /// Nested message and enum types in `Retention`. + pub mod retention { + /// Retention mode values. + #[derive( + Clone, + Copy, + Debug, + PartialEq, + Eq, + Hash, + PartialOrd, + Ord, + ::prost::Enumeration + )] + #[repr(i32)] + pub enum Mode { + /// No specified mode. Object is not under retention. + Unspecified = 0, + /// Retention period may be decreased or increased. + /// The Retention configuration may be removed. + /// The mode may be changed to locked. + Unlocked = 1, + /// Retention period may be increased. + /// The Retention configuration cannot be removed. + /// The mode cannot be changed. + Locked = 2, + } + impl Mode { + /// String value of the enum field names used in the ProtoBuf definition. + /// + /// The values are not transformed in any way and thus are considered stable + /// (if the ProtoBuf definition does not change) and safe for programmatic use. + pub fn as_str_name(&self) -> &'static str { + match self { + Self::Unspecified => "MODE_UNSPECIFIED", + Self::Unlocked => "UNLOCKED", + Self::Locked => "LOCKED", + } + } + /// Creates an enum from field names used in the ProtoBuf definition. + pub fn from_str_name(value: &str) -> ::core::option::Option { + match value { + "MODE_UNSPECIFIED" => Some(Self::Unspecified), + "UNLOCKED" => Some(Self::Unlocked), + "LOCKED" => Some(Self::Locked), + _ => None, + } + } + } + } } /// An access-control entry. #[derive(Clone, PartialEq, ::prost::Message)] pub struct ObjectAccessControl { - /// The access permission for the entity. One of the following values: + /// Optional. The access permission for the entity. One of the following + /// values: /// * `READER` /// * `WRITER` /// * `OWNER` #[prost(string, tag = "1")] pub role: ::prost::alloc::string::String, - /// The ID of the access-control entry. + /// Optional. The ID of the access-control entry. #[prost(string, tag = "2")] pub id: ::prost::alloc::string::String, - /// The entity holding the permission, in one of the following forms: + /// Optional. The entity holding the permission, in one of the following forms: /// * `user-{userid}` /// * `user-{email}` /// * `group-{groupid}` @@ -2253,22 +2410,22 @@ pub struct ObjectAccessControl { /// entities, `project-{team}-{projectid}` format will be returned on response. #[prost(string, tag = "9")] pub entity_alt: ::prost::alloc::string::String, - /// The ID for the entity, if any. + /// Optional. The ID for the entity, if any. #[prost(string, tag = "4")] pub entity_id: ::prost::alloc::string::String, - /// The etag of the ObjectAccessControl. + /// Optional. The etag of the ObjectAccessControl. /// If included in the metadata of an update or delete request message, the /// operation will only be performed if the etag matches that of the live /// object's ObjectAccessControl. #[prost(string, tag = "8")] pub etag: ::prost::alloc::string::String, - /// The email address associated with the entity, if any. + /// Optional. The email address associated with the entity, if any. #[prost(string, tag = "5")] pub email: ::prost::alloc::string::String, - /// The domain associated with the entity, if any. + /// Optional. The domain associated with the entity, if any. #[prost(string, tag = "6")] pub domain: ::prost::alloc::string::String, - /// The project team associated with the entity, if any. + /// Optional. The project team associated with the entity, if any. #[prost(message, optional, tag = "7")] pub project_team: ::core::option::Option, } @@ -2290,20 +2447,20 @@ pub struct ListObjectsResponse { /// Represents the Viewers, Editors, or Owners of a given project. #[derive(Clone, PartialEq, ::prost::Message)] pub struct ProjectTeam { - /// The project number. + /// Optional. The project number. #[prost(string, tag = "1")] pub project_number: ::prost::alloc::string::String, - /// The team. + /// Optional. The team. #[prost(string, tag = "2")] pub team: ::prost::alloc::string::String, } /// The owner of a specific resource. #[derive(Clone, PartialEq, ::prost::Message)] pub struct Owner { - /// The entity, in the form `user-`*userId*. + /// Optional. The entity, in the form `user-`*userId*. #[prost(string, tag = "1")] pub entity: ::prost::alloc::string::String, - /// The ID for the entity. + /// Optional. The ID for the entity. #[prost(string, tag = "2")] pub entity_id: ::prost::alloc::string::String, } @@ -2552,7 +2709,9 @@ pub mod storage_client { } /// Gets the IAM policy for a specified bucket. /// The `resource` field in the request should be - /// `projects/_/buckets/{bucket}`. + /// `projects/_/buckets/{bucket}` for a bucket, or + /// `projects/_/buckets/{bucket}/managedFolders/{managedFolder}` + /// for a managed folder. pub async fn get_iam_policy( &mut self, request: impl tonic::IntoRequest< @@ -2581,7 +2740,9 @@ pub mod storage_client { } /// Updates an IAM policy for the specified bucket. /// The `resource` field in the request should be - /// `projects/_/buckets/{bucket}`. + /// `projects/_/buckets/{bucket}` for a bucket, or + /// `projects/_/buckets/{bucket}/managedFolders/{managedFolder}` + /// for a managed folder. pub async fn set_iam_policy( &mut self, request: impl tonic::IntoRequest< diff --git a/googleapis/src/google.cloud.bigquery.storage.v1.rs b/googleapis/src/google.cloud.bigquery.storage.v1.rs index 30fb8d24..b07c71aa 100644 --- a/googleapis/src/google.cloud.bigquery.storage.v1.rs +++ b/googleapis/src/google.cloud.bigquery.storage.v1.rs @@ -1121,7 +1121,6 @@ pub mod append_rows_request { /// request and currently, it will be ignored if specified in following /// requests. Following requests must have data in the same format as the /// initial request. - #[allow(clippy::large_enum_variant)] #[derive(Clone, PartialEq, ::prost::Oneof)] pub enum Rows { /// Rows in proto format. diff --git a/googleapis/src/google.cloud.kms.v1.rs b/googleapis/src/google.cloud.kms.v1.rs index 1ccf8d57..717e2ea7 100644 --- a/googleapis/src/google.cloud.kms.v1.rs +++ b/googleapis/src/google.cloud.kms.v1.rs @@ -447,6 +447,7 @@ pub mod crypto_key_version { /// The suffix following `HMAC_` corresponds to the hash algorithm being used /// (eg. SHA256). /// + /// Algorithms beginning with `PQ_` are post-quantum. /// /// For more information, see \[Key purposes and algorithms\] /// (). @@ -651,7 +652,7 @@ pub mod crypto_key_version { /// [ENABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.ENABLED] /// state. Disabled = 2, - /// This version is destroyed, and the key material is no longer stored. + /// The key material of this version is destroyed and no longer stored. /// This version may only become /// [ENABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.ENABLED] /// again if this version is @@ -1458,6 +1459,10 @@ pub struct ListKeyRingsResponse { pub next_page_token: ::prost::alloc::string::String, /// The total number of [KeyRings][google.cloud.kms.v1.KeyRing] that matched /// the query. + /// + /// This field is not populated if + /// [ListKeyRingsRequest.filter][google.cloud.kms.v1.ListKeyRingsRequest.filter] + /// is applied. #[prost(int32, tag = "3")] pub total_size: i32, } @@ -1475,6 +1480,10 @@ pub struct ListCryptoKeysResponse { pub next_page_token: ::prost::alloc::string::String, /// The total number of [CryptoKeys][google.cloud.kms.v1.CryptoKey] that /// matched the query. + /// + /// This field is not populated if + /// [ListCryptoKeysRequest.filter][google.cloud.kms.v1.ListCryptoKeysRequest.filter] + /// is applied. #[prost(int32, tag = "3")] pub total_size: i32, } @@ -1493,6 +1502,10 @@ pub struct ListCryptoKeyVersionsResponse { /// The total number of /// [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion] that matched the /// query. + /// + /// This field is not populated if + /// [ListCryptoKeyVersionsRequest.filter][google.cloud.kms.v1.ListCryptoKeyVersionsRequest.filter] + /// is applied. #[prost(int32, tag = "3")] pub total_size: i32, } @@ -1510,6 +1523,10 @@ pub struct ListImportJobsResponse { pub next_page_token: ::prost::alloc::string::String, /// The total number of [ImportJobs][google.cloud.kms.v1.ImportJob] that /// matched the query. + /// + /// This field is not populated if + /// [ListImportJobsRequest.filter][google.cloud.kms.v1.ListImportJobsRequest.filter] + /// is applied. #[prost(int32, tag = "3")] pub total_size: i32, } @@ -3631,6 +3648,10 @@ pub struct ListEkmConnectionsResponse { pub next_page_token: ::prost::alloc::string::String, /// The total number of [EkmConnections][google.cloud.kms.v1.EkmConnection] /// that matched the query. + /// + /// This field is not populated if + /// [ListEkmConnectionsRequest.filter][google.cloud.kms.v1.ListEkmConnectionsRequest.filter] + /// is applied. #[prost(int32, tag = "3")] pub total_size: i32, } diff --git a/googleapis/src/google.pubsub.v1.rs b/googleapis/src/google.pubsub.v1.rs index c3e992a7..be271b89 100644 --- a/googleapis/src/google.pubsub.v1.rs +++ b/googleapis/src/google.pubsub.v1.rs @@ -1153,7 +1153,7 @@ pub struct IngestionFailureEvent { /// Required. Error details explaining why ingestion to Pub/Sub has failed. #[prost(string, tag = "2")] pub error_message: ::prost::alloc::string::String, - #[prost(oneof = "ingestion_failure_event::Failure", tags = "3, 4, 5, 6")] + #[prost(oneof = "ingestion_failure_event::Failure", tags = "3, 4, 5, 6, 7")] pub failure: ::core::option::Option, } /// Nested message and enum types in `IngestionFailureEvent`. @@ -1172,6 +1172,10 @@ pub mod ingestion_failure_event { /// occurs, one or more Avro objects won't be ingested. #[derive(Clone, Copy, PartialEq, ::prost::Message)] pub struct AvroFailureReason {} + /// Set when a Pub/Sub message fails to get published due to a schema + /// validation violation. + #[derive(Clone, Copy, PartialEq, ::prost::Message)] + pub struct SchemaViolationReason {} /// Failure when ingesting from a Cloud Storage source. #[derive(Clone, PartialEq, ::prost::Message)] pub struct CloudStorageFailure { @@ -1187,7 +1191,7 @@ pub mod ingestion_failure_event { #[prost(int64, tag = "3")] pub object_generation: i64, /// Reason why ingestion failed for the specified object. - #[prost(oneof = "cloud_storage_failure::Reason", tags = "5, 6")] + #[prost(oneof = "cloud_storage_failure::Reason", tags = "5, 6, 7")] pub reason: ::core::option::Option, } /// Nested message and enum types in `CloudStorageFailure`. @@ -1202,6 +1206,9 @@ pub mod ingestion_failure_event { /// being published. #[prost(message, tag = "6")] ApiViolationReason(super::ApiViolationReason), + /// Optional. The Pub/Sub message failed schema validation. + #[prost(message, tag = "7")] + SchemaViolationReason(super::SchemaViolationReason), } } /// Failure when ingesting from an Amazon MSK source. @@ -1221,7 +1228,7 @@ pub mod ingestion_failure_event { #[prost(int64, tag = "4")] pub offset: i64, /// Reason why ingestion failed for the specified message. - #[prost(oneof = "aws_msk_failure_reason::Reason", tags = "5")] + #[prost(oneof = "aws_msk_failure_reason::Reason", tags = "5, 6")] pub reason: ::core::option::Option, } /// Nested message and enum types in `AwsMskFailureReason`. @@ -1233,6 +1240,9 @@ pub mod ingestion_failure_event { /// being published. #[prost(message, tag = "5")] ApiViolationReason(super::ApiViolationReason), + /// Optional. The Pub/Sub message failed schema validation. + #[prost(message, tag = "6")] + SchemaViolationReason(super::SchemaViolationReason), } } /// Failure when ingesting from an Azure Event Hubs source. @@ -1252,7 +1262,7 @@ pub mod ingestion_failure_event { #[prost(int64, tag = "4")] pub offset: i64, /// Reason why ingestion failed for the specified message. - #[prost(oneof = "azure_event_hubs_failure_reason::Reason", tags = "5")] + #[prost(oneof = "azure_event_hubs_failure_reason::Reason", tags = "5, 6")] pub reason: ::core::option::Option, } /// Nested message and enum types in `AzureEventHubsFailureReason`. @@ -1264,6 +1274,9 @@ pub mod ingestion_failure_event { /// being published. #[prost(message, tag = "5")] ApiViolationReason(super::ApiViolationReason), + /// Optional. The Pub/Sub message failed schema validation. + #[prost(message, tag = "6")] + SchemaViolationReason(super::SchemaViolationReason), } } /// Failure when ingesting from a Confluent Cloud source. @@ -1283,7 +1296,7 @@ pub mod ingestion_failure_event { #[prost(int64, tag = "4")] pub offset: i64, /// Reason why ingestion failed for the specified message. - #[prost(oneof = "confluent_cloud_failure_reason::Reason", tags = "5")] + #[prost(oneof = "confluent_cloud_failure_reason::Reason", tags = "5, 6")] pub reason: ::core::option::Option, } /// Nested message and enum types in `ConfluentCloudFailureReason`. @@ -1295,6 +1308,35 @@ pub mod ingestion_failure_event { /// being published. #[prost(message, tag = "5")] ApiViolationReason(super::ApiViolationReason), + /// Optional. The Pub/Sub message failed schema validation. + #[prost(message, tag = "6")] + SchemaViolationReason(super::SchemaViolationReason), + } + } + /// Failure when ingesting from an AWS Kinesis source. + #[derive(Clone, PartialEq, ::prost::Message)] + pub struct AwsKinesisFailureReason { + /// Optional. The stream ARN of the Kinesis stream being ingested from. + #[prost(string, tag = "1")] + pub stream_arn: ::prost::alloc::string::String, + /// Optional. The partition key of the message that failed to be ingested. + #[prost(string, tag = "2")] + pub partition_key: ::prost::alloc::string::String, + /// Optional. The sequence number of the message that failed to be ingested. + #[prost(string, tag = "3")] + pub sequence_number: ::prost::alloc::string::String, + /// Reason why ingestion failed for the specified message. + #[prost(oneof = "aws_kinesis_failure_reason::Reason", tags = "4")] + pub reason: ::core::option::Option, + } + /// Nested message and enum types in `AwsKinesisFailureReason`. + pub mod aws_kinesis_failure_reason { + /// Reason why ingestion failed for the specified message. + #[derive(Clone, Copy, PartialEq, ::prost::Oneof)] + pub enum Reason { + /// Optional. The Pub/Sub message failed schema validation. + #[prost(message, tag = "4")] + SchemaViolationReason(super::SchemaViolationReason), } } #[derive(Clone, PartialEq, ::prost::Oneof)] @@ -1311,6 +1353,9 @@ pub mod ingestion_failure_event { /// Optional. Failure when ingesting from Confluent Cloud. #[prost(message, tag = "6")] ConfluentCloudFailure(ConfluentCloudFailureReason), + /// Optional. Failure when ingesting from AWS Kinesis. + #[prost(message, tag = "7")] + AwsKinesisFailure(AwsKinesisFailureReason), } } /// User-defined JavaScript function that can transform or filter a Pub/Sub @@ -1769,8 +1814,8 @@ pub struct Subscription { /// /// If not set, the default retry policy is applied. This generally implies /// that messages will be retried as soon as possible for healthy subscribers. - /// RetryPolicy will be triggered on NACKs or acknowledgement deadline - /// exceeded events for a given message. + /// RetryPolicy will be triggered on NACKs or acknowledgment deadline exceeded + /// events for a given message. #[prost(message, optional, tag = "14")] pub retry_policy: ::core::option::Option, /// Optional. Indicates whether the subscription is detached from its topic. @@ -1785,7 +1830,7 @@ pub struct Subscription { /// subscription: /// /// * The message sent to a subscriber is guaranteed not to be resent - /// before the message's acknowledgement deadline expires. + /// before the message's acknowledgment deadline expires. /// * An acknowledged message will not be resent to a subscriber. /// /// Note that subscribers may still receive multiple copies of a message @@ -1873,7 +1918,7 @@ pub mod subscription { /// Retry delay will be exponential based on provided minimum and maximum /// backoffs. /// -/// RetryPolicy will be triggered on NACKs or acknowledgement deadline exceeded +/// RetryPolicy will be triggered on NACKs or acknowledgment deadline exceeded /// events for a given message. /// /// Retry Policy is implemented on a best effort basis. At times, the delay @@ -1913,7 +1958,7 @@ pub struct DeadLetterPolicy { /// value must be between 5 and 100. /// /// The number of delivery attempts is defined as 1 + (the sum of number of - /// NACKs and number of times the acknowledgement deadline has been exceeded + /// NACKs and number of times the acknowledgment deadline has been exceeded /// for the message). /// /// A NACK is any call to ModifyAckDeadline with a 0 deadline. Note that @@ -2168,7 +2213,7 @@ pub struct CloudStorageConfig { pub filename_datetime_format: ::prost::alloc::string::String, /// Optional. The maximum duration that can elapse before a new Cloud Storage /// file is created. Min 1 minute, max 10 minutes, default 5 minutes. May not - /// exceed the subscription's acknowledgement deadline. + /// exceed the subscription's acknowledgment deadline. #[prost(message, optional, tag = "6")] pub max_duration: ::core::option::Option<::prost_types::Duration>, /// Optional. The maximum bytes that can be written to a Cloud Storage file @@ -2450,7 +2495,7 @@ pub struct AcknowledgeRequest { pub ack_ids: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, } /// Request for the `StreamingPull` streaming RPC method. This request is used to -/// establish the initial stream as well as to stream acknowledgements and ack +/// establish the initial stream as well as to stream acknowledgments and ack /// deadline modifications from the client to the server. #[derive(Clone, PartialEq, ::prost::Message)] pub struct StreamingPullRequest { @@ -2460,12 +2505,11 @@ pub struct StreamingPullRequest { /// Format is `projects/{project}/subscriptions/{sub}`. #[prost(string, tag = "1")] pub subscription: ::prost::alloc::string::String, - /// Optional. List of acknowledgement IDs for acknowledging previously received + /// Optional. List of acknowledgment IDs for acknowledging previously received /// messages (received on this stream or a different stream). If an ack ID has /// expired, the corresponding message may be redelivered later. Acknowledging - /// a message more than once will not result in an error. If the - /// acknowledgement ID is malformed, the stream will be aborted with status - /// `INVALID_ARGUMENT`. + /// a message more than once will not result in an error. If the acknowledgment + /// ID is malformed, the stream will be aborted with status `INVALID_ARGUMENT`. #[prost(string, repeated, tag = "2")] pub ack_ids: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, /// Optional. The list of new ack deadlines for the IDs listed in @@ -2481,7 +2525,7 @@ pub struct StreamingPullRequest { /// be aborted with status `INVALID_ARGUMENT`. #[prost(int32, repeated, packed = "false", tag = "3")] pub modify_deadline_seconds: ::prost::alloc::vec::Vec, - /// Optional. List of acknowledgement IDs whose deadline will be modified based + /// Optional. List of acknowledgment IDs whose deadline will be modified based /// on the corresponding element in `modify_deadline_seconds`. This field can /// be used to indicate that more time is needed to process a message by the /// subscriber, or to make the message available for redelivery if the @@ -2547,37 +2591,37 @@ pub struct StreamingPullResponse { } /// Nested message and enum types in `StreamingPullResponse`. pub mod streaming_pull_response { - /// Acknowledgement IDs sent in one or more previous requests to acknowledge a + /// Acknowledgment IDs sent in one or more previous requests to acknowledge a /// previously received message. #[derive(Clone, PartialEq, ::prost::Message)] pub struct AcknowledgeConfirmation { - /// Optional. Successfully processed acknowledgement IDs. + /// Optional. Successfully processed acknowledgment IDs. #[prost(string, repeated, tag = "1")] pub ack_ids: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, - /// Optional. List of acknowledgement IDs that were malformed or whose - /// acknowledgement deadline has expired. + /// Optional. List of acknowledgment IDs that were malformed or whose + /// acknowledgment deadline has expired. #[prost(string, repeated, tag = "2")] pub invalid_ack_ids: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, - /// Optional. List of acknowledgement IDs that were out of order. + /// Optional. List of acknowledgment IDs that were out of order. #[prost(string, repeated, tag = "3")] pub unordered_ack_ids: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, - /// Optional. List of acknowledgement IDs that failed processing with + /// Optional. List of acknowledgment IDs that failed processing with /// temporary issues. #[prost(string, repeated, tag = "4")] pub temporary_failed_ack_ids: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, } - /// Acknowledgement IDs sent in one or more previous requests to modify the + /// Acknowledgment IDs sent in one or more previous requests to modify the /// deadline for a specific message. #[derive(Clone, PartialEq, ::prost::Message)] pub struct ModifyAckDeadlineConfirmation { - /// Optional. Successfully processed acknowledgement IDs. + /// Optional. Successfully processed acknowledgment IDs. #[prost(string, repeated, tag = "1")] pub ack_ids: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, - /// Optional. List of acknowledgement IDs that were malformed or whose - /// acknowledgement deadline has expired. + /// Optional. List of acknowledgment IDs that were malformed or whose + /// acknowledgment deadline has expired. #[prost(string, repeated, tag = "2")] pub invalid_ack_ids: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, - /// Optional. List of acknowledgement IDs that failed processing with + /// Optional. List of acknowledgment IDs that failed processing with /// temporary issues. #[prost(string, repeated, tag = "3")] pub temporary_failed_ack_ids: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, @@ -3233,7 +3277,7 @@ pub mod subscriber_client { self.inner.unary(req, path, codec).await } /// Establishes a stream with the server, which sends messages down to the - /// client. The client streams acknowledgements and ack deadline modifications + /// client. The client streams acknowledgments and ack deadline modifications /// back to the server. The server will close the stream and return the status /// on any error. The server may close the stream with status `UNAVAILABLE` to /// reassign server-side resources, in which case, the client should diff --git a/googleapis/src/google.spanner.admin.database.v1.rs b/googleapis/src/google.spanner.admin.database.v1.rs index 808759bd..1a2909d3 100644 --- a/googleapis/src/google.spanner.admin.database.v1.rs +++ b/googleapis/src/google.spanner.admin.database.v1.rs @@ -1391,6 +1391,11 @@ pub struct UpdateDatabaseDdlRequest { /// description](). #[prost(bytes = "vec", tag = "4")] pub proto_descriptors: ::prost::alloc::vec::Vec, + /// Optional. This field is exposed to be used by the Spanner Migration Tool. + /// For more details, see + /// [SMT](). + #[prost(bool, tag = "5")] + pub throughput_mode: bool, } /// Action information extracted from a DDL statement. This proto is used to /// display the brief info of the DDL statement for the operation diff --git a/googleapis/src/google.storage.v2.rs b/googleapis/src/google.storage.v2.rs index 6b4fd9eb..adc8d4b2 100644 --- a/googleapis/src/google.storage.v2.rs +++ b/googleapis/src/google.storage.v2.rs @@ -36,10 +36,12 @@ pub struct GetBucketRequest { /// Request message for CreateBucket. #[derive(Clone, PartialEq, ::prost::Message)] pub struct CreateBucketRequest { - /// Required. The project to which this bucket will belong. + /// Required. The project to which this bucket will belong. This field must + /// either be empty or `projects/_`. The project ID that owns this bucket + /// should be specified in the `bucket.project` field. #[prost(string, tag = "1")] pub parent: ::prost::alloc::string::String, - /// Properties of the new bucket being inserted. + /// Optional. Properties of the new bucket being inserted. /// The name of the bucket is specified in the `bucket_id` field. Populating /// `bucket.name` field will result in an error. /// The project of the bucket must be specified in the `bucket.project` field. @@ -53,13 +55,13 @@ pub struct CreateBucketRequest { /// result in a bucket with the name `projects/123456/buckets/foo`. #[prost(string, tag = "3")] pub bucket_id: ::prost::alloc::string::String, - /// Apply a predefined set of access controls to this bucket. + /// Optional. Apply a predefined set of access controls to this bucket. /// Valid values are "authenticatedRead", "private", "projectPrivate", /// "publicRead", or "publicReadWrite". #[prost(string, tag = "6")] pub predefined_acl: ::prost::alloc::string::String, - /// Apply a predefined set of default object access controls to this bucket. - /// Valid values are "authenticatedRead", "bucketOwnerFullControl", + /// Optional. Apply a predefined set of default object access controls to this + /// bucket. Valid values are "authenticatedRead", "bucketOwnerFullControl", /// "bucketOwnerRead", "private", "projectPrivate", or "publicRead". #[prost(string, tag = "7")] pub predefined_default_object_acl: ::prost::alloc::string::String, @@ -70,17 +72,17 @@ pub struct ListBucketsRequest { /// Required. The project whose buckets we are listing. #[prost(string, tag = "1")] pub parent: ::prost::alloc::string::String, - /// Maximum number of buckets to return in a single response. The service will - /// use this parameter or 1,000 items, whichever is smaller. If "acl" is - /// present in the read_mask, the service will use this parameter of 200 items, - /// whichever is smaller. + /// Optional. Maximum number of buckets to return in a single response. The + /// service will use this parameter or 1,000 items, whichever is smaller. If + /// "acl" is present in the read_mask, the service will use this parameter of + /// 200 items, whichever is smaller. #[prost(int32, tag = "2")] pub page_size: i32, - /// A previously-returned page token representing part of the larger set of - /// results to view. + /// Optional. A previously-returned page token representing part of the larger + /// set of results to view. #[prost(string, tag = "3")] pub page_token: ::prost::alloc::string::String, - /// Filter results to buckets whose names begin with this prefix. + /// Optional. Filter results to buckets whose names begin with this prefix. #[prost(string, tag = "4")] pub prefix: ::prost::alloc::string::String, /// Mask specifying which fields to read from each result. @@ -127,13 +129,13 @@ pub struct UpdateBucketRequest { /// this value. #[prost(int64, optional, tag = "3")] pub if_metageneration_not_match: ::core::option::Option, - /// Apply a predefined set of access controls to this bucket. + /// Optional. Apply a predefined set of access controls to this bucket. /// Valid values are "authenticatedRead", "private", "projectPrivate", /// "publicRead", or "publicReadWrite". #[prost(string, tag = "8")] pub predefined_acl: ::prost::alloc::string::String, - /// Apply a predefined set of default object access controls to this bucket. - /// Valid values are "authenticatedRead", "bucketOwnerFullControl", + /// Optional. Apply a predefined set of default object access controls to this + /// bucket. Valid values are "authenticatedRead", "bucketOwnerFullControl", /// "bucketOwnerRead", "private", "projectPrivate", or "publicRead". #[prost(string, tag = "9")] pub predefined_default_object_acl: ::prost::alloc::string::String, @@ -154,11 +156,12 @@ pub struct ComposeObjectRequest { /// Required. Properties of the resulting object. #[prost(message, optional, tag = "1")] pub destination: ::core::option::Option, - /// The list of source objects that will be concatenated into a single object. + /// Optional. The list of source objects that will be concatenated into a + /// single object. #[prost(message, repeated, tag = "2")] pub source_objects: ::prost::alloc::vec::Vec, - /// Apply a predefined set of access controls to the destination object. - /// Valid values are "authenticatedRead", "bucketOwnerFullControl", + /// Optional. Apply a predefined set of access controls to the destination + /// object. Valid values are "authenticatedRead", "bucketOwnerFullControl", /// "bucketOwnerRead", "private", "projectPrivate", or "publicRead". #[prost(string, tag = "9")] pub destination_predefined_acl: ::prost::alloc::string::String, @@ -171,17 +174,18 @@ pub struct ComposeObjectRequest { /// metageneration matches the given value. #[prost(int64, optional, tag = "5")] pub if_metageneration_match: ::core::option::Option, - /// Resource name of the Cloud KMS key, of the form + /// Optional. Resource name of the Cloud KMS key, of the form /// `projects/my-project/locations/my-location/keyRings/my-kr/cryptoKeys/my-key`, /// that will be used to encrypt the object. Overrides the object /// metadata's `kms_key_name` value, if any. #[prost(string, tag = "6")] pub kms_key: ::prost::alloc::string::String, - /// A set of parameters common to Storage API requests concerning an object. + /// Optional. A set of parameters common to Storage API requests concerning an + /// object. #[prost(message, optional, tag = "7")] pub common_object_request_params: ::core::option::Option, - /// The checksums of the complete object. This will be validated against the - /// combined checksums of the component objects. + /// Optional. The checksums of the complete object. This will be validated + /// against the combined checksums of the component objects. #[prost(message, optional, tag = "10")] pub object_checksums: ::core::option::Option, } @@ -194,10 +198,10 @@ pub mod compose_object_request { /// same bucket. #[prost(string, tag = "1")] pub name: ::prost::alloc::string::String, - /// The generation of this object to use as the source. + /// Optional. The generation of this object to use as the source. #[prost(int64, tag = "2")] pub generation: i64, - /// Conditions that must be met for this operation to execute. + /// Optional. Conditions that must be met for this operation to execute. #[prost(message, optional, tag = "3")] pub object_preconditions: ::core::option::Option, } @@ -226,8 +230,8 @@ pub struct DeleteObjectRequest { /// `CancelResumableWrite`. #[prost(string, tag = "2")] pub object: ::prost::alloc::string::String, - /// If present, permanently deletes a specific revision of this object (as - /// opposed to the latest version, the default). + /// Optional. If present, permanently deletes a specific revision of this + /// object (as opposed to the latest version, the default). #[prost(int64, tag = "4")] pub generation: i64, /// Makes the operation conditional on whether the object's current generation @@ -249,7 +253,8 @@ pub struct DeleteObjectRequest { /// metageneration does not match the given value. #[prost(int64, optional, tag = "8")] pub if_metageneration_not_match: ::core::option::Option, - /// A set of parameters common to Storage API requests concerning an object. + /// Optional. A set of parameters common to Storage API requests concerning an + /// object. #[prost(message, optional, tag = "10")] pub common_object_request_params: ::core::option::Option, } @@ -297,7 +302,8 @@ pub struct RestoreObjectRequest { /// Return an error if bucket has UBLA enabled. #[prost(bool, optional, tag = "9")] pub copy_source_acl: ::core::option::Option, - /// A set of parameters common to Storage API requests concerning an object. + /// Optional. A set of parameters common to Storage API requests concerning an + /// object. #[prost(message, optional, tag = "8")] pub common_object_request_params: ::core::option::Option, } @@ -323,12 +329,12 @@ pub struct ReadObjectRequest { /// Required. The name of the object to read. #[prost(string, tag = "2")] pub object: ::prost::alloc::string::String, - /// If present, selects a specific revision of this object (as opposed - /// to the latest version, the default). + /// Optional. If present, selects a specific revision of this object (as + /// opposed to the latest version, the default). #[prost(int64, tag = "3")] pub generation: i64, - /// The offset for the first byte to return in the read, relative to the start - /// of the object. + /// Optional. The offset for the first byte to return in the read, relative to + /// the start of the object. /// /// A negative `read_offset` value will be interpreted as the number of bytes /// back from the end of the object to be returned. For example, if an object's @@ -338,9 +344,10 @@ pub struct ReadObjectRequest { /// return the entire object. #[prost(int64, tag = "4")] pub read_offset: i64, - /// The maximum number of `data` bytes the server is allowed to return in the - /// sum of all `Object` messages. A `read_limit` of zero indicates that there - /// is no limit, and a negative `read_limit` will cause an error. + /// Optional. The maximum number of `data` bytes the server is allowed to + /// return in the sum of all `Object` messages. A `read_limit` of zero + /// indicates that there is no limit, and a negative `read_limit` will cause an + /// error. /// /// If the stream returns fewer bytes than allowed by the `read_limit` and no /// error occurred, the stream includes all data from the `read_offset` to the @@ -366,7 +373,8 @@ pub struct ReadObjectRequest { /// metageneration does not match the given value. #[prost(int64, optional, tag = "9")] pub if_metageneration_not_match: ::core::option::Option, - /// A set of parameters common to Storage API requests concerning an object. + /// Optional. A set of parameters common to Storage API requests concerning an + /// object. #[prost(message, optional, tag = "10")] pub common_object_request_params: ::core::option::Option, /// Mask specifying which fields to read. @@ -386,8 +394,8 @@ pub struct GetObjectRequest { /// Required. Name of the object. #[prost(string, tag = "2")] pub object: ::prost::alloc::string::String, - /// If present, selects a specific revision of this object (as opposed to the - /// latest version, the default). + /// Optional. If present, selects a specific revision of this object (as + /// opposed to the latest version, the default). #[prost(int64, tag = "3")] pub generation: i64, /// If true, return the soft-deleted version of this object. @@ -412,7 +420,8 @@ pub struct GetObjectRequest { /// metageneration does not match the given value. #[prost(int64, optional, tag = "7")] pub if_metageneration_not_match: ::core::option::Option, - /// A set of parameters common to Storage API requests concerning an object. + /// Optional. A set of parameters common to Storage API requests concerning an + /// object. #[prost(message, optional, tag = "8")] pub common_object_request_params: ::core::option::Option, /// Mask specifying which fields to read. @@ -462,8 +471,8 @@ pub struct BidiReadObjectSpec { /// Required. The name of the object to read. #[prost(string, tag = "2")] pub object: ::prost::alloc::string::String, - /// If present, selects a specific revision of this object (as opposed - /// to the latest version, the default). + /// Optional. If present, selects a specific revision of this object (as + /// opposed to the latest version, the default). #[prost(int64, tag = "3")] pub generation: i64, /// Makes the operation conditional on whether the object's current generation @@ -485,7 +494,8 @@ pub struct BidiReadObjectSpec { /// metageneration does not match the given value. #[prost(int64, optional, tag = "7")] pub if_metageneration_not_match: ::core::option::Option, - /// A set of parameters common to Storage API requests concerning an object. + /// Optional. A set of parameters common to Storage API requests concerning an + /// object. #[prost(message, optional, tag = "8")] pub common_object_request_params: ::core::option::Option, /// Mask specifying which fields to read. @@ -512,16 +522,17 @@ pub struct BidiReadObjectSpec { /// Request message for BidiReadObject. #[derive(Clone, PartialEq, ::prost::Message)] pub struct BidiReadObjectRequest { - /// The first message of each stream should set this field. If this is not - /// the first message, an error will be returned. Describes the object to read. + /// Optional. The first message of each stream should set this field. If this + /// is not the first message, an error will be returned. Describes the object + /// to read. #[prost(message, optional, tag = "1")] pub read_object_spec: ::core::option::Option, - /// Provides a list of 0 or more (up to 100) ranges to read. If a single range - /// is large enough to require multiple responses, they are guaranteed to be - /// delivered in increasing offset order. There are no ordering guarantees - /// across ranges. When no ranges are provided, the response message will not - /// include ObjectRangeData. For full object downloads, the offset and size can - /// be set to 0. + /// Optional. Provides a list of 0 or more (up to 100) ranges to read. If a + /// single range is large enough to require multiple responses, they are + /// guaranteed to be delivered in increasing offset order. There are no + /// ordering guarantees across ranges. When no ranges are provided, the + /// response message will not include ObjectRangeData. For full object + /// downloads, the offset and size can be set to 0. #[prost(message, repeated, tag = "8")] pub read_ranges: ::prost::alloc::vec::Vec, } @@ -667,7 +678,7 @@ pub struct WriteObjectSpec { /// Required. Destination object, including its name and its metadata. #[prost(message, optional, tag = "1")] pub resource: ::core::option::Option, - /// Apply a predefined set of access controls to this object. + /// Optional. Apply a predefined set of access controls to this object. /// Valid values are "authenticatedRead", "bucketOwnerFullControl", /// "bucketOwnerRead", "private", "projectPrivate", or "publicRead". #[prost(string, tag = "7")] @@ -723,13 +734,13 @@ pub struct WriteObjectRequest { /// An incorrect value will cause an error. #[prost(int64, tag = "3")] pub write_offset: i64, - /// Checksums for the complete object. If the checksums computed by the service - /// don't match the specified checksums the call will fail. May only be - /// provided in the first or last request (either with first_message, or - /// finish_write set). + /// Optional. Checksums for the complete object. If the checksums computed by + /// the service don't match the specified checksums the call will fail. May + /// only be provided in the first or last request (either with first_message, + /// or finish_write set). #[prost(message, optional, tag = "6")] pub object_checksums: ::core::option::Option, - /// If `true`, this indicates that the write is complete. Sending any + /// Optional. If `true`, this indicates that the write is complete. Sending any /// `WriteObjectRequest`s subsequent to one in which `finish_write` is `true` /// will cause an error. /// For a non-resumable write (where the upload_id was not set in the first @@ -737,7 +748,8 @@ pub struct WriteObjectRequest { /// stream. #[prost(bool, tag = "7")] pub finish_write: bool, - /// A set of parameters common to Storage API requests concerning an object. + /// Optional. A set of parameters common to Storage API requests concerning an + /// object. #[prost(message, optional, tag = "8")] pub common_object_request_params: ::core::option::Option, /// The first message of each stream should set one of the following. @@ -839,31 +851,31 @@ pub struct BidiWriteObjectRequest { /// An invalid value will cause an error. #[prost(int64, tag = "3")] pub write_offset: i64, - /// Checksums for the complete object. If the checksums computed by the service - /// don't match the specified checksums the call will fail. May only be - /// provided in the first request or the - /// last request (with finish_write set). + /// Optional. Checksums for the complete object. If the checksums computed by + /// the service don't match the specified checksums the call will fail. May + /// only be provided in the first request or the last request (with + /// finish_write set). #[prost(message, optional, tag = "6")] pub object_checksums: ::core::option::Option, - /// For each BidiWriteObjectRequest where state_lookup is `true` or the client - /// closes the stream, the service will send a BidiWriteObjectResponse - /// containing the current persisted size. The persisted size sent in responses - /// covers all the bytes the server has persisted thus far and can be used to - /// decide what data is safe for the client to drop. Note that the object's - /// current size reported by the BidiWriteObjectResponse may lag behind the - /// number of bytes written by the client. This field is ignored if - /// `finish_write` is set to true. + /// Optional. For each BidiWriteObjectRequest where state_lookup is `true` or + /// the client closes the stream, the service will send a + /// BidiWriteObjectResponse containing the current persisted size. The + /// persisted size sent in responses covers all the bytes the server has + /// persisted thus far and can be used to decide what data is safe for the + /// client to drop. Note that the object's current size reported by the + /// BidiWriteObjectResponse may lag behind the number of bytes written by the + /// client. This field is ignored if `finish_write` is set to true. #[prost(bool, tag = "7")] pub state_lookup: bool, - /// Persists data written on the stream, up to and including the current - /// message, to permanent storage. This option should be used sparingly as it - /// may reduce performance. Ongoing writes will periodically be persisted on - /// the server even when `flush` is not set. This field is ignored if + /// Optional. Persists data written on the stream, up to and including the + /// current message, to permanent storage. This option should be used sparingly + /// as it may reduce performance. Ongoing writes will periodically be persisted + /// on the server even when `flush` is not set. This field is ignored if /// `finish_write` is set to true since there's no need to checkpoint or flush /// if this message completes the write. #[prost(bool, tag = "8")] pub flush: bool, - /// If `true`, this indicates that the write is complete. Sending any + /// Optional. If `true`, this indicates that the write is complete. Sending any /// `WriteObjectRequest`s subsequent to one in which `finish_write` is `true` /// will cause an error. /// For a non-resumable write (where the upload_id was not set in the first @@ -871,7 +883,8 @@ pub struct BidiWriteObjectRequest { /// stream. #[prost(bool, tag = "9")] pub finish_write: bool, - /// A set of parameters common to Storage API requests concerning an object. + /// Optional. A set of parameters common to Storage API requests concerning an + /// object. #[prost(message, optional, tag = "10")] pub common_object_request_params: ::core::option::Option, /// The first message of each stream should set one of the following. @@ -940,33 +953,32 @@ pub struct ListObjectsRequest { /// Required. Name of the bucket in which to look for objects. #[prost(string, tag = "1")] pub parent: ::prost::alloc::string::String, - /// Maximum number of `items` plus `prefixes` to return + /// Optional. Maximum number of `items` plus `prefixes` to return /// in a single page of responses. As duplicate `prefixes` are /// omitted, fewer total results may be returned than requested. The service /// will use this parameter or 1,000 items, whichever is smaller. #[prost(int32, tag = "2")] pub page_size: i32, - /// A previously-returned page token representing part of the larger set of - /// results to view. + /// Optional. A previously-returned page token representing part of the larger + /// set of results to view. #[prost(string, tag = "3")] pub page_token: ::prost::alloc::string::String, - /// If set, returns results in a directory-like mode. `items` will contain - /// only objects whose names, aside from the `prefix`, do not - /// contain `delimiter`. Objects whose names, aside from the - /// `prefix`, contain `delimiter` will have their name, - /// truncated after the `delimiter`, returned in - /// `prefixes`. Duplicate `prefixes` are omitted. + /// Optional. If set, returns results in a directory-like mode. `items` will + /// contain only objects whose names, aside from the `prefix`, do not contain + /// `delimiter`. Objects whose names, aside from the `prefix`, contain + /// `delimiter` will have their name, truncated after the `delimiter`, returned + /// in `prefixes`. Duplicate `prefixes` are omitted. #[prost(string, tag = "4")] pub delimiter: ::prost::alloc::string::String, - /// If true, objects that end in exactly one instance of `delimiter` + /// Optional. If true, objects that end in exactly one instance of `delimiter` /// will have their metadata included in `items` in addition to /// `prefixes`. #[prost(bool, tag = "5")] pub include_trailing_delimiter: bool, - /// Filter results to objects whose names begin with this prefix. + /// Optional. Filter results to objects whose names begin with this prefix. #[prost(string, tag = "6")] pub prefix: ::prost::alloc::string::String, - /// If `true`, lists all versions of an object as distinct results. + /// Optional. If `true`, lists all versions of an object as distinct results. /// For more information, see /// [Object /// Versioning](). @@ -1012,7 +1024,8 @@ pub struct QueryWriteStatusRequest { /// being requested. #[prost(string, tag = "1")] pub upload_id: ::prost::alloc::string::String, - /// A set of parameters common to Storage API requests concerning an object. + /// Optional. A set of parameters common to Storage API requests concerning an + /// object. #[prost(message, optional, tag = "2")] pub common_object_request_params: ::core::option::Option, } @@ -1063,14 +1076,14 @@ pub struct RewriteObjectRequest { /// object. #[prost(string, tag = "25")] pub destination_bucket: ::prost::alloc::string::String, - /// The name of the Cloud KMS key that will be used to encrypt the destination - /// object. The Cloud KMS key must be located in same location as the object. - /// If the parameter is not specified, the request uses the destination - /// bucket's default encryption key, if any, or else the Google-managed - /// encryption key. + /// Optional. The name of the Cloud KMS key that will be used to encrypt the + /// destination object. The Cloud KMS key must be located in same location as + /// the object. If the parameter is not specified, the request uses the + /// destination bucket's default encryption key, if any, or else the + /// Google-managed encryption key. #[prost(string, tag = "27")] pub destination_kms_key: ::prost::alloc::string::String, - /// Properties of the destination, post-rewrite object. + /// Optional. Properties of the destination, post-rewrite object. /// The `name`, `bucket` and `kms_key` fields must not be populated (these /// values are specified in the `destination_name`, `destination_bucket`, and /// `destination_kms_key` fields). @@ -1085,19 +1098,19 @@ pub struct RewriteObjectRequest { /// Required. Name of the source object. #[prost(string, tag = "3")] pub source_object: ::prost::alloc::string::String, - /// If present, selects a specific revision of the source object (as opposed to - /// the latest version, the default). + /// Optional. If present, selects a specific revision of the source object (as + /// opposed to the latest version, the default). #[prost(int64, tag = "4")] pub source_generation: i64, - /// Include this field (from the previous rewrite response) on each rewrite - /// request after the first one, until the rewrite response 'done' flag is - /// true. Calls that provide a rewriteToken can omit all other request fields, - /// but if included those fields must match the values provided in the first - /// rewrite request. + /// Optional. Include this field (from the previous rewrite response) on each + /// rewrite request after the first one, until the rewrite response 'done' flag + /// is true. Calls that provide a rewriteToken can omit all other request + /// fields, but if included those fields must match the values provided in the + /// first rewrite request. #[prost(string, tag = "5")] pub rewrite_token: ::prost::alloc::string::String, - /// Apply a predefined set of access controls to the destination object. - /// Valid values are "authenticatedRead", "bucketOwnerFullControl", + /// Optional. Apply a predefined set of access controls to the destination + /// object. Valid values are "authenticatedRead", "bucketOwnerFullControl", /// "bucketOwnerRead", "private", "projectPrivate", or "publicRead". #[prost(string, tag = "28")] pub destination_predefined_acl: ::prost::alloc::string::String, @@ -1136,35 +1149,35 @@ pub struct RewriteObjectRequest { /// metageneration does not match the given value. #[prost(int64, optional, tag = "14")] pub if_source_metageneration_not_match: ::core::option::Option, - /// The maximum number of bytes that will be rewritten per rewrite request. - /// Most callers - /// shouldn't need to specify this parameter - it is primarily in place to - /// support testing. If specified the value must be an integral multiple of - /// 1 MiB (1048576). Also, this only applies to requests where the source and - /// destination span locations and/or storage classes. Finally, this value must - /// not change across rewrite calls else you'll get an error that the - /// `rewriteToken` is invalid. + /// Optional. The maximum number of bytes that will be rewritten per rewrite + /// request. Most callers shouldn't need to specify this parameter - it is + /// primarily in place to support testing. If specified the value must be an + /// integral multiple of 1 MiB (1048576). Also, this only applies to requests + /// where the source and destination span locations and/or storage classes. + /// Finally, this value must not change across rewrite calls else you'll get an + /// error that the `rewriteToken` is invalid. #[prost(int64, tag = "15")] pub max_bytes_rewritten_per_call: i64, - /// The algorithm used to encrypt the source object, if any. Used if the source - /// object was encrypted with a Customer-Supplied Encryption Key. + /// Optional. The algorithm used to encrypt the source object, if any. Used if + /// the source object was encrypted with a Customer-Supplied Encryption Key. #[prost(string, tag = "16")] pub copy_source_encryption_algorithm: ::prost::alloc::string::String, - /// The raw bytes (not base64-encoded) AES-256 encryption key used to encrypt - /// the source object, if it was encrypted with a Customer-Supplied Encryption - /// Key. + /// Optional. The raw bytes (not base64-encoded) AES-256 encryption key used to + /// encrypt the source object, if it was encrypted with a Customer-Supplied + /// Encryption Key. #[prost(bytes = "vec", tag = "21")] pub copy_source_encryption_key_bytes: ::prost::alloc::vec::Vec, - /// The raw bytes (not base64-encoded) SHA256 hash of the encryption key used - /// to encrypt the source object, if it was encrypted with a Customer-Supplied - /// Encryption Key. + /// Optional. The raw bytes (not base64-encoded) SHA256 hash of the encryption + /// key used to encrypt the source object, if it was encrypted with a + /// Customer-Supplied Encryption Key. #[prost(bytes = "vec", tag = "22")] pub copy_source_encryption_key_sha256_bytes: ::prost::alloc::vec::Vec, - /// A set of parameters common to Storage API requests concerning an object. + /// Optional. A set of parameters common to Storage API requests concerning an + /// object. #[prost(message, optional, tag = "19")] pub common_object_request_params: ::core::option::Option, - /// The checksums of the complete object. This will be used to validate the - /// destination object after rewriting. + /// Optional. The checksums of the complete object. This will be used to + /// validate the destination object after rewriting. #[prost(message, optional, tag = "29")] pub object_checksums: ::core::option::Option, } @@ -1267,12 +1280,13 @@ pub struct StartResumableWriteRequest { /// Required. Contains the information necessary to start a resumable write. #[prost(message, optional, tag = "1")] pub write_object_spec: ::core::option::Option, - /// A set of parameters common to Storage API requests related to an object. + /// Optional. A set of parameters common to Storage API requests related to an + /// object. #[prost(message, optional, tag = "3")] pub common_object_request_params: ::core::option::Option, - /// The checksums of the complete object. This is used to validate the - /// uploaded object. For each upload, `object_checksums` can be provided when - /// initiating a resumable upload with`StartResumableWriteRequest` or when + /// Optional. The checksums of the complete object. This is used to validate + /// the uploaded object. For each upload, `object_checksums` can be provided + /// when initiating a resumable upload with`StartResumableWriteRequest` or when /// completing a write with `WriteObjectRequest` with /// `finish_write` set to `true`. #[prost(message, optional, tag = "5")] @@ -1318,7 +1332,7 @@ pub struct UpdateObjectRequest { /// metageneration does not match the given value. #[prost(int64, optional, tag = "5")] pub if_metageneration_not_match: ::core::option::Option, - /// Apply a predefined set of access controls to this object. + /// Optional. Apply a predefined set of access controls to this object. /// Valid values are "authenticatedRead", "bucketOwnerFullControl", /// "bucketOwnerRead", "private", "projectPrivate", or "publicRead". #[prost(string, tag = "10")] @@ -1333,23 +1347,24 @@ pub struct UpdateObjectRequest { /// Not specifying any fields is an error. #[prost(message, optional, tag = "7")] pub update_mask: ::core::option::Option<::prost_types::FieldMask>, - /// A set of parameters common to Storage API requests concerning an object. + /// Optional. A set of parameters common to Storage API requests concerning an + /// object. #[prost(message, optional, tag = "8")] pub common_object_request_params: ::core::option::Option, } /// Parameters that can be passed to any object request. #[derive(Clone, PartialEq, ::prost::Message)] pub struct CommonObjectRequestParams { - /// Encryption algorithm used with the Customer-Supplied Encryption Keys - /// feature. + /// Optional. Encryption algorithm used with the Customer-Supplied Encryption + /// Keys feature. #[prost(string, tag = "1")] pub encryption_algorithm: ::prost::alloc::string::String, - /// Encryption key used with the Customer-Supplied Encryption Keys feature. - /// In raw bytes format (not base64-encoded). + /// Optional. Encryption key used with the Customer-Supplied Encryption Keys + /// feature. In raw bytes format (not base64-encoded). #[prost(bytes = "vec", tag = "4")] pub encryption_key_bytes: ::prost::alloc::vec::Vec, - /// SHA256 hash of encryption key used with the Customer-Supplied Encryption - /// Keys feature. + /// Optional. SHA256 hash of encryption key used with the Customer-Supplied + /// Encryption Keys feature. #[prost(bytes = "vec", tag = "5")] pub encryption_key_sha256_bytes: ::prost::alloc::vec::Vec, } @@ -1461,7 +1476,7 @@ pub mod service_constants { /// A bucket. #[derive(Clone, PartialEq, ::prost::Message)] pub struct Bucket { - /// Immutable. The name of the bucket. + /// Identifier. The name of the bucket. /// Format: `projects/{project}/buckets/{bucket}` #[prost(string, tag = "1")] pub name: ::prost::alloc::string::String, @@ -1478,6 +1493,7 @@ pub struct Bucket { /// Immutable. The project which owns this bucket, in the format of /// "projects/{projectIdentifier}". /// {projectIdentifier} can be the project ID or project number. + /// Output values will always be in project number format. #[prost(string, tag = "3")] pub project: ::prost::alloc::string::String, /// Output only. The metadata generation of this bucket. @@ -1495,33 +1511,33 @@ pub struct Bucket { /// multi-region, etc). #[prost(string, tag = "6")] pub location_type: ::prost::alloc::string::String, - /// The bucket's default storage class, used whenever no storageClass is - /// specified for a newly-created object. This defines how objects in the + /// Optional. The bucket's default storage class, used whenever no storageClass + /// is specified for a newly-created object. This defines how objects in the /// bucket are stored and determines the SLA and the cost of storage. /// If this value is not specified when the bucket is created, it will default /// to `STANDARD`. For more information, see /// #[prost(string, tag = "7")] pub storage_class: ::prost::alloc::string::String, - /// The recovery point objective for cross-region replication of the bucket. - /// Applicable only for dual- and multi-region buckets. "DEFAULT" uses default - /// replication. "ASYNC_TURBO" enables turbo replication, valid for dual-region - /// buckets only. If rpo is not specified when the bucket is created, it - /// defaults to "DEFAULT". For more information, see + /// Optional. The recovery point objective for cross-region replication of the + /// bucket. Applicable only for dual- and multi-region buckets. "DEFAULT" uses + /// default replication. "ASYNC_TURBO" enables turbo replication, valid for + /// dual-region buckets only. If rpo is not specified when the bucket is + /// created, it defaults to "DEFAULT". For more information, see /// #[prost(string, tag = "27")] pub rpo: ::prost::alloc::string::String, - /// Access controls on the bucket. + /// Optional. Access controls on the bucket. /// If iam_config.uniform_bucket_level_access is enabled on this bucket, /// requests to set, read, or modify acl is an error. #[prost(message, repeated, tag = "8")] pub acl: ::prost::alloc::vec::Vec, - /// Default access controls to apply to new objects when no ACL is provided. - /// If iam_config.uniform_bucket_level_access is enabled on this bucket, - /// requests to set, read, or modify acl is an error. + /// Optional. Default access controls to apply to new objects when no ACL is + /// provided. If iam_config.uniform_bucket_level_access is enabled on this + /// bucket, requests to set, read, or modify acl is an error. #[prost(message, repeated, tag = "9")] pub default_object_acl: ::prost::alloc::vec::Vec, - /// The bucket's lifecycle config. See + /// Optional. The bucket's lifecycle config. See /// \[ Management] /// for more information. #[prost(message, optional, tag = "10")] @@ -1529,41 +1545,41 @@ pub struct Bucket { /// Output only. The creation time of the bucket. #[prost(message, optional, tag = "11")] pub create_time: ::core::option::Option<::prost_types::Timestamp>, - /// The bucket's [ Resource Sharing] - /// (CORS) config. + /// Optional. The bucket's [ Resource + /// Sharing] (CORS) config. #[prost(message, repeated, tag = "12")] pub cors: ::prost::alloc::vec::Vec, /// Output only. The modification time of the bucket. #[prost(message, optional, tag = "13")] pub update_time: ::core::option::Option<::prost_types::Timestamp>, - /// The default value for event-based hold on newly created objects in this - /// bucket. Event-based hold is a way to retain objects indefinitely until an - /// event occurs, signified by the - /// hold's release. After being released, such objects will be subject to - /// bucket-level retention (if any). One sample use case of this flag is for - /// banks to hold loan documents for at least 3 years after loan is paid in - /// full. Here, bucket-level retention is 3 years and the event is loan being - /// paid in full. In this example, these objects will be held intact for any - /// number of years until the event has occurred (event-based hold on the - /// object is released) and then 3 more years after that. That means retention - /// duration of the objects begins from the moment event-based hold - /// transitioned from true to false. Objects under event-based hold cannot be - /// deleted, overwritten or archived until the hold is removed. + /// Optional. The default value for event-based hold on newly created objects + /// in this bucket. Event-based hold is a way to retain objects indefinitely + /// until an event occurs, signified by the hold's release. After being + /// released, such objects will be subject to bucket-level retention (if any). + /// One sample use case of this flag is for banks to hold loan documents for at + /// least 3 years after loan is paid in full. Here, bucket-level retention is 3 + /// years and the event is loan being paid in full. In this example, these + /// objects will be held intact for any number of years until the event has + /// occurred (event-based hold on the object is released) and then 3 more years + /// after that. That means retention duration of the objects begins from the + /// moment event-based hold transitioned from true to false. Objects under + /// event-based hold cannot be deleted, overwritten or archived until the hold + /// is removed. #[prost(bool, tag = "14")] pub default_event_based_hold: bool, - /// User-provided labels, in key/value pairs. + /// Optional. User-provided labels, in key/value pairs. #[prost(map = "string, string", tag = "15")] pub labels: ::std::collections::HashMap<::prost::alloc::string::String, ::prost::alloc::string::String>, - /// The bucket's website config, controlling how the service behaves + /// Optional. The bucket's website config, controlling how the service behaves /// when accessing bucket contents as a web site. See the /// [ Website /// Examples] for more information. #[prost(message, optional, tag = "16")] pub website: ::core::option::Option, - /// The bucket's versioning config. + /// Optional. The bucket's versioning config. #[prost(message, optional, tag = "17")] pub versioning: ::core::option::Option, - /// The bucket's logging config, which defines the destination bucket + /// Optional. The bucket's logging config, which defines the destination bucket /// and name prefix (if any) for the current bucket's logs. #[prost(message, optional, tag = "18")] pub logging: ::core::option::Option, @@ -1571,36 +1587,38 @@ pub struct Bucket { /// owner group. #[prost(message, optional, tag = "19")] pub owner: ::core::option::Option, - /// Encryption config for a bucket. + /// Optional. Encryption config for a bucket. #[prost(message, optional, tag = "20")] pub encryption: ::core::option::Option, - /// The bucket's billing config. + /// Optional. The bucket's billing config. #[prost(message, optional, tag = "21")] pub billing: ::core::option::Option, - /// The bucket's retention policy. The retention policy enforces a minimum - /// retention time for all objects contained in the bucket, based on their - /// creation time. Any attempt to overwrite or delete objects younger than the - /// retention period will result in a PERMISSION_DENIED error. An unlocked - /// retention policy can be modified or removed from the bucket via a + /// Optional. The bucket's retention policy. The retention policy enforces a + /// minimum retention time for all objects contained in the bucket, based on + /// their creation time. Any attempt to overwrite or delete objects younger + /// than the retention period will result in a PERMISSION_DENIED error. An + /// unlocked retention policy can be modified or removed from the bucket via a /// storage.buckets.update operation. A locked retention policy cannot be /// removed or shortened in duration for the lifetime of the bucket. /// Attempting to remove or decrease period of a locked retention policy will /// result in a PERMISSION_DENIED error. #[prost(message, optional, tag = "22")] pub retention_policy: ::core::option::Option, - /// The bucket's IAM config. + /// Optional. The bucket's IAM config. #[prost(message, optional, tag = "23")] pub iam_config: ::core::option::Option, - /// Reserved for future use. + /// Optional. Reserved for future use. #[prost(bool, tag = "25")] pub satisfies_pzs: bool, - /// Configuration that, if present, specifies the data placement for a + /// Optional. Configuration that, if present, specifies the data placement for + /// a /// [ /// dual-region]. #[prost(message, optional, tag = "26")] pub custom_placement_config: ::core::option::Option, - /// The bucket's Autoclass configuration. If there is no configuration, the - /// Autoclass feature will be disabled and have no effect on the bucket. + /// Optional. The bucket's Autoclass configuration. If there is no + /// configuration, the Autoclass feature will be disabled and have no effect on + /// the bucket. #[prost(message, optional, tag = "28")] pub autoclass: ::core::option::Option, /// Optional. The bucket's hierarchical namespace configuration. If there is no @@ -1612,13 +1630,16 @@ pub struct Bucket { /// soft-deleted objects from being permanently deleted. #[prost(message, optional, tag = "31")] pub soft_delete_policy: ::core::option::Option, + /// Optional. The bucket's IP filter configuration. + #[prost(message, optional, tag = "38")] + pub ip_filter: ::core::option::Option, } /// Nested message and enum types in `Bucket`. pub mod bucket { /// Billing properties of a bucket. #[derive(Clone, Copy, PartialEq, ::prost::Message)] pub struct Billing { - /// When set to true, Requester Pays is enabled for this bucket. + /// Optional. When set to true, Requester Pays is enabled for this bucket. #[prost(bool, tag = "1")] pub requester_pays: bool, } @@ -1628,22 +1649,23 @@ pub mod bucket { /// For more on CORS in general, see #[derive(Clone, PartialEq, ::prost::Message)] pub struct Cors { - /// The list of Origins eligible to receive CORS response headers. See - /// [ 6454] for more on origins. + /// Optional. The list of Origins eligible to receive CORS response headers. + /// See [ 6454] for more on origins. /// Note: "*" is permitted in the list of origins, and means "any Origin". #[prost(string, repeated, tag = "1")] pub origin: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, - /// The list of HTTP methods on which to include CORS response headers, + /// Optional. The list of HTTP methods on which to include CORS response + /// headers, /// (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of /// methods, and means "any method". #[prost(string, repeated, tag = "2")] pub method: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, - /// The list of HTTP headers other than the + /// Optional. The list of HTTP headers other than the /// [ response /// headers] to give permission for the user-agent to share across domains. #[prost(string, repeated, tag = "3")] pub response_header: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, - /// The value, in seconds, to return in the + /// Optional. The value, in seconds, to return in the /// [ /// header] used in preflight responses. #[prost(int32, tag = "4")] @@ -1652,19 +1674,19 @@ pub mod bucket { /// Encryption properties of a bucket. #[derive(Clone, PartialEq, ::prost::Message)] pub struct Encryption { - /// The name of the Cloud KMS key that will be used to encrypt objects - /// inserted into this bucket, if no encryption method is specified. + /// Optional. The name of the Cloud KMS key that will be used to encrypt + /// objects inserted into this bucket, if no encryption method is specified. #[prost(string, tag = "1")] pub default_kms_key: ::prost::alloc::string::String, } /// Bucket restriction options. #[derive(Clone, PartialEq, ::prost::Message)] pub struct IamConfig { - /// Bucket restriction options currently enforced on the bucket. + /// Optional. Bucket restriction options currently enforced on the bucket. #[prost(message, optional, tag = "1")] pub uniform_bucket_level_access: ::core::option::Option, - /// Whether IAM will enforce public access prevention. Valid values are - /// "enforced" or "inherited". + /// Optional. Whether IAM will enforce public access prevention. Valid values + /// are "enforced" or "inherited". #[prost(string, tag = "3")] pub public_access_prevention: ::prost::alloc::string::String, } @@ -1674,10 +1696,11 @@ pub mod bucket { /// See #[derive(Clone, Copy, PartialEq, ::prost::Message)] pub struct UniformBucketLevelAccess { - /// If set, access checks only use bucket-level IAM policies or above. + /// Optional. If set, access checks only use bucket-level IAM policies or + /// above. #[prost(bool, tag = "1")] pub enabled: bool, - /// The deadline time for changing + /// Optional. The deadline time for changing /// `iam_config.uniform_bucket_level_access.enabled` from `true` to /// `false`. Mutable until the specified deadline is reached, but not /// afterward. @@ -1689,8 +1712,8 @@ pub mod bucket { /// For more information, see #[derive(Clone, PartialEq, ::prost::Message)] pub struct Lifecycle { - /// A lifecycle management rule, which is made of an action to take and the - /// condition(s) under which the action will be taken. + /// Optional. A lifecycle management rule, which is made of an action to take + /// and the condition(s) under which the action will be taken. #[prost(message, repeated, tag = "1")] pub rule: ::prost::alloc::vec::Vec, } @@ -1700,10 +1723,10 @@ pub mod bucket { /// condition which will trigger that action. #[derive(Clone, PartialEq, ::prost::Message)] pub struct Rule { - /// The action to take. + /// Optional. The action to take. #[prost(message, optional, tag = "1")] pub action: ::core::option::Option, - /// The condition(s) under which the action will be taken. + /// Optional. The condition(s) under which the action will be taken. #[prost(message, optional, tag = "2")] pub condition: ::core::option::Option, } @@ -1712,12 +1735,13 @@ pub mod bucket { /// An action to take on an object. #[derive(Clone, PartialEq, ::prost::Message)] pub struct Action { - /// Type of the action. Currently, only `Delete`, `SetStorageClass`, and - /// `AbortIncompleteMultipartUpload` are supported. + /// Optional. Type of the action. Currently, only `Delete`, + /// `SetStorageClass`, and `AbortIncompleteMultipartUpload` are + /// supported. #[prost(string, tag = "1")] pub r#type: ::prost::alloc::string::String, - /// Target storage class. Required iff the type of the action is - /// SetStorageClass. + /// Optional. Target storage class. Required iff the type of the action + /// is SetStorageClass. #[prost(string, tag = "2")] pub storage_class: ::prost::alloc::string::String, } @@ -1730,8 +1754,8 @@ pub mod bucket { /// condition. #[prost(int32, optional, tag = "1")] pub age_days: ::core::option::Option, - /// This condition is satisfied when an object is created before midnight - /// of the specified date in UTC. + /// Optional. This condition is satisfied when an object is created + /// before midnight of the specified date in UTC. #[prost(message, optional, tag = "2")] pub created_before: ::core::option::Option, /// Relevant only for versioned objects. If the value is @@ -1744,9 +1768,9 @@ pub mod bucket { /// the live version) newer than this version of the object. #[prost(int32, optional, tag = "4")] pub num_newer_versions: ::core::option::Option, - /// Objects having any of the storage classes specified by this condition - /// will be matched. Values include `MULTI_REGIONAL`, `REGIONAL`, - /// `NEARLINE`, `COLDLINE`, `STANDARD`, and + /// Optional. Objects having any of the storage classes specified by this + /// condition will be matched. Values include `MULTI_REGIONAL`, + /// `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and /// `DURABLE_REDUCED_AVAILABILITY`. #[prost(string, repeated, tag = "5")] pub matches_storage_class: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, @@ -1755,8 +1779,8 @@ pub mod bucket { /// The value of the field must be a nonnegative integer. #[prost(int32, optional, tag = "7")] pub days_since_custom_time: ::core::option::Option, - /// An object matches this condition if the custom timestamp set on the - /// object is before the specified date in UTC. + /// Optional. An object matches this condition if the custom timestamp + /// set on the object is before the specified date in UTC. #[prost(message, optional, tag = "8")] pub custom_time_before: ::core::option::Option, /// This condition is relevant only for versioned objects. An object @@ -1766,17 +1790,17 @@ pub mod bucket { /// eligible for Lifecycle action as soon as it becomes noncurrent. #[prost(int32, optional, tag = "9")] pub days_since_noncurrent_time: ::core::option::Option, - /// This condition is relevant only for versioned objects. An object - /// version satisfies this condition only if it became noncurrent before - /// the specified date in UTC. + /// Optional. This condition is relevant only for versioned objects. An + /// object version satisfies this condition only if it became noncurrent + /// before the specified date in UTC. #[prost(message, optional, tag = "10")] pub noncurrent_time_before: ::core::option::Option, - /// List of object name prefixes. If any prefix exactly matches the - /// beginning of the object name, the condition evaluates to true. + /// Optional. List of object name prefixes. If any prefix exactly matches + /// the beginning of the object name, the condition evaluates to true. #[prost(string, repeated, tag = "11")] pub matches_prefix: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, - /// List of object name suffixes. If any suffix exactly matches the - /// end of the object name, the condition evaluates to true. + /// Optional. List of object name suffixes. If any suffix exactly matches + /// the end of the object name, the condition evaluates to true. #[prost(string, repeated, tag = "12")] pub matches_suffix: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, } @@ -1785,29 +1809,29 @@ pub mod bucket { /// Logging-related properties of a bucket. #[derive(Clone, PartialEq, ::prost::Message)] pub struct Logging { - /// The destination bucket where the current bucket's logs should be placed, - /// using path format (like `projects/123456/buckets/foo`). + /// Optional. The destination bucket where the current bucket's logs should + /// be placed, using path format (like `projects/123456/buckets/foo`). #[prost(string, tag = "1")] pub log_bucket: ::prost::alloc::string::String, - /// A prefix for log object names. + /// Optional. A prefix for log object names. #[prost(string, tag = "2")] pub log_object_prefix: ::prost::alloc::string::String, } /// Retention policy properties of a bucket. #[derive(Clone, Copy, PartialEq, ::prost::Message)] pub struct RetentionPolicy { - /// Server-determined value that indicates the time from which policy was - /// enforced and effective. + /// Optional. Server-determined value that indicates the time from which + /// policy was enforced and effective. #[prost(message, optional, tag = "1")] pub effective_time: ::core::option::Option<::prost_types::Timestamp>, - /// Once locked, an object retention policy cannot be modified. + /// Optional. Once locked, an object retention policy cannot be modified. #[prost(bool, tag = "2")] pub is_locked: bool, - /// The duration that objects need to be retained. Retention duration must be - /// greater than zero and less than 100 years. Note that enforcement of - /// retention periods less than a day is not guaranteed. Such periods should - /// only be used for testing purposes. Any `nanos` value specified will be - /// rounded down to the nearest second. + /// Optional. The duration that objects need to be retained. Retention + /// duration must be greater than zero and less than 100 years. Note that + /// enforcement of retention periods less than a day is not guaranteed. Such + /// periods should only be used for testing purposes. Any `nanos` value + /// specified will be rounded down to the nearest second. #[prost(message, optional, tag = "4")] pub retention_duration: ::core::option::Option<::prost_types::Duration>, } @@ -1828,7 +1852,7 @@ pub mod bucket { /// #[derive(Clone, Copy, PartialEq, ::prost::Message)] pub struct Versioning { - /// While set to true, versioning is fully enabled for this bucket. + /// Optional. While set to true, versioning is fully enabled for this bucket. #[prost(bool, tag = "1")] pub enabled: bool, } @@ -1837,13 +1861,13 @@ pub mod bucket { /// #[derive(Clone, PartialEq, ::prost::Message)] pub struct Website { - /// If the requested object path is missing, the service will ensure the path - /// has a trailing '/', append this suffix, and attempt to retrieve the - /// resulting object. This allows the creation of `index.html` + /// Optional. If the requested object path is missing, the service will + /// ensure the path has a trailing '/', append this suffix, and attempt to + /// retrieve the resulting object. This allows the creation of `index.html` /// objects to represent directory pages. #[prost(string, tag = "1")] pub main_page_suffix: ::prost::alloc::string::String, - /// If the requested object path is missing, and any + /// Optional. If the requested object path is missing, and any /// `mainPageSuffix` object is missing, if applicable, the service /// will return the named object from this bucket as the content for a /// [ Not Found] @@ -1856,14 +1880,14 @@ pub mod bucket { /// may be found [ #[derive(Clone, PartialEq, ::prost::Message)] pub struct CustomPlacementConfig { - /// List of locations to use for data placement. + /// Optional. List of locations to use for data placement. #[prost(string, repeated, tag = "1")] pub data_locations: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, } /// Configuration for a bucket's Autoclass feature. #[derive(Clone, PartialEq, ::prost::Message)] pub struct Autoclass { - /// Enables Autoclass. + /// Optional. Enables Autoclass. #[prost(bool, tag = "1")] pub enabled: bool, /// Output only. Latest instant at which the `enabled` field was set to true @@ -1882,6 +1906,63 @@ pub mod bucket { #[prost(message, optional, tag = "4")] pub terminal_storage_class_update_time: ::core::option::Option<::prost_types::Timestamp>, } + /// The [bucket IP + /// filtering]() + /// configuration. Specifies the network sources that can access the bucket, as + /// well as its underlying objects. + #[derive(Clone, PartialEq, ::prost::Message)] + pub struct IpFilter { + /// The state of the IP filter configuration. Valid values are `Enabled` and + /// `Disabled`. When set to `Enabled`, IP filtering rules are applied to a + /// bucket and all incoming requests to the bucket are evaluated against + /// these rules. When set to `Disabled`, IP filtering rules are not applied + /// to a bucket.". + #[prost(string, optional, tag = "1")] + pub mode: ::core::option::Option<::prost::alloc::string::String>, + /// Public IPs allowed to operate or access the bucket. + #[prost(message, optional, tag = "2")] + pub public_network_source: ::core::option::Option, + /// Optional. The list of network sources that are allowed to access + /// operations on the bucket or the underlying objects. + #[prost(message, repeated, tag = "3")] + pub vpc_network_sources: ::prost::alloc::vec::Vec, + /// Optional. Whether or not to allow VPCs from orgs different than the + /// bucket's parent org to access the bucket. When set to true, validations + /// on the existence of the VPCs won't be performed. If set to false, each + /// VPC network source will be checked to belong to the same org as the + /// bucket as well as validated for existence. + #[prost(bool, tag = "4")] + pub allow_cross_org_vpcs: bool, + } + /// Nested message and enum types in `IpFilter`. + pub mod ip_filter { + /// The public network IP address ranges that can access the bucket and its + /// data. + #[derive(Clone, PartialEq, ::prost::Message)] + pub struct PublicNetworkSource { + /// Optional. The list of IPv4 and IPv6 cidr blocks that are allowed to + /// operate or access the bucket and its underlying objects. + #[prost(string, repeated, tag = "1")] + pub allowed_ip_cidr_ranges: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, + } + /// The list of VPC networks that can access the bucket. + #[derive(Clone, PartialEq, ::prost::Message)] + pub struct VpcNetworkSource { + /// Name of the network. + /// + /// Format: `projects/PROJECT_ID/global/networks/NETWORK_NAME` + #[prost(string, optional, tag = "1")] + pub network: ::core::option::Option<::prost::alloc::string::String>, + /// Optional. The list of public or private IPv4 and IPv6 CIDR ranges that + /// can access the bucket. In the CIDR IP address block, the specified IP + /// address must be properly truncated, meaning all the host bits must be + /// zero or else the input is considered malformed. For example, + /// `192.0.2.0/24` is accepted but `192.0.2.1/24` is not. Similarly, for + /// IPv6, `2001:db8::/32` is accepted whereas `2001:db8::1/32` is not. + #[prost(string, repeated, tag = "2")] + pub allowed_ip_cidr_ranges: ::prost::alloc::vec::Vec<::prost::alloc::string::String>, + } + } /// Configuration for a bucket's hierarchical namespace feature. #[derive(Clone, Copy, PartialEq, ::prost::Message)] pub struct HierarchicalNamespace { @@ -1893,13 +1974,13 @@ pub mod bucket { /// An access-control entry. #[derive(Clone, PartialEq, ::prost::Message)] pub struct BucketAccessControl { - /// The access permission for the entity. + /// Optional. The access permission for the entity. #[prost(string, tag = "1")] pub role: ::prost::alloc::string::String, - /// The ID of the access-control entry. + /// Optional. The ID of the access-control entry. #[prost(string, tag = "2")] pub id: ::prost::alloc::string::String, - /// The entity holding the permission, in one of the following forms: + /// Optional. The entity holding the permission, in one of the following forms: /// * `user-{userid}` /// * `user-{email}` /// * `group-{groupid}` @@ -1923,22 +2004,22 @@ pub struct BucketAccessControl { /// entities, `project-{team}-{projectid}` format will be returned on response. #[prost(string, tag = "9")] pub entity_alt: ::prost::alloc::string::String, - /// The ID for the entity, if any. + /// Optional. The ID for the entity, if any. #[prost(string, tag = "4")] pub entity_id: ::prost::alloc::string::String, - /// The etag of the BucketAccessControl. + /// Optional. The etag of the BucketAccessControl. /// If included in the metadata of an update or delete request message, the /// operation operation will only be performed if the etag matches that of the /// bucket's BucketAccessControl. #[prost(string, tag = "8")] pub etag: ::prost::alloc::string::String, - /// The email address associated with the entity, if any. + /// Optional. The email address associated with the entity, if any. #[prost(string, tag = "5")] pub email: ::prost::alloc::string::String, - /// The domain associated with the entity, if any. + /// Optional. The domain associated with the entity, if any. #[prost(string, tag = "6")] pub domain: ::prost::alloc::string::String, - /// The project team associated with the entity, if any. + /// Optional. The project team associated with the entity, if any. #[prost(message, optional, tag = "7")] pub project_team: ::core::option::Option, } @@ -1962,7 +2043,7 @@ pub struct ObjectChecksums { /// object matches this checksum. #[prost(fixed32, optional, tag = "1")] pub crc32c: ::core::option::Option, - /// 128 bit MD5 hash of the object data. + /// Optional. 128 bit MD5 hash of the object data. /// For more information about using the MD5 hash, see /// [ and /// ETags: Best Practices]. @@ -1976,10 +2057,10 @@ pub struct ObjectChecksums { /// Object's data at rest. #[derive(Clone, PartialEq, ::prost::Message)] pub struct CustomerEncryption { - /// The encryption algorithm. + /// Optional. The encryption algorithm. #[prost(string, tag = "1")] pub encryption_algorithm: ::prost::alloc::string::String, - /// SHA256 hash value of the encryption key. + /// Optional. SHA256 hash value of the encryption key. /// In raw bytes format (not base64-encoded). #[prost(bytes = "vec", tag = "3")] pub key_sha256_bytes: ::prost::alloc::vec::Vec, @@ -1999,7 +2080,7 @@ pub struct Object { /// Immutable. The name of the bucket containing this object. #[prost(string, tag = "2")] pub bucket: ::prost::alloc::string::String, - /// The etag of the object. + /// Optional. The etag of the object. /// If included in the metadata of an update or delete request message, the /// operation will only be performed if the etag matches that of the live /// object. @@ -2020,33 +2101,33 @@ pub struct Object { /// generation of a particular object. #[prost(int64, tag = "4")] pub metageneration: i64, - /// Storage class of the object. + /// Optional. Storage class of the object. #[prost(string, tag = "5")] pub storage_class: ::prost::alloc::string::String, /// Output only. Content-Length of the object data in bytes, matching /// [ 7230 §3.3.2]. #[prost(int64, tag = "6")] pub size: i64, - /// Content-Encoding of the object data, matching + /// Optional. Content-Encoding of the object data, matching /// [ 7231 §3.1.2.2] #[prost(string, tag = "7")] pub content_encoding: ::prost::alloc::string::String, - /// Content-Disposition of the object data, matching + /// Optional. Content-Disposition of the object data, matching /// [ 6266]. #[prost(string, tag = "8")] pub content_disposition: ::prost::alloc::string::String, - /// Cache-Control directive for the object data, matching + /// Optional. Cache-Control directive for the object data, matching /// [ 7234 §5.2]. /// If omitted, and the object is accessible to all anonymous users, the /// default will be `public, max-age=3600`. #[prost(string, tag = "9")] pub cache_control: ::prost::alloc::string::String, - /// Access controls on the object. + /// Optional. Access controls on the object. /// If iam_config.uniform_bucket_level_access is enabled on the parent /// bucket, requests to set, read, or modify acl is an error. #[prost(message, repeated, tag = "10")] pub acl: ::prost::alloc::vec::Vec, - /// Content-Language of the object data, matching + /// Optional. Content-Language of the object data, matching /// [ 7231 §3.1.3.2]. #[prost(string, tag = "11")] pub content_language: ::prost::alloc::string::String, @@ -2057,7 +2138,7 @@ pub struct Object { /// Output only. The time when the object was finalized. #[prost(message, optional, tag = "36")] pub finalize_time: ::core::option::Option<::prost_types::Timestamp>, - /// Content-Type of the object data, matching + /// Optional. Content-Type of the object data, matching /// [ 7231 §3.1.1.5]. /// If an object is stored without a Content-Type, it is served as /// `application/octet-stream`. @@ -2085,31 +2166,31 @@ pub struct Object { /// Object Lifecycle Configuration. #[prost(message, optional, tag = "17")] pub update_time: ::core::option::Option<::prost_types::Timestamp>, - /// Cloud KMS Key used to encrypt this object, if the object is encrypted by - /// such a key. + /// Optional. Cloud KMS Key used to encrypt this object, if the object is + /// encrypted by such a key. #[prost(string, tag = "18")] pub kms_key: ::prost::alloc::string::String, /// Output only. The time at which the object's storage class was last changed. /// When the object is initially created, it will be set to time_created. #[prost(message, optional, tag = "19")] pub update_storage_class_time: ::core::option::Option<::prost_types::Timestamp>, - /// Whether an object is under temporary hold. While this flag is set to true, - /// the object is protected against deletion and overwrites. A common use case - /// of this flag is regulatory investigations where objects need to be retained - /// while the investigation is ongoing. Note that unlike event-based hold, - /// temporary hold does not impact retention expiration time of an object. + /// Optional. Whether an object is under temporary hold. While this flag is set + /// to true, the object is protected against deletion and overwrites. A common + /// use case of this flag is regulatory investigations where objects need to be + /// retained while the investigation is ongoing. Note that unlike event-based + /// hold, temporary hold does not impact retention expiration time of an + /// object. #[prost(bool, tag = "20")] pub temporary_hold: bool, - /// A server-determined value that specifies the earliest time that the - /// object's retention period expires. - /// Note 1: This field is not provided for objects with an active event-based - /// hold, since retention expiration is unknown until the hold is removed. - /// Note 2: This value can be provided even when temporary hold is set (so that - /// the user can reason about policy without having to first unset the - /// temporary hold). + /// Optional. A server-determined value that specifies the earliest time that + /// the object's retention period expires. Note 1: This field is not provided + /// for objects with an active event-based hold, since retention expiration is + /// unknown until the hold is removed. Note 2: This value can be provided even + /// when temporary hold is set (so that the user can reason about policy + /// without having to first unset the temporary hold). #[prost(message, optional, tag = "21")] pub retention_expire_time: ::core::option::Option<::prost_types::Timestamp>, - /// User-provided metadata, in key/value pairs. + /// Optional. User-provided metadata, in key/value pairs. #[prost(map = "string, string", tag = "22")] pub metadata: ::std::collections::HashMap<::prost::alloc::string::String, ::prost::alloc::string::String>, /// Whether an object is under event-based hold. @@ -2129,11 +2210,11 @@ pub struct Object { /// the object. #[prost(message, optional, tag = "24")] pub owner: ::core::option::Option, - /// Metadata of Customer-Supplied Encryption Key, if the object is encrypted by - /// such a key. + /// Optional. Metadata of Customer-Supplied Encryption Key, if the object is + /// encrypted by such a key. #[prost(message, optional, tag = "25")] pub customer_encryption: ::core::option::Option, - /// A user-specified timestamp set on an object. + /// Optional. A user-specified timestamp set on an object. #[prost(message, optional, tag = "26")] pub custom_time: ::core::option::Option<::prost_types::Timestamp>, /// Output only. This is the time when the object became soft-deleted. @@ -2148,20 +2229,80 @@ pub struct Object { /// Otherwise, the object will not be accessible. #[prost(message, optional, tag = "29")] pub hard_delete_time: ::core::option::Option<::prost_types::Timestamp>, + /// Optional. Retention configuration of this object. + /// May only be configured if the bucket has object retention enabled. + #[prost(message, optional, tag = "30")] + pub retention: ::core::option::Option, +} +/// Nested message and enum types in `Object`. +pub mod object { + /// Specifies retention parameters of the object. Objects under retention + /// cannot be deleted or overwritten until their retention expires. + #[derive(Clone, Copy, PartialEq, ::prost::Message)] + pub struct Retention { + /// Optional. The mode of the Retention. + #[prost(enumeration = "retention::Mode", tag = "1")] + pub mode: i32, + /// Optional. The timestamp that the object needs to be retained until. + /// Value cannot be set in the past or more than 100 years in the future. + #[prost(message, optional, tag = "2")] + pub retain_until_time: ::core::option::Option<::prost_types::Timestamp>, + } + /// Nested message and enum types in `Retention`. + pub mod retention { + /// Retention mode values. + #[derive(Clone, Copy, Debug, PartialEq, Eq, Hash, PartialOrd, Ord, ::prost::Enumeration)] + #[repr(i32)] + pub enum Mode { + /// No specified mode. Object is not under retention. + Unspecified = 0, + /// Retention period may be decreased or increased. + /// The Retention configuration may be removed. + /// The mode may be changed to locked. + Unlocked = 1, + /// Retention period may be increased. + /// The Retention configuration cannot be removed. + /// The mode cannot be changed. + Locked = 2, + } + impl Mode { + /// String value of the enum field names used in the ProtoBuf definition. + /// + /// The values are not transformed in any way and thus are considered stable + /// (if the ProtoBuf definition does not change) and safe for programmatic use. + pub fn as_str_name(&self) -> &'static str { + match self { + Self::Unspecified => "MODE_UNSPECIFIED", + Self::Unlocked => "UNLOCKED", + Self::Locked => "LOCKED", + } + } + /// Creates an enum from field names used in the ProtoBuf definition. + pub fn from_str_name(value: &str) -> ::core::option::Option { + match value { + "MODE_UNSPECIFIED" => Some(Self::Unspecified), + "UNLOCKED" => Some(Self::Unlocked), + "LOCKED" => Some(Self::Locked), + _ => None, + } + } + } + } } /// An access-control entry. #[derive(Clone, PartialEq, ::prost::Message)] pub struct ObjectAccessControl { - /// The access permission for the entity. One of the following values: + /// Optional. The access permission for the entity. One of the following + /// values: /// * `READER` /// * `WRITER` /// * `OWNER` #[prost(string, tag = "1")] pub role: ::prost::alloc::string::String, - /// The ID of the access-control entry. + /// Optional. The ID of the access-control entry. #[prost(string, tag = "2")] pub id: ::prost::alloc::string::String, - /// The entity holding the permission, in one of the following forms: + /// Optional. The entity holding the permission, in one of the following forms: /// * `user-{userid}` /// * `user-{email}` /// * `group-{groupid}` @@ -2185,22 +2326,22 @@ pub struct ObjectAccessControl { /// entities, `project-{team}-{projectid}` format will be returned on response. #[prost(string, tag = "9")] pub entity_alt: ::prost::alloc::string::String, - /// The ID for the entity, if any. + /// Optional. The ID for the entity, if any. #[prost(string, tag = "4")] pub entity_id: ::prost::alloc::string::String, - /// The etag of the ObjectAccessControl. + /// Optional. The etag of the ObjectAccessControl. /// If included in the metadata of an update or delete request message, the /// operation will only be performed if the etag matches that of the live /// object's ObjectAccessControl. #[prost(string, tag = "8")] pub etag: ::prost::alloc::string::String, - /// The email address associated with the entity, if any. + /// Optional. The email address associated with the entity, if any. #[prost(string, tag = "5")] pub email: ::prost::alloc::string::String, - /// The domain associated with the entity, if any. + /// Optional. The domain associated with the entity, if any. #[prost(string, tag = "6")] pub domain: ::prost::alloc::string::String, - /// The project team associated with the entity, if any. + /// Optional. The project team associated with the entity, if any. #[prost(message, optional, tag = "7")] pub project_team: ::core::option::Option, } @@ -2222,20 +2363,20 @@ pub struct ListObjectsResponse { /// Represents the Viewers, Editors, or Owners of a given project. #[derive(Clone, PartialEq, ::prost::Message)] pub struct ProjectTeam { - /// The project number. + /// Optional. The project number. #[prost(string, tag = "1")] pub project_number: ::prost::alloc::string::String, - /// The team. + /// Optional. The team. #[prost(string, tag = "2")] pub team: ::prost::alloc::string::String, } /// The owner of a specific resource. #[derive(Clone, PartialEq, ::prost::Message)] pub struct Owner { - /// The entity, in the form `user-`*userId*. + /// Optional. The entity, in the form `user-`*userId*. #[prost(string, tag = "1")] pub entity: ::prost::alloc::string::String, - /// The ID for the entity. + /// Optional. The ID for the entity. #[prost(string, tag = "2")] pub entity_id: ::prost::alloc::string::String, } @@ -2440,7 +2581,9 @@ pub mod storage_client { } /// Gets the IAM policy for a specified bucket. /// The `resource` field in the request should be - /// `projects/_/buckets/{bucket}`. + /// `projects/_/buckets/{bucket}` for a bucket, or + /// `projects/_/buckets/{bucket}/managedFolders/{managedFolder}` + /// for a managed folder. pub async fn get_iam_policy( &mut self, request: impl tonic::IntoRequest, @@ -2458,7 +2601,9 @@ pub mod storage_client { } /// Updates an IAM policy for the specified bucket. /// The `resource` field in the request should be - /// `projects/_/buckets/{bucket}`. + /// `projects/_/buckets/{bucket}` for a bucket, or + /// `projects/_/buckets/{bucket}/managedFolders/{managedFolder}` + /// for a managed folder. pub async fn set_iam_policy( &mut self, request: impl tonic::IntoRequest, diff --git a/googleapis/src/lib.rs b/googleapis/src/lib.rs index 8fae7991..7bcfc0b0 100644 --- a/googleapis/src/lib.rs +++ b/googleapis/src/lib.rs @@ -1,5 +1,6 @@ #![allow(clippy::doc_lazy_continuation)] #![allow(clippy::doc_overindented_list_items)] +#![allow(clippy::large_enum_variant)] #[path = "google.rpc.rs"] pub mod rpc; diff --git a/kms/Cargo.toml b/kms/Cargo.toml index 854f660d..071d47da 100644 --- a/kms/Cargo.toml +++ b/kms/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "gcloud-kms" -version = "1.2.0" +version = "1.2.1" edition = "2021" authors = ["yoshidan "] repository = "https://github.com/yoshidan/google-cloud-rust/tree/main/kms" @@ -16,7 +16,7 @@ doctest = false [dependencies] token-source = "1.0" google-cloud-auth = { package = "gcloud-auth", optional = true, version = "1.1.0", path="../foundation/auth", default-features=false } -google-cloud-googleapis = { package = "gcloud-googleapis", version="1.1.0", path = "../googleapis", features=["kms"]} +google-cloud-googleapis = { package = "gcloud-googleapis", version="1.2.0", path = "../googleapis", features=["kms"]} google-cloud-gax = { package = "gcloud-gax", version = "1.2.0", path = "../foundation/gax"} tracing = "0.1" diff --git a/pubsub/Cargo.toml b/pubsub/Cargo.toml index 7bd875fe..903378d8 100644 --- a/pubsub/Cargo.toml +++ b/pubsub/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "gcloud-pubsub" -version = "1.2.0" +version = "1.3.0" authors = ["yoshidan "] edition = "2021" repository = "https://github.com/yoshidan/google-cloud-rust/tree/main/pubsub" @@ -24,7 +24,7 @@ tokio-util = "0.7" token-source = "1.0" google-cloud-gax = { package = "gcloud-gax", version = "1.2.0", path = "../foundation/gax" } -google-cloud-googleapis = { package = "gcloud-googleapis", version = "1.1.0", path = "../googleapis", features = ["pubsub"]} +google-cloud-googleapis = { package = "gcloud-googleapis", version = "1.2.0", path = "../googleapis", features = ["pubsub"]} google-cloud-auth = { package = "gcloud-auth", optional = true, version = "1.1.0", path="../foundation/auth", default-features=false } diff --git a/spanner/Cargo.toml b/spanner/Cargo.toml index 3f72befb..ab98f977 100644 --- a/spanner/Cargo.toml +++ b/spanner/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "gcloud-spanner" -version = "1.2.0" +version = "1.3.0" authors = ["yoshidan "] edition = "2021" repository = "https://github.com/yoshidan/google-cloud-rust/tree/main/spanner" @@ -26,9 +26,9 @@ tokio-util = "0.7" bigdecimal = { version="0.4", features=["serde"] } token-source = "1.0" -google-cloud-longrunning = { package = "gcloud-longrunning", version = "1.2.0", path = "../foundation/longrunning" } +google-cloud-longrunning = { package = "gcloud-longrunning", version = "1.2.1", path = "../foundation/longrunning" } google-cloud-gax = { package = "gcloud-gax", version = "1.2.0", path = "../foundation/gax" } -google-cloud-googleapis = { package = "gcloud-googleapis", version = "1.1.0", path = "../googleapis", features = ["spanner"]} +google-cloud-googleapis = { package = "gcloud-googleapis", version = "1.2.0", path = "../googleapis", features = ["spanner"]} google-cloud-auth = { package = "gcloud-auth", optional = true, version = "1.1.0", path="../foundation/auth", default-features=false } diff --git a/spanner/src/admin/database/mod.rs b/spanner/src/admin/database/mod.rs index 6bec37d7..2d344a09 100644 --- a/spanner/src/admin/database/mod.rs +++ b/spanner/src/admin/database/mod.rs @@ -133,6 +133,7 @@ mod tests { statements: vec!["CREATE TABLE Tbl1 (ID INT64) PRIMARY KEY(ID)".to_string()], operation_id: "".to_string(), proto_descriptors: vec![], + throughput_mode: false, }; let update_result = match client.update_database_ddl(request, None).await { diff --git a/spanner/tests/change_stream_test.rs b/spanner/tests/change_stream_test.rs index 1b34d02d..b116a689 100644 --- a/spanner/tests/change_stream_test.rs +++ b/spanner/tests/change_stream_test.rs @@ -180,6 +180,7 @@ async fn test_read_change_stream() { statements: vec!["CREATE CHANGE STREAM UserItemChangeStream FOR UserItem".to_string()], operation_id: "".to_string(), proto_descriptors: vec![], + throughput_mode: false, }, None, ) @@ -216,6 +217,7 @@ async fn test_read_change_stream() { statements: vec!["DROP CHANGE STREAM UserItemChangeStream".to_string()], operation_id: "".to_string(), proto_descriptors: vec![], + throughput_mode: false, }, None, )