diff --git a/discovery/aiplatform-v1.json b/discovery/aiplatform-v1.json index a6d11626a9..4738835cfb 100644 --- a/discovery/aiplatform-v1.json +++ b/discovery/aiplatform-v1.json @@ -20,43 +20,43 @@ "documentationLink": "https://cloud.google.com/vertex-ai/", "endpoints": [ { - "endpointUrl": "https://africa-south1-aiplatform.googleapis.com/", "location": "africa-south1", - "description": "Locational Endpoint" + "description": "Locational Endpoint", + "endpointUrl": "https://africa-south1-aiplatform.googleapis.com/" }, { - "location": "asia-east1", "description": "Locational Endpoint", - "endpointUrl": "https://asia-east1-aiplatform.googleapis.com/" + "endpointUrl": "https://asia-east1-aiplatform.googleapis.com/", + "location": "asia-east1" }, { - "description": "Locational Endpoint", "location": "asia-east2", + "description": "Locational Endpoint", "endpointUrl": "https://asia-east2-aiplatform.googleapis.com/" }, { - "description": "Locational Endpoint", "location": "asia-northeast1", - "endpointUrl": "https://asia-northeast1-aiplatform.googleapis.com/" + "endpointUrl": "https://asia-northeast1-aiplatform.googleapis.com/", + "description": "Locational Endpoint" }, { - "description": "Locational Endpoint", "location": "asia-northeast2", - "endpointUrl": "https://asia-northeast2-aiplatform.googleapis.com/" + "endpointUrl": "https://asia-northeast2-aiplatform.googleapis.com/", + "description": "Locational Endpoint" }, { "endpointUrl": "https://asia-northeast3-aiplatform.googleapis.com/", - "description": "Locational Endpoint", - "location": "asia-northeast3" + "location": "asia-northeast3", + "description": "Locational Endpoint" }, { - "endpointUrl": "https://asia-south1-aiplatform.googleapis.com/", "description": "Locational Endpoint", - "location": "asia-south1" + "location": "asia-south1", + "endpointUrl": "https://asia-south1-aiplatform.googleapis.com/" }, { - "description": "Locational Endpoint", "endpointUrl": "https://asia-southeast1-aiplatform.googleapis.com/", + "description": "Locational Endpoint", "location": "asia-southeast1" }, { @@ -65,24 +65,24 @@ "location": "asia-southeast2" }, { - "description": "Locational Endpoint", "location": "australia-southeast1", - "endpointUrl": "https://australia-southeast1-aiplatform.googleapis.com/" + "endpointUrl": "https://australia-southeast1-aiplatform.googleapis.com/", + "description": "Locational Endpoint" }, { - "endpointUrl": "https://australia-southeast2-aiplatform.googleapis.com/", "location": "australia-southeast2", + "endpointUrl": "https://australia-southeast2-aiplatform.googleapis.com/", "description": "Locational Endpoint" }, { - "location": "europe-central2", + "description": "Locational Endpoint", "endpointUrl": "https://europe-central2-aiplatform.googleapis.com/", - "description": "Locational Endpoint" + "location": "europe-central2" }, { - "endpointUrl": "https://europe-north1-aiplatform.googleapis.com/", + "location": "europe-north1", "description": "Locational Endpoint", - "location": "europe-north1" + "endpointUrl": "https://europe-north1-aiplatform.googleapis.com/" }, { "location": "europe-southwest1", @@ -95,19 +95,19 @@ "location": "europe-west1" }, { - "endpointUrl": "https://europe-west2-aiplatform.googleapis.com/", + "description": "Locational Endpoint", "location": "europe-west2", - "description": "Locational Endpoint" + "endpointUrl": "https://europe-west2-aiplatform.googleapis.com/" }, { - "endpointUrl": "https://europe-west3-aiplatform.googleapis.com/", "location": "europe-west3", - "description": "Locational Endpoint" + "description": "Locational Endpoint", + "endpointUrl": "https://europe-west3-aiplatform.googleapis.com/" }, { + "description": "Locational Endpoint", "endpointUrl": "https://europe-west4-aiplatform.googleapis.com/", - "location": "europe-west4", - "description": "Locational Endpoint" + "location": "europe-west4" }, { "endpointUrl": "https://europe-west6-aiplatform.googleapis.com/", @@ -116,13 +116,13 @@ }, { "endpointUrl": "https://europe-west8-aiplatform.googleapis.com/", - "description": "Locational Endpoint", - "location": "europe-west8" + "location": "europe-west8", + "description": "Locational Endpoint" }, { + "location": "europe-west9", "description": "Locational Endpoint", - "endpointUrl": "https://europe-west9-aiplatform.googleapis.com/", - "location": "europe-west9" + "endpointUrl": "https://europe-west9-aiplatform.googleapis.com/" }, { "endpointUrl": "https://europe-west12-aiplatform.googleapis.com/", @@ -130,19 +130,19 @@ "location": "europe-west12" }, { - "description": "Locational Endpoint", + "endpointUrl": "https://me-central1-aiplatform.googleapis.com/", "location": "me-central1", - "endpointUrl": "https://me-central1-aiplatform.googleapis.com/" + "description": "Locational Endpoint" }, { - "location": "me-central2", + "description": "Locational Endpoint", "endpointUrl": "https://me-central2-aiplatform.googleapis.com/", - "description": "Locational Endpoint" + "location": "me-central2" }, { "endpointUrl": "https://me-west1-aiplatform.googleapis.com/", - "location": "me-west1", - "description": "Locational Endpoint" + "description": "Locational Endpoint", + "location": "me-west1" }, { "location": "northamerica-northeast1", @@ -150,53 +150,53 @@ "description": "Locational Endpoint" }, { - "location": "northamerica-northeast2", "description": "Locational Endpoint", + "location": "northamerica-northeast2", "endpointUrl": "https://northamerica-northeast2-aiplatform.googleapis.com/" }, { - "endpointUrl": "https://southamerica-east1-aiplatform.googleapis.com/", "location": "southamerica-east1", + "endpointUrl": "https://southamerica-east1-aiplatform.googleapis.com/", "description": "Locational Endpoint" }, { + "location": "southamerica-west1", "endpointUrl": "https://southamerica-west1-aiplatform.googleapis.com/", - "description": "Locational Endpoint", - "location": "southamerica-west1" + "description": "Locational Endpoint" }, { - "description": "Locational Endpoint", "endpointUrl": "https://us-central1-aiplatform.googleapis.com/", + "description": "Locational Endpoint", "location": "us-central1" }, { "location": "us-central2", - "description": "Locational Endpoint", - "endpointUrl": "https://us-central2-aiplatform.googleapis.com/" + "endpointUrl": "https://us-central2-aiplatform.googleapis.com/", + "description": "Locational Endpoint" }, { - "description": "Locational Endpoint", + "endpointUrl": "https://us-east1-aiplatform.googleapis.com/", "location": "us-east1", - "endpointUrl": "https://us-east1-aiplatform.googleapis.com/" + "description": "Locational Endpoint" }, { - "description": "Locational Endpoint", "location": "us-east4", - "endpointUrl": "https://us-east4-aiplatform.googleapis.com/" + "endpointUrl": "https://us-east4-aiplatform.googleapis.com/", + "description": "Locational Endpoint" }, { + "location": "us-south1", "description": "Locational Endpoint", - "endpointUrl": "https://us-south1-aiplatform.googleapis.com/", - "location": "us-south1" + "endpointUrl": "https://us-south1-aiplatform.googleapis.com/" }, { + "description": "Locational Endpoint", "endpointUrl": "https://us-west1-aiplatform.googleapis.com/", - "location": "us-west1", - "description": "Locational Endpoint" + "location": "us-west1" }, { - "endpointUrl": "https://us-west2-aiplatform.googleapis.com/", "description": "Locational Endpoint", + "endpointUrl": "https://us-west2-aiplatform.googleapis.com/", "location": "us-west2" }, { @@ -205,13 +205,13 @@ "description": "Locational Endpoint" }, { - "endpointUrl": "https://us-west4-aiplatform.googleapis.com/", + "location": "us-west4", "description": "Locational Endpoint", - "location": "us-west4" + "endpointUrl": "https://us-west4-aiplatform.googleapis.com/" }, { - "location": "us-east5", "endpointUrl": "https://us-east5-aiplatform.googleapis.com/", + "location": "us-east5", "description": "Locational Endpoint" } ], diff --git a/discovery/aiplatform-v1beta1.json b/discovery/aiplatform-v1beta1.json index c644bf5dee..fa1fed9918 100644 --- a/discovery/aiplatform-v1beta1.json +++ b/discovery/aiplatform-v1beta1.json @@ -25,14 +25,14 @@ "description": "Locational Endpoint" }, { - "location": "asia-east1", "description": "Locational Endpoint", + "location": "asia-east1", "endpointUrl": "https://asia-east1-aiplatform.googleapis.com/" }, { + "endpointUrl": "https://asia-east2-aiplatform.googleapis.com/", "location": "asia-east2", - "description": "Locational Endpoint", - "endpointUrl": "https://asia-east2-aiplatform.googleapis.com/" + "description": "Locational Endpoint" }, { "description": "Locational Endpoint", @@ -40,59 +40,59 @@ "endpointUrl": "https://asia-northeast1-aiplatform.googleapis.com/" }, { + "endpointUrl": "https://asia-northeast2-aiplatform.googleapis.com/", "location": "asia-northeast2", - "description": "Locational Endpoint", - "endpointUrl": "https://asia-northeast2-aiplatform.googleapis.com/" + "description": "Locational Endpoint" }, { - "description": "Locational Endpoint", "endpointUrl": "https://asia-northeast3-aiplatform.googleapis.com/", - "location": "asia-northeast3" + "location": "asia-northeast3", + "description": "Locational Endpoint" }, { + "description": "Locational Endpoint", "location": "asia-south1", - "endpointUrl": "https://asia-south1-aiplatform.googleapis.com/", - "description": "Locational Endpoint" + "endpointUrl": "https://asia-south1-aiplatform.googleapis.com/" }, { - "location": "asia-southeast1", "endpointUrl": "https://asia-southeast1-aiplatform.googleapis.com/", + "location": "asia-southeast1", "description": "Locational Endpoint" }, { + "location": "asia-southeast2", "description": "Locational Endpoint", - "endpointUrl": "https://asia-southeast2-aiplatform.googleapis.com/", - "location": "asia-southeast2" + "endpointUrl": "https://asia-southeast2-aiplatform.googleapis.com/" }, { - "description": "Locational Endpoint", "endpointUrl": "https://australia-southeast1-aiplatform.googleapis.com/", - "location": "australia-southeast1" + "location": "australia-southeast1", + "description": "Locational Endpoint" }, { - "endpointUrl": "https://australia-southeast2-aiplatform.googleapis.com/", "location": "australia-southeast2", - "description": "Locational Endpoint" + "description": "Locational Endpoint", + "endpointUrl": "https://australia-southeast2-aiplatform.googleapis.com/" }, { + "location": "europe-central2", "endpointUrl": "https://europe-central2-aiplatform.googleapis.com/", - "description": "Locational Endpoint", - "location": "europe-central2" + "description": "Locational Endpoint" }, { - "location": "europe-north1", + "endpointUrl": "https://europe-north1-aiplatform.googleapis.com/", "description": "Locational Endpoint", - "endpointUrl": "https://europe-north1-aiplatform.googleapis.com/" + "location": "europe-north1" }, { - "location": "europe-southwest1", + "description": "Locational Endpoint", "endpointUrl": "https://europe-southwest1-aiplatform.googleapis.com/", - "description": "Locational Endpoint" + "location": "europe-southwest1" }, { - "endpointUrl": "https://europe-west1-aiplatform.googleapis.com/", + "description": "Locational Endpoint", "location": "europe-west1", - "description": "Locational Endpoint" + "endpointUrl": "https://europe-west1-aiplatform.googleapis.com/" }, { "endpointUrl": "https://europe-west2-aiplatform.googleapis.com/", @@ -100,28 +100,28 @@ "location": "europe-west2" }, { - "description": "Locational Endpoint", "endpointUrl": "https://europe-west3-aiplatform.googleapis.com/", - "location": "europe-west3" + "location": "europe-west3", + "description": "Locational Endpoint" }, { - "location": "europe-west4", "endpointUrl": "https://europe-west4-aiplatform.googleapis.com/", - "description": "Locational Endpoint" + "description": "Locational Endpoint", + "location": "europe-west4" }, { - "location": "europe-west6", "description": "Locational Endpoint", + "location": "europe-west6", "endpointUrl": "https://europe-west6-aiplatform.googleapis.com/" }, { "description": "Locational Endpoint", - "endpointUrl": "https://europe-west8-aiplatform.googleapis.com/", - "location": "europe-west8" + "location": "europe-west8", + "endpointUrl": "https://europe-west8-aiplatform.googleapis.com/" }, { - "description": "Locational Endpoint", "endpointUrl": "https://europe-west9-aiplatform.googleapis.com/", + "description": "Locational Endpoint", "location": "europe-west9" }, { @@ -131,23 +131,23 @@ }, { "endpointUrl": "https://me-central1-aiplatform.googleapis.com/", - "description": "Locational Endpoint", - "location": "me-central1" + "location": "me-central1", + "description": "Locational Endpoint" }, { - "description": "Locational Endpoint", "endpointUrl": "https://me-central2-aiplatform.googleapis.com/", + "description": "Locational Endpoint", "location": "me-central2" }, { + "endpointUrl": "https://me-west1-aiplatform.googleapis.com/", "description": "Locational Endpoint", - "location": "me-west1", - "endpointUrl": "https://me-west1-aiplatform.googleapis.com/" + "location": "me-west1" }, { "endpointUrl": "https://northamerica-northeast1-aiplatform.googleapis.com/", - "location": "northamerica-northeast1", - "description": "Locational Endpoint" + "description": "Locational Endpoint", + "location": "northamerica-northeast1" }, { "endpointUrl": "https://northamerica-northeast2-aiplatform.googleapis.com/", @@ -155,49 +155,49 @@ "description": "Locational Endpoint" }, { - "location": "southamerica-east1", + "description": "Locational Endpoint", "endpointUrl": "https://southamerica-east1-aiplatform.googleapis.com/", - "description": "Locational Endpoint" + "location": "southamerica-east1" }, { - "endpointUrl": "https://southamerica-west1-aiplatform.googleapis.com/", + "location": "southamerica-west1", "description": "Locational Endpoint", - "location": "southamerica-west1" + "endpointUrl": "https://southamerica-west1-aiplatform.googleapis.com/" }, { + "description": "Locational Endpoint", "endpointUrl": "https://us-central1-aiplatform.googleapis.com/", - "location": "us-central1", - "description": "Locational Endpoint" + "location": "us-central1" }, { - "description": "Locational Endpoint", + "location": "us-central2", "endpointUrl": "https://us-central2-aiplatform.googleapis.com/", - "location": "us-central2" + "description": "Locational Endpoint" }, { - "endpointUrl": "https://us-east1-aiplatform.googleapis.com/", "location": "us-east1", - "description": "Locational Endpoint" + "description": "Locational Endpoint", + "endpointUrl": "https://us-east1-aiplatform.googleapis.com/" }, { + "endpointUrl": "https://us-east4-aiplatform.googleapis.com/", "description": "Locational Endpoint", - "location": "us-east4", - "endpointUrl": "https://us-east4-aiplatform.googleapis.com/" + "location": "us-east4" }, { - "description": "Locational Endpoint", + "endpointUrl": "https://us-south1-aiplatform.googleapis.com/", "location": "us-south1", - "endpointUrl": "https://us-south1-aiplatform.googleapis.com/" + "description": "Locational Endpoint" }, { - "endpointUrl": "https://us-west1-aiplatform.googleapis.com/", "location": "us-west1", + "endpointUrl": "https://us-west1-aiplatform.googleapis.com/", "description": "Locational Endpoint" }, { + "location": "us-west2", "description": "Locational Endpoint", - "endpointUrl": "https://us-west2-aiplatform.googleapis.com/", - "location": "us-west2" + "endpointUrl": "https://us-west2-aiplatform.googleapis.com/" }, { "description": "Locational Endpoint", @@ -205,9 +205,9 @@ "location": "us-west3" }, { - "location": "us-west4", + "description": "Locational Endpoint", "endpointUrl": "https://us-west4-aiplatform.googleapis.com/", - "description": "Locational Endpoint" + "location": "us-west4" }, { "description": "Locational Endpoint", diff --git a/discovery/analyticshub-v1.json b/discovery/analyticshub-v1.json index 7b1145dfa5..553b0364cf 100644 --- a/discovery/analyticshub-v1.json +++ b/discovery/analyticshub-v1.json @@ -1022,9 +1022,24 @@ } } }, - "revision": "20240429", + "revision": "20240624", "rootUrl": "https://analyticshub.googleapis.com/", "schemas": { + "AnalyticsHubSubscriptionInfo": { + "description": "Information about an associated Analytics Hub subscription (https://cloud.google.com/bigquery/docs/analytics-hub-manage-subscriptions).", + "id": "AnalyticsHubSubscriptionInfo", + "properties": { + "listing": { + "description": "Optional. The name of the associated Analytics Hub listing resource. Pattern: \"projects/{project}/locations/{location}/dataExchanges/{data_exchange}/listings/{listing}\"", + "type": "string" + }, + "subscription": { + "description": "Optional. The name of the associated Analytics Hub subscription resource. Pattern: \"projects/{project}/locations/{location}/subscriptions/{subscription}\"", + "type": "string" + } + }, + "type": "object" + }, "AuditConfig": { "description": "Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { \"audit_configs\": [ { \"service\": \"allServices\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\", \"exempted_members\": [ \"user:jose@example.com\" ] }, { \"log_type\": \"DATA_WRITE\" }, { \"log_type\": \"ADMIN_READ\" } ] }, { \"service\": \"sampleservice.googleapis.com\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\" }, { \"log_type\": \"DATA_WRITE\", \"exempted_members\": [ \"user:aliya@example.com\" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts `jose@example.com` from DATA_READ logging, and `aliya@example.com` from DATA_WRITE logging.", "id": "AuditConfig", @@ -1073,6 +1088,73 @@ }, "type": "object" }, + "AvroConfig": { + "description": "Configuration for writing message data in Avro format. Message payloads and metadata will be written to files as an Avro binary.", + "id": "AvroConfig", + "properties": { + "useTopicSchema": { + "description": "Optional. When true, the output Cloud Storage file will be serialized using the topic schema, if it exists.", + "type": "boolean" + }, + "writeMetadata": { + "description": "Optional. When true, write the subscription name, message_id, publish_time, attributes, and ordering_key as additional fields in the output. The subscription name, message_id, and publish_time fields are put in their own fields while all other message properties other than data (for example, an ordering_key, if present) are added as entries in the attributes map.", + "type": "boolean" + } + }, + "type": "object" + }, + "BigQueryConfig": { + "description": "Configuration for a BigQuery subscription.", + "id": "BigQueryConfig", + "properties": { + "dropUnknownFields": { + "description": "Optional. When true and use_topic_schema is true, any fields that are a part of the topic schema that are not part of the BigQuery table schema are dropped when writing to BigQuery. Otherwise, the schemas must be kept in sync and any messages with extra fields are not written and remain in the subscription's backlog.", + "type": "boolean" + }, + "serviceAccountEmail": { + "description": "Optional. The service account to use to write to BigQuery. The subscription creator or updater that specifies this field must have `iam.serviceAccounts.actAs` permission on the service account. If not specified, the Pub/Sub [service agent](https://cloud.google.com/iam/docs/service-agents), service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com, is used.", + "type": "string" + }, + "state": { + "description": "Output only. An output-only field that indicates whether or not the subscription can receive messages.", + "enum": [ + "STATE_UNSPECIFIED", + "ACTIVE", + "PERMISSION_DENIED", + "NOT_FOUND", + "SCHEMA_MISMATCH", + "IN_TRANSIT_LOCATION_RESTRICTION" + ], + "enumDescriptions": [ + "Default value. This value is unused.", + "The subscription can actively send messages to BigQuery", + "Cannot write to the BigQuery table because of permission denied errors. This can happen if - Pub/Sub SA has not been granted the [appropriate BigQuery IAM permissions](https://cloud.google.com/pubsub/docs/create-subscription#assign_bigquery_service_account) - bigquery.googleapis.com API is not enabled for the project ([instructions](https://cloud.google.com/service-usage/docs/enable-disable))", + "Cannot write to the BigQuery table because it does not exist.", + "Cannot write to the BigQuery table due to a schema mismatch.", + "Cannot write to the destination because enforce_in_transit is set to true and the destination locations are not in the allowed regions." + ], + "readOnly": true, + "type": "string" + }, + "table": { + "description": "Optional. The name of the table to which to write data, of the form {projectId}.{datasetId}.{tableId}", + "type": "string" + }, + "useTableSchema": { + "description": "Optional. When true, use the BigQuery table's schema as the columns to write to in BigQuery. `use_table_schema` and `use_topic_schema` cannot be enabled at the same time.", + "type": "boolean" + }, + "useTopicSchema": { + "description": "Optional. When true, use the topic's schema as the columns to write to in BigQuery, if it exists. `use_topic_schema` and `use_table_schema` cannot be enabled at the same time.", + "type": "boolean" + }, + "writeMetadata": { + "description": "Optional. When true, write the subscription name, message_id, publish_time, attributes, and ordering_key to additional columns in the table. The subscription name, message_id, and publish_time fields are put in their own columns while all other message properties (other than data) are written to a JSON object in the attributes column.", + "type": "boolean" + } + }, + "type": "object" + }, "BigQueryDatasetSource": { "description": "A reference to a shared dataset. It is an existing BigQuery dataset with a collection of objects such as tables and views that you want to share with subscribers. When subscriber's subscribe to a listing, Analytics Hub creates a linked dataset in the subscriber's project. A Linked dataset is an opaque, read-only BigQuery dataset that serves as a _symbolic link_ to a shared dataset.", "id": "BigQueryDatasetSource", @@ -1086,7 +1168,7 @@ "description": "Optional. If set, restricted export policy will be propagated and enforced on the linked dataset." }, "selectedResources": { - "description": "Optional. Resources in this dataset that are selectively shared. If this field is empty, then the entire dataset (all resources) are shared. This field is only valid for data clean room exchanges.", + "description": "Optional. Resource in this dataset that is selectively shared. This field is required for data clean room exchanges.", "items": { "$ref": "SelectedResource" }, @@ -1117,6 +1199,77 @@ }, "type": "object" }, + "CloudStorageConfig": { + "description": "Configuration for a Cloud Storage subscription.", + "id": "CloudStorageConfig", + "properties": { + "avroConfig": { + "$ref": "AvroConfig", + "description": "Optional. If set, message data will be written to Cloud Storage in Avro format." + }, + "bucket": { + "description": "Required. User-provided name for the Cloud Storage bucket. The bucket must be created by the user. The bucket name must be without any prefix like \"gs://\". See the [bucket naming requirements] (https://cloud.google.com/storage/docs/buckets#naming).", + "type": "string" + }, + "filenameDatetimeFormat": { + "description": "Optional. User-provided format string specifying how to represent datetimes in Cloud Storage filenames. See the [datetime format guidance](https://cloud.google.com/pubsub/docs/create-cloudstorage-subscription#file_names).", + "type": "string" + }, + "filenamePrefix": { + "description": "Optional. User-provided prefix for Cloud Storage filename. See the [object naming requirements](https://cloud.google.com/storage/docs/objects#naming).", + "type": "string" + }, + "filenameSuffix": { + "description": "Optional. User-provided suffix for Cloud Storage filename. See the [object naming requirements](https://cloud.google.com/storage/docs/objects#naming). Must not end in \"/\".", + "type": "string" + }, + "maxBytes": { + "description": "Optional. The maximum bytes that can be written to a Cloud Storage file before a new file is created. Min 1 KB, max 10 GiB. The max_bytes limit may be exceeded in cases where messages are larger than the limit.", + "format": "int64", + "type": "string" + }, + "maxDuration": { + "description": "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.", + "format": "google-duration", + "type": "string" + }, + "maxMessages": { + "description": "Optional. The maximum number of messages that can be written to a Cloud Storage file before a new file is created. Min 1000 messages.", + "format": "int64", + "type": "string" + }, + "serviceAccountEmail": { + "description": "Optional. The service account to use to write to Cloud Storage. The subscription creator or updater that specifies this field must have `iam.serviceAccounts.actAs` permission on the service account. If not specified, the Pub/Sub [service agent](https://cloud.google.com/iam/docs/service-agents), service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com, is used.", + "type": "string" + }, + "state": { + "description": "Output only. An output-only field that indicates whether or not the subscription can receive messages.", + "enum": [ + "STATE_UNSPECIFIED", + "ACTIVE", + "PERMISSION_DENIED", + "NOT_FOUND", + "IN_TRANSIT_LOCATION_RESTRICTION", + "SCHEMA_MISMATCH" + ], + "enumDescriptions": [ + "Default value. This value is unused.", + "The subscription can actively send messages to Cloud Storage.", + "Cannot write to the Cloud Storage bucket because of permission denied errors.", + "Cannot write to the Cloud Storage bucket because it does not exist.", + "Cannot write to the destination because enforce_in_transit is set to true and the destination locations are not in the allowed regions.", + "Cannot write to the Cloud Storage bucket due to an incompatibility between the topic schema and subscription settings." + ], + "readOnly": true, + "type": "string" + }, + "textConfig": { + "$ref": "TextConfig", + "description": "Optional. If set, message data will be written to Cloud Storage in text format." + } + }, + "type": "object" + }, "DataExchange": { "description": "A data exchange is a container that lets you share data. Along with the descriptive information about the data exchange, it contains listings that reference shared datasets.", "id": "DataExchange", @@ -1125,6 +1278,20 @@ "description": "Optional. Description of the data exchange. The description must not contain Unicode non-characters as well as C0 and C1 control codes except tabs (HT), new lines (LF), carriage returns (CR), and page breaks (FF). Default value is an empty string. Max length: 2000 bytes.", "type": "string" }, + "discoveryType": { + "description": "Optional. Type of discovery on the discovery page for all the listings under this exchange. Updating this field also updates (overwrites) the discovery_type field for all the listings under this exchange.", + "enum": [ + "DISCOVERY_TYPE_UNSPECIFIED", + "DISCOVERY_TYPE_PRIVATE", + "DISCOVERY_TYPE_PUBLIC" + ], + "enumDescriptions": [ + "Unspecified. Defaults to DISCOVERY_TYPE_PRIVATE.", + "The Data exchange/listing can be discovered in the 'Private' results list.", + "The Data exchange/listing can be discovered in the 'Public' results list." + ], + "type": "string" + }, "displayName": { "description": "Required. Human-readable display name of the data exchange. The display name must contain only Unicode letters, numbers (0-9), underscores (_), dashes (-), spaces ( ), ampersands (&) and must not start or end with spaces. Default value is an empty string. Max length: 63 bytes.", "type": "string" @@ -1192,6 +1359,22 @@ }, "type": "object" }, + "DeadLetterPolicy": { + "description": "Dead lettering is done on a best effort basis. The same message might be dead lettered multiple times. If validation on any of the fields fails at subscription creation/updation, the create/update subscription request will fail.", + "id": "DeadLetterPolicy", + "properties": { + "deadLetterTopic": { + "description": "Optional. The name of the topic to which dead letter messages should be published. Format is `projects/{project}/topics/{topic}`.The Pub/Sub service account associated with the enclosing subscription's parent project (i.e., service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have permission to Publish() to this topic. The operation will fail if the topic does not exist. Users should ensure that there is a subscription attached to this topic since messages published to a topic with no subscriptions are lost.", + "type": "string" + }, + "maxDeliveryAttempts": { + "description": "Optional. The maximum number of delivery attempts for any message. The 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 for the message). A NACK is any call to ModifyAckDeadline with a 0 deadline. Note that client libraries may automatically extend ack_deadlines. This field will be honored on a best effort basis. If this parameter is 0, a default value of 5 is used.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, "DefaultExchangeConfig": { "description": "Default Analytics Hub data exchange, used for secured data sharing.", "id": "DefaultExchangeConfig", @@ -1243,12 +1426,35 @@ }, "type": "object" }, + "DestinationPubSubSubscription": { + "description": "Defines the destination Pub/Sub subscription.", + "id": "DestinationPubSubSubscription", + "properties": { + "pubsubSubscription": { + "$ref": "GooglePubsubV1Subscription", + "description": "Required. Destination Pub/Sub subscription resource." + } + }, + "type": "object" + }, "Empty": { "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", "id": "Empty", "properties": {}, "type": "object" }, + "ExpirationPolicy": { + "description": "A policy that specifies the conditions for resource expiration (i.e., automatic resource deletion).", + "id": "ExpirationPolicy", + "properties": { + "ttl": { + "description": "Optional. Specifies the \"time-to-live\" duration for an associated resource. The resource expires if it is not active for a period of `ttl`. The definition of \"activity\" depends on the type of the associated resource. The minimum and maximum allowed values for `ttl` depend on the type of the associated resource, as well. If `ttl` is not set, the associated resource never expires.", + "format": "google-duration", + "type": "string" + } + }, + "type": "object" + }, "Expr": { "description": "Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: \"Summary size limit\" description: \"Determines if a summary is less than 100 chars\" expression: \"document.summary.size() < 100\" Example (Equality): title: \"Requestor is owner\" description: \"Determines if requestor is the document owner\" expression: \"document.owner == request.auth.claims.email\" Example (Logic): title: \"Public documents\" description: \"Determine whether the document should be publicly visible\" expression: \"document.type != 'private' && document.type != 'internal'\" Example (Data Manipulation): title: \"Notification string\" description: \"Create a notification string with a timestamp.\" expression: \"'New message received at ' + string(document.create_time)\" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information.", "id": "Expr", @@ -1295,6 +1501,104 @@ }, "type": "object" }, + "GooglePubsubV1Subscription": { + "description": "A subscription resource. If none of `push_config`, `bigquery_config`, or `cloud_storage_config` is set, then the subscriber will pull and ack messages using API methods. At most one of these fields may be set.", + "id": "GooglePubsubV1Subscription", + "properties": { + "ackDeadlineSeconds": { + "description": "Optional. The approximate amount of time (on a best-effort basis) Pub/Sub waits for the subscriber to acknowledge receipt before resending the message. In the interval after the message is delivered and before it is acknowledged, it is considered to be _outstanding_. During that time period, the message will not be redelivered (on a best-effort basis). For pull subscriptions, this value is used as the initial value for the ack deadline. To override this value for a given message, call `ModifyAckDeadline` with the corresponding `ack_id` if using non-streaming pull or send the `ack_id` in a `StreamingModifyAckDeadlineRequest` if using streaming pull. The minimum custom deadline you can specify is 10 seconds. The maximum custom deadline you can specify is 600 seconds (10 minutes). If this parameter is 0, a default value of 10 seconds is used. For push delivery, this value is also used to set the request timeout for the call to the push endpoint. If the subscriber never acknowledges the message, the Pub/Sub system will eventually redeliver the message.", + "format": "int32", + "type": "integer" + }, + "analyticsHubSubscriptionInfo": { + "$ref": "AnalyticsHubSubscriptionInfo", + "description": "Output only. Information about the associated Analytics Hub subscription. Only set if the subscritpion is created by Analytics Hub.", + "readOnly": true + }, + "bigqueryConfig": { + "$ref": "BigQueryConfig", + "description": "Optional. If delivery to BigQuery is used with this subscription, this field is used to configure it." + }, + "cloudStorageConfig": { + "$ref": "CloudStorageConfig", + "description": "Optional. If delivery to Google Cloud Storage is used with this subscription, this field is used to configure it." + }, + "deadLetterPolicy": { + "$ref": "DeadLetterPolicy", + "description": "Optional. A policy that specifies the conditions for dead lettering messages in this subscription. If dead_letter_policy is not set, dead lettering is disabled. The Pub/Sub service account associated with this subscriptions's parent project (i.e., service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have permission to Acknowledge() messages on this subscription." + }, + "detached": { + "description": "Optional. Indicates whether the subscription is detached from its topic. Detached subscriptions don't receive messages from their topic and don't retain any backlog. `Pull` and `StreamingPull` requests will return FAILED_PRECONDITION. If the subscription is a push subscription, pushes to the endpoint will not be made.", + "type": "boolean" + }, + "enableExactlyOnceDelivery": { + "description": "Optional. If true, Pub/Sub provides the following guarantees for the delivery of a message with a given value of `message_id` on this subscription: * The message sent to a subscriber is guaranteed not to be resent before the message's acknowledgement deadline expires. * An acknowledged message will not be resent to a subscriber. Note that subscribers may still receive multiple copies of a message when `enable_exactly_once_delivery` is true if the message was published multiple times by a publisher client. These copies are considered distinct by Pub/Sub and have distinct `message_id` values.", + "type": "boolean" + }, + "enableMessageOrdering": { + "description": "Optional. If true, messages published with the same `ordering_key` in `PubsubMessage` will be delivered to the subscribers in the order in which they are received by the Pub/Sub system. Otherwise, they may be delivered in any order.", + "type": "boolean" + }, + "expirationPolicy": { + "$ref": "ExpirationPolicy", + "description": "Optional. A policy that specifies the conditions for this subscription's expiration. A subscription is considered active as long as any connected subscriber is successfully consuming messages from the subscription or is issuing operations on the subscription. If `expiration_policy` is not set, a *default policy* with `ttl` of 31 days will be used. The minimum allowed value for `expiration_policy.ttl` is 1 day. If `expiration_policy` is set, but `expiration_policy.ttl` is not set, the subscription never expires." + }, + "filter": { + "description": "Optional. An expression written in the Pub/Sub [filter language](https://cloud.google.com/pubsub/docs/filtering). If non-empty, then only `PubsubMessage`s whose `attributes` field matches the filter are delivered on this subscription. If empty, then no messages are filtered out.", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. See [Creating and managing labels](https://cloud.google.com/pubsub/docs/labels).", + "type": "object" + }, + "messageRetentionDuration": { + "description": "Optional. How long to retain unacknowledged messages in the subscription's backlog, from the moment a message is published. If `retain_acked_messages` is true, then this also configures the retention of acknowledged messages, and thus configures how far back in time a `Seek` can be done. Defaults to 7 days. Cannot be more than 7 days or less than 10 minutes.", + "format": "google-duration", + "type": "string" + }, + "name": { + "description": "Required. Name of the subscription. Format is `projects/{project}/subscriptions/{sub}`.", + "type": "string" + }, + "pushConfig": { + "$ref": "PushConfig", + "description": "Optional. If push delivery is used with this subscription, this field is used to configure it." + }, + "retainAckedMessages": { + "description": "Optional. Indicates whether to retain acknowledged messages. If true, then messages are not expunged from the subscription's backlog, even if they are acknowledged, until they fall out of the `message_retention_duration` window. This must be true if you would like to [`Seek` to a timestamp] (https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time) in the past to replay previously-acknowledged messages.", + "type": "boolean" + }, + "retryPolicy": { + "$ref": "RetryPolicy", + "description": "Optional. A policy that specifies how Pub/Sub retries message delivery for this 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." + }, + "state": { + "description": "Output only. An output-only field indicating whether or not the subscription can receive messages.", + "enum": [ + "STATE_UNSPECIFIED", + "ACTIVE", + "RESOURCE_ERROR" + ], + "enumDescriptions": [ + "Default value. This value is unused.", + "The subscription can actively receive messages", + "The subscription cannot receive messages because of an error with the resource to which it pushes messages. See the more detailed error state in the corresponding configuration." + ], + "readOnly": true, + "type": "string" + }, + "topicMessageRetentionDuration": { + "description": "Output only. Indicates the minimum duration for which a message is retained after it is published to the subscription's topic. If this field is set, messages published to the subscription's topic in the last `topic_message_retention_duration` are always available to subscribers. See the `message_retention_duration` field in `Topic`. This field is set only in responses from the server; it is ignored if it is set in any requests.", + "format": "google-duration", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "LinkedResource": { "description": "Reference to a linked resource tracked by this Subscription.", "id": "LinkedResource", @@ -1303,6 +1607,16 @@ "description": "Output only. Name of the linked dataset, e.g. projects/subscriberproject/datasets/linked_dataset", "readOnly": true, "type": "string" + }, + "linkedPubsubSubscription": { + "description": "Output only. Name of the Pub/Sub subscription, e.g. projects/subscriberproject/subscriptions/subscriptions/sub_id", + "readOnly": true, + "type": "string" + }, + "listing": { + "description": "Output only. Listing for which linked resource is created.", + "readOnly": true, + "type": "string" } }, "type": "object" @@ -1464,6 +1778,20 @@ "description": "Optional. Short description of the listing. The description must not contain Unicode non-characters and C0 and C1 control codes except tabs (HT), new lines (LF), carriage returns (CR), and page breaks (FF). Default value is an empty string. Max length: 2000 bytes.", "type": "string" }, + "discoveryType": { + "description": "Optional. Type of discovery of the listing on the discovery page.", + "enum": [ + "DISCOVERY_TYPE_UNSPECIFIED", + "DISCOVERY_TYPE_PRIVATE", + "DISCOVERY_TYPE_PUBLIC" + ], + "enumDescriptions": [ + "Unspecified. Defaults to DISCOVERY_TYPE_PRIVATE.", + "The Data exchange/listing can be discovered in the 'Private' results list.", + "The Data exchange/listing can be discovered in the 'Public' results list." + ], + "type": "string" + }, "displayName": { "description": "Required. Human-readable display name of the listing. The display name must contain only Unicode letters, numbers (0-9), underscores (_), dashes (-), spaces ( ), ampersands (&) and can't start or end with spaces. Default value is an empty string. Max length: 63 bytes.", "type": "string" @@ -1490,10 +1818,29 @@ "$ref": "Publisher", "description": "Optional. Details of the publisher who owns the listing and who can share the source data." }, + "pubsubTopic": { + "$ref": "PubSubTopicSource", + "description": "Required. Pub/Sub topic source." + }, "requestAccess": { "description": "Optional. Email or URL of the request access of the listing. Subscribers can use this reference to request access. Max Length: 1000 bytes.", "type": "string" }, + "resourceType": { + "description": "Output only. Listing shared asset type.", + "enum": [ + "SHARED_RESOURCE_TYPE_UNSPECIFIED", + "BIGQUERY_DATASET", + "PUBSUB_TOPIC" + ], + "enumDescriptions": [ + "Not specified.", + "BigQuery Dataset Asset.", + "Pub/Sub Topic Asset." + ], + "readOnly": true, + "type": "string" + }, "restrictedExportConfig": { "$ref": "RestrictedExportConfig", "description": "Optional. If set, restricted export configuration will be propagated and enforced on the linked dataset." @@ -1514,6 +1861,32 @@ }, "type": "object" }, + "NoWrapper": { + "description": "Sets the `data` field as the HTTP body for delivery.", + "id": "NoWrapper", + "properties": { + "writeMetadata": { + "description": "Optional. When true, writes the Pub/Sub message metadata to `x-goog-pubsub-:` headers of the HTTP request. Writes the Pub/Sub message attributes to `:` headers of the HTTP request.", + "type": "boolean" + } + }, + "type": "object" + }, + "OidcToken": { + "description": "Contains information needed for generating an [OpenID Connect token](https://developers.google.com/identity/protocols/OpenIDConnect).", + "id": "OidcToken", + "properties": { + "audience": { + "description": "Optional. Audience to be used when generating OIDC token. The audience claim identifies the recipients that the JWT is intended for. The audience value is a single case-sensitive string. Having multiple values (array) for the audience field is not supported. More info about the OIDC JWT token audience here: https://tools.ietf.org/html/rfc7519#section-4.1.3 Note: if not specified, the Push endpoint URL will be used.", + "type": "string" + }, + "serviceAccountEmail": { + "description": "Optional. [Service account email](https://cloud.google.com/iam/docs/service-accounts) used for generating the OIDC token. For more information on setting up authentication, see [Push subscriptions](https://cloud.google.com/pubsub/docs/push).", + "type": "string" + } + }, + "type": "object" + }, "Operation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "Operation", @@ -1624,6 +1997,24 @@ }, "type": "object" }, + "PubSubTopicSource": { + "description": "Pub/Sub topic source.", + "id": "PubSubTopicSource", + "properties": { + "dataAffinityRegions": { + "description": "Optional. Region hint on where the data might be published. Data affinity regions are modifiable. See go/regions for full listing of possible Cloud regions.", + "items": { + "type": "string" + }, + "type": "array" + }, + "topic": { + "description": "Required. Resource name of the Pub/Sub topic source for this listing. e.g. projects/myproject/topics/topicId", + "type": "string" + } + }, + "type": "object" + }, "Publisher": { "description": "Contains details of the listing publisher.", "id": "Publisher", @@ -1639,6 +2030,42 @@ }, "type": "object" }, + "PubsubWrapper": { + "description": "The payload to the push endpoint is in the form of the JSON representation of a PubsubMessage (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#pubsubmessage).", + "id": "PubsubWrapper", + "properties": {}, + "type": "object" + }, + "PushConfig": { + "description": "Configuration for a push delivery endpoint.", + "id": "PushConfig", + "properties": { + "attributes": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Endpoint configuration attributes that can be used to control different aspects of the message delivery. The only currently supported attribute is `x-goog-version`, which you can use to change the format of the pushed message. This attribute indicates the version of the data expected by the endpoint. This controls the shape of the pushed message (i.e., its fields and metadata). If not present during the `CreateSubscription` call, it will default to the version of the Pub/Sub API used to make such call. If not present in a `ModifyPushConfig` call, its value will not be changed. `GetSubscription` calls will always return a valid version, even if the subscription was created without this attribute. The only supported values for the `x-goog-version` attribute are: * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API. * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API. For example: `attributes { \"x-goog-version\": \"v1\" }`", + "type": "object" + }, + "noWrapper": { + "$ref": "NoWrapper", + "description": "Optional. When set, the payload to the push endpoint is not wrapped." + }, + "oidcToken": { + "$ref": "OidcToken", + "description": "Optional. If specified, Pub/Sub will generate and attach an OIDC JWT token as an `Authorization` header in the HTTP request for every pushed message." + }, + "pubsubWrapper": { + "$ref": "PubsubWrapper", + "description": "Optional. When set, the payload to the push endpoint is in the form of the JSON representation of a PubsubMessage (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#pubsubmessage)." + }, + "pushEndpoint": { + "description": "Optional. A URL locating the endpoint to which messages should be pushed. For example, a Webhook endpoint might use `https://example.com/push`.", + "type": "string" + } + }, + "type": "object" + }, "RefreshSubscriptionRequest": { "description": "Message for refreshing a subscription.", "id": "RefreshSubscriptionRequest", @@ -1695,6 +2122,23 @@ }, "type": "object" }, + "RetryPolicy": { + "description": "A policy that specifies how Pub/Sub retries message delivery. Retry delay will be exponential based on provided minimum and maximum backoffs. https://en.wikipedia.org/wiki/Exponential_backoff. RetryPolicy will be triggered on NACKs or acknowledgement deadline exceeded events for a given message. Retry Policy is implemented on a best effort basis. At times, the delay between consecutive deliveries may not match the configuration. That is, delay can be more or less than configured backoff.", + "id": "RetryPolicy", + "properties": { + "maximumBackoff": { + "description": "Optional. The maximum delay between consecutive deliveries of a given message. Value should be between 0 and 600 seconds. Defaults to 600 seconds.", + "format": "google-duration", + "type": "string" + }, + "minimumBackoff": { + "description": "Optional. The minimum delay between consecutive deliveries of a given message. Value should be between 0 and 600 seconds. Defaults to 10 seconds.", + "format": "google-duration", + "type": "string" + } + }, + "type": "object" + }, "RevokeSubscriptionRequest": { "description": "Message for revoking a subscription.", "id": "RevokeSubscriptionRequest", @@ -1708,7 +2152,7 @@ "type": "object" }, "SelectedResource": { - "description": "Resource in this dataset that are selectively shared.", + "description": "Resource in this dataset that is selectively shared.", "id": "SelectedResource", "properties": { "table": { @@ -1813,6 +2257,10 @@ "destinationDataset": { "$ref": "DestinationDataset", "description": "Input only. BigQuery destination dataset to create for the subscriber." + }, + "destinationPubsubSubscription": { + "$ref": "DestinationPubSubSubscription", + "description": "Required. Input only. Destination Pub/Sub subscription to create for the subscriber." } }, "type": "object" @@ -1857,6 +2305,14 @@ "readOnly": true, "type": "object" }, + "linkedResources": { + "description": "Output only. Linked resources created in the subscription. Only contains values if state = STATE_ACTIVE.", + "items": { + "$ref": "LinkedResource" + }, + "readOnly": true, + "type": "array" + }, "listing": { "description": "Output only. Resource name of the source Listing. e.g. projects/123/locations/US/dataExchanges/456/listings/789", "readOnly": true, @@ -1877,6 +2333,21 @@ "readOnly": true, "type": "string" }, + "resourceType": { + "description": "Output only. Listing shared asset type.", + "enum": [ + "SHARED_RESOURCE_TYPE_UNSPECIFIED", + "BIGQUERY_DATASET", + "PUBSUB_TOPIC" + ], + "enumDescriptions": [ + "Not specified.", + "BigQuery Dataset Asset.", + "Pub/Sub Topic Asset." + ], + "readOnly": true, + "type": "string" + }, "state": { "description": "Output only. Current state of the subscription.", "enum": [ @@ -1929,6 +2400,12 @@ } }, "type": "object" + }, + "TextConfig": { + "description": "Configuration for writing message data in text format. Message payloads will be written to files as raw text, separated by a newline.", + "id": "TextConfig", + "properties": {}, + "type": "object" } }, "servicePath": "", diff --git a/discovery/analyticshub-v1beta1.json b/discovery/analyticshub-v1beta1.json index 34e4e43192..8a004a465b 100644 --- a/discovery/analyticshub-v1beta1.json +++ b/discovery/analyticshub-v1beta1.json @@ -695,7 +695,7 @@ } } }, - "revision": "20240122", + "revision": "20240624", "rootUrl": "https://analyticshub.googleapis.com/", "schemas": { "AuditConfig": { @@ -938,6 +938,16 @@ "description": "Output only. Name of the linked dataset, e.g. projects/subscriberproject/datasets/linked_dataset", "readOnly": true, "type": "string" + }, + "linkedPubsubSubscription": { + "description": "Output only. Name of the Pub/Sub subscription, e.g. projects/subscriberproject/subscriptions/subscriptions/sub_id", + "readOnly": true, + "type": "string" + }, + "listing": { + "description": "Output only. Listing for which linked resource is created.", + "readOnly": true, + "type": "string" } }, "type": "object" @@ -1095,7 +1105,7 @@ }, "restrictedExportConfig": { "$ref": "RestrictedExportConfig", - "description": "Optional. If set, restricted export configuration will be propagated and enforced on the linked dataset." + "description": "Optional. If set, restricted export configuration will be propagated and enforced on the linked dataset. This is a required field for data clean room exchanges." }, "state": { "description": "Output only. Current state of the listing.", @@ -1307,6 +1317,14 @@ "readOnly": true, "type": "object" }, + "linkedResources": { + "description": "Output only. Linked resources created in the subscription. Only contains values if state = STATE_ACTIVE.", + "items": { + "$ref": "LinkedResource" + }, + "readOnly": true, + "type": "array" + }, "listing": { "description": "Output only. Resource name of the source Listing. e.g. projects/123/locations/US/dataExchanges/456/listings/789", "readOnly": true, @@ -1327,6 +1345,21 @@ "readOnly": true, "type": "string" }, + "resourceType": { + "description": "Output only. Listing shared asset type.", + "enum": [ + "SHARED_RESOURCE_TYPE_UNSPECIFIED", + "BIGQUERY_DATASET", + "PUBSUB_TOPIC" + ], + "enumDescriptions": [ + "Not specified.", + "BigQuery Dataset Asset.", + "Pub/Sub Topic Asset." + ], + "readOnly": true, + "type": "string" + }, "state": { "description": "Output only. Current state of the subscription.", "enum": [ diff --git a/discovery/assuredworkloads-v1beta1.json b/discovery/assuredworkloads-v1beta1.json index 1019a8e1b6..db1c9697bd 100644 --- a/discovery/assuredworkloads-v1beta1.json +++ b/discovery/assuredworkloads-v1beta1.json @@ -291,31 +291,6 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, - "enableComplianceUpdates": { - "description": "This endpoint enables Assured Workloads service to offer compliance updates for the folder based assured workload. It sets up an Assured Workloads Service Agent, having permissions to read compliance controls (for example: Org Policies) applied on the workload. The caller must have `resourcemanager.folders.getIamPolicy` and `resourcemanager.folders.setIamPolicy` permissions on the assured workload folder.", - "flatPath": "v1beta1/organizations/{organizationsId}/locations/{locationsId}/workloads/{workloadsId}:enableComplianceUpdates", - "httpMethod": "PUT", - "id": "assuredworkloads.organizations.locations.workloads.enableComplianceUpdates", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "Required. The `name` field is used to identify the workload. Format: organizations/{org_id}/locations/{location_id}/workloads/{workload_id}", - "location": "path", - "pattern": "^organizations/[^/]+/locations/[^/]+/workloads/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1beta1/{+name}:enableComplianceUpdates", - "response": { - "$ref": "GoogleCloudAssuredworkloadsV1beta1EnableComplianceUpdatesResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, "enableResourceMonitoring": { "description": "Enable resource violation monitoring for a workload.", "flatPath": "v1beta1/organizations/{organizationsId}/locations/{locationsId}/workloads/{workloadsId}:enableResourceMonitoring", @@ -588,7 +563,7 @@ } } }, - "revision": "20240621", + "revision": "20240617", "rootUrl": "https://assuredworkloads.googleapis.com/", "schemas": { "GoogleCloudAssuredworkloadsV1beta1AcknowledgeViolationRequest": { @@ -756,12 +731,6 @@ }, "type": "object" }, - "GoogleCloudAssuredworkloadsV1beta1EnableComplianceUpdatesResponse": { - "description": "Response for EnableComplianceUpdates endpoint.", - "id": "GoogleCloudAssuredworkloadsV1beta1EnableComplianceUpdatesResponse", - "properties": {}, - "type": "object" - }, "GoogleCloudAssuredworkloadsV1beta1EnableResourceMonitoringResponse": { "description": "Response for EnableResourceMonitoring endpoint.", "id": "GoogleCloudAssuredworkloadsV1beta1EnableResourceMonitoringResponse", @@ -1231,11 +1200,6 @@ "description": "Output only. Count of active Violations in the Workload.", "readOnly": true }, - "complianceUpdatesEnabled": { - "description": "Output only. Indicates whether the compliance updates feature is enabled for a workload. The compliance updates feature can be enabled via the EnableComplianceUpdates endpoint.", - "readOnly": true, - "type": "boolean" - }, "compliantButDisallowedServices": { "description": "Output only. Urls for services which are compliant for this Assured Workload, but which are currently disallowed by the ResourceUsageRestriction org policy. Invoke RestrictAllowedResources endpoint to allow your project developers to use these services in their environment.", "items": { diff --git a/discovery/beyondcorp-v1alpha.json b/discovery/beyondcorp-v1alpha.json index 18a0d263c8..93237a02f0 100644 --- a/discovery/beyondcorp-v1alpha.json +++ b/discovery/beyondcorp-v1alpha.json @@ -1323,7 +1323,7 @@ ], "parameters": { "name": { - "description": "Required. Unique resource name of the Subscription. The name is ignored when creating a subscription.", + "description": "Identifier. Unique resource name of the Subscription. The name is ignored when creating a subscription.", "location": "path", "pattern": "^organizations/[^/]+/locations/[^/]+/subscriptions/[^/]+$", "required": true, @@ -4080,7 +4080,7 @@ } } }, - "revision": "20240612", + "revision": "20240619", "rootUrl": "https://beyondcorp.googleapis.com/", "schemas": { "AllocatedConnection": { @@ -5693,6 +5693,10 @@ "readOnly": true, "type": "string" }, + "proxyProtocolConfig": { + "$ref": "GoogleCloudBeyondcorpPartnerservicesV1alphaProxyProtocolConfig", + "description": "Optional. Protocol config data for the Proxy." + }, "proxyUri": { "description": "Required. The URI of the proxy server.", "type": "string" @@ -5714,6 +5718,20 @@ }, "type": "object" }, + "GoogleCloudBeyondcorpPartnerservicesV1alphaProxyProtocolConfig": { + "description": "The protocol data that specifies how to communicate with Partner's Proxy.", + "id": "GoogleCloudBeyondcorpPartnerservicesV1alphaProxyProtocolConfig", + "properties": { + "metadata": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Untyped property bag to be sent back to the proxy using client specific mechanism.", + "type": "object" + } + }, + "type": "object" + }, "GoogleCloudBeyondcorpPartnerservicesV1alphaRoutingInfo": { "description": "Message contains the routing information to direct traffic to the proxy server.", "id": "GoogleCloudBeyondcorpPartnerservicesV1alphaRoutingInfo", @@ -6159,7 +6177,7 @@ "type": "string" }, "name": { - "description": "Required. Unique resource name of the Subscription. The name is ignored when creating a subscription.", + "description": "Identifier. Unique resource name of the Subscription. The name is ignored when creating a subscription.", "type": "string" }, "seatCount": { diff --git a/discovery/chat-v1.json b/discovery/chat-v1.json index f4f1f88f2f..19952f69e6 100644 --- a/discovery/chat-v1.json +++ b/discovery/chat-v1.json @@ -433,7 +433,7 @@ "type": "string" }, "updateMask": { - "description": "Required. The updated field paths, comma separated if there are multiple. Currently supported field paths: - `display_name` (Only supports changing the display name of a space with the `SPACE` type, or when also including the `space_type` mask to change a `GROUP_CHAT` space type to `SPACE`. Trying to update the display name of a `GROUP_CHAT` or a `DIRECT_MESSAGE` space results in an invalid argument error. If you receive the error message `ALREADY_EXISTS` when updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name.) - `space_type` (Only supports changing a `GROUP_CHAT` space type to `SPACE`. Include `display_name` together with `space_type` in the update mask and ensure that the specified space has a non-empty display name and the `SPACE` space type. Including the `space_type` mask and the `SPACE` type in the specified space when updating the display name is optional if the existing space already has the `SPACE` type. Trying to update the space type in other ways results in an invalid argument error). `space_type` is not supported with admin access. - `space_details` - `space_history_state` (Supports [turning history on or off for the space](https://support.google.com/chat/answer/7664687) if [the organization allows users to change their history setting](https://support.google.com/a/answer/7664184). Warning: mutually exclusive with all other field paths.) `space_history_state` is not supported with admin access. - Developer Preview: `access_settings.audience` (Supports changing the [access setting](https://support.google.com/chat/answer/11971020) of a space. If no audience is specified in the access setting, the space's access setting is updated to restricted. Warning: mutually exclusive with all other field paths.) `access_settings.audience` is not supported with admin access. - Developer Preview: Supports changing the [permission settings](https://support.google.com/chat/answer/13340792) of a space, supported field paths include: `permission_settings.manage_members_and_groups`, `permission_settings.modify_space_details`, `permission_settings.toggle_history`, `permission_settings.use_at_mention_all`, `permission_settings.manage_apps`, `permission_settings.manage_webhooks`, `permission_settings.reply_messages` (Warning: mutually exclusive with all other non-permission settings field paths). `permission_settings` is not supported with admin access.", + "description": "Required. The updated field paths, comma separated if there are multiple. Currently supported field paths: - `display_name` (Only supports changing the display name of a space with the `SPACE` type, or when also including the `space_type` mask to change a `GROUP_CHAT` space type to `SPACE`. Trying to update the display name of a `GROUP_CHAT` or a `DIRECT_MESSAGE` space results in an invalid argument error. If you receive the error message `ALREADY_EXISTS` when updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name.) - `space_type` (Only supports changing a `GROUP_CHAT` space type to `SPACE`. Include `display_name` together with `space_type` in the update mask and ensure that the specified space has a non-empty display name and the `SPACE` space type. Including the `space_type` mask and the `SPACE` type in the specified space when updating the display name is optional if the existing space already has the `SPACE` type. Trying to update the space type in other ways results in an invalid argument error). `space_type` is not supported with admin access. - `space_details` - `space_history_state` (Supports [turning history on or off for the space](https://support.google.com/chat/answer/7664687) if [the organization allows users to change their history setting](https://support.google.com/a/answer/7664184). Warning: mutually exclusive with all other field paths.) `space_history_state` is not supported with admin access. - `access_settings.audience` (Supports changing the [access setting](https://support.google.com/chat/answer/11971020) of who can discover the space, join the space, and preview the messages in space. If no audience is specified in the access setting, the space's access setting is updated to private. Warning: mutually exclusive with all other field paths.) `access_settings.audience` is not supported with admin access. - Developer Preview: Supports changing the [permission settings](https://support.google.com/chat/answer/13340792) of a space, supported field paths include: `permission_settings.manage_members_and_groups`, `permission_settings.modify_space_details`, `permission_settings.toggle_history`, `permission_settings.use_at_mention_all`, `permission_settings.manage_apps`, `permission_settings.manage_webhooks`, `permission_settings.reply_messages` (Warning: mutually exclusive with all other non-permission settings field paths). `permission_settings` is not supported with admin access.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -453,7 +453,7 @@ ] }, "setup": { - "description": "Creates a space and adds specified users to it. The calling user is automatically added to the space, and shouldn't be specified as a membership in the request. For an example, see [Set up a space with initial members](https://developers.google.com/workspace/chat/set-up-spaces). To specify the human members to add, add memberships with the appropriate `membership.member.name`. To add a human user, use `users/{user}`, where `{user}` can be the email address for the user. For users in the same Workspace organization `{user}` can also be the `id` for the person from the People API, or the `id` for the user in the Directory API. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can add the user to the space by setting the `membership.member.name` to `users/user@example.com` or `users/123456789`. For a named space or group chat, if the caller blocks, or is blocked by some members, or doesn't have permission to add some members, then those members aren't added to the created space. To create a direct message (DM) between the calling user and another human user, specify exactly one membership to represent the human user. If one user blocks the other, the request fails and the DM isn't created. To create a DM between the calling user and the calling app, set `Space.singleUserBotDm` to `true` and don't specify any memberships. You can only use this method to set up a DM with the calling app. To add the calling app as a member of a space or an existing DM between two human users, see [Invite or add a user or app to a space](https://developers.google.com/workspace/chat/create-members). If a DM already exists between two users, even when one user blocks the other at the time a request is made, then the existing DM is returned. Spaces with threaded replies aren't supported. If you receive the error message `ALREADY_EXISTS` when setting up a space, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).", + "description": "Creates a space and adds specified users to it. The calling user is automatically added to the space, and shouldn't be specified as a membership in the request. For an example, see [Set up a space with initial members](https://developers.google.com/workspace/chat/set-up-spaces). To specify the human members to add, add memberships with the appropriate `membership.member.name`. To add a human user, use `users/{user}`, where `{user}` can be the email address for the user. For users in the same Workspace organization `{user}` can also be the `id` for the person from the People API, or the `id` for the user in the Directory API. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can add the user to the space by setting the `membership.member.name` to `users/user@example.com` or `users/123456789`. To specify the Google groups to add, add memberships with the appropriate `membership.group_member.name`. To add or invite a Google group, use `groups/{group}`, where `{group}` is the `id` for the group from the Cloud Identity Groups API. For example, you can use [Cloud Identity Groups lookup API](https://cloud.google.com/identity/docs/reference/rest/v1/groups/lookup) to retrieve the ID `123456789` for group email `group@example.com`, then you can add the group to the space by setting the `membership.group_member.name` to `groups/123456789`. Group email is not supported, and Google groups can only be added as members in named spaces. For a named space or group chat, if the caller blocks, or is blocked by some members, or doesn't have permission to add some members, then those members aren't added to the created space. To create a direct message (DM) between the calling user and another human user, specify exactly one membership to represent the human user. If one user blocks the other, the request fails and the DM isn't created. To create a DM between the calling user and the calling app, set `Space.singleUserBotDm` to `true` and don't specify any memberships. You can only use this method to set up a DM with the calling app. To add the calling app as a member of a space or an existing DM between two human users, see [Invite or add a user or app to a space](https://developers.google.com/workspace/chat/create-members). If a DM already exists between two users, even when one user blocks the other at the time a request is made, then the existing DM is returned. Spaces with threaded replies aren't supported. If you receive the error message `ALREADY_EXISTS` when setting up a space, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).", "flatPath": "v1/spaces:setup", "httpMethod": "POST", "id": "chat.spaces.setup", @@ -476,7 +476,7 @@ "members": { "methods": { "create": { - "description": "Creates a human membership or app membership for the calling app. Creating memberships for other apps isn't supported. For an example, see [Invite or add a user or a Google Chat app to a space](https://developers.google.com/workspace/chat/create-members). When creating a membership, if the specified member has their auto-accept policy turned off, then they're invited, and must accept the space invitation before joining. Otherwise, creating a membership adds the member directly to the specified space. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). To specify the member to add, set the `membership.member.name` for the human or app member. - To add the calling app to a space or a direct message between two human users, use `users/app`. Unable to add other apps to the space. - To add a human user, use `users/{user}`, where `{user}` can be the email address for the user. For users in the same Workspace organization `{user}` can also be the `id` for the person from the People API, or the `id` for the user in the Directory API. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can add the user to the space by setting the `membership.member.name` to `users/user@example.com` or `users/123456789`.", + "description": "Creates a human membership or app membership for the calling app. Creating memberships for other apps isn't supported. For an example, see [Invite or add a user or a Google Chat app to a space](https://developers.google.com/workspace/chat/create-members). When creating a membership, if the specified member has their auto-accept policy turned off, then they're invited, and must accept the space invitation before joining. Otherwise, creating a membership adds the member directly to the specified space. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). To specify the member to add, set the `membership.member.name` for the human or app member, or set the `membership.group_member.name` for the group member. - To add the calling app to a space or a direct message between two human users, use `users/app`. Unable to add other apps to the space. - To add a human user, use `users/{user}`, where `{user}` can be the email address for the user. For users in the same Workspace organization `{user}` can also be the `id` for the person from the People API, or the `id` for the user in the Directory API. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can add the user to the space by setting the `membership.member.name` to `users/user@example.com` or `users/123456789`. - To add or invite a Google group in a named space, use `groups/{group}`, where `{group}` is the `id` for the group from the Cloud Identity Groups API. For example, you can use [Cloud Identity Groups lookup API](https://cloud.google.com/identity/docs/reference/rest/v1/groups/lookup) to retrieve the ID `123456789` for group email `group@example.com`, then you can add or invite the group to a named space by setting the `membership.group_member.name` to `groups/123456789`. Group email is not supported, and Google groups can only be added as members in named spaces.", "flatPath": "v1/spaces/{spacesId}/members", "httpMethod": "POST", "id": "chat.spaces.members.create", @@ -1241,9 +1241,35 @@ } } }, - "revision": "20240623", + "revision": "20240625", "rootUrl": "https://chat.googleapis.com/", "schemas": { + "AccessSettings": { + "description": "Represents the [access setting](https://support.google.com/chat/answer/11971020) of the space.", + "id": "AccessSettings", + "properties": { + "accessState": { + "description": "Output only. Indicates the access state of the space.", + "enum": [ + "ACCESS_STATE_UNSPECIFIED", + "PRIVATE", + "DISCOVERABLE" + ], + "enumDescriptions": [ + "Access state is unknown or not supported in this API.", + "Space is discoverable by added or invited members or groups.", + "Space is discoverable by the selected [target audience](https://support.google.com/a/answer/9934697), as well as added or invited members or groups." + ], + "readOnly": true, + "type": "string" + }, + "audience": { + "description": "Optional. The resource name of the [target audience](https://support.google.com/a/answer/9934697) who can discover the space, join the space, and preview the messages in the space. For details, see [Make a space discoverable to a target audience](https://developers.google.com/workspace/chat/space-target-audience). Format: `audiences/{audience}` To use the default target audience for the Google Workspace organization, set to `audiences/default`.", + "type": "string" + } + }, + "type": "object" + }, "AccessoryWidget": { "description": "One or more interactive widgets that appear at the bottom of a message. For details, see [Add interactive widgets at the bottom of a message](https://developers.google.com/workspace/chat/create-messages#add-accessory-widgets).", "id": "AccessoryWidget", @@ -2282,7 +2308,7 @@ "type": "object" }, "GoogleAppsCardV1Column": { - "description": "A column. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend): Columns for Google Workspace Add-ons are in Developer Preview.", + "description": "A column. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend)", "id": "GoogleAppsCardV1Column", "properties": { "horizontalAlignment": { @@ -3039,7 +3065,7 @@ "type": "object" }, "GoogleAppsCardV1Widgets": { - "description": "The supported widgets that you can include in a column. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend): Columns for Google Workspace Add-ons are in Developer Preview.", + "description": "The supported widgets that you can include in a column. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend)", "id": "GoogleAppsCardV1Widgets", "properties": { "buttonList": { @@ -3461,7 +3487,7 @@ }, "groupMember": { "$ref": "Group", - "description": "The Google Group the membership corresponds to. Only supports read operations. Other operations, like creating or updating a membership, aren't currently supported." + "description": "The Google Group the membership corresponds to." }, "member": { "$ref": "User", @@ -3982,7 +4008,7 @@ "id": "SetUpSpaceRequest", "properties": { "memberships": { - "description": "Optional. The Google Chat users to invite to join the space. Omit the calling user, as they are added automatically. The set currently allows up to 20 memberships (in addition to the caller). For human membership, the `Membership.member` field must contain a `user` with `name` populated (format: `users/{user}`) and `type` set to `User.Type.HUMAN`. You can only add human users when setting up a space (adding Chat apps is only supported for direct message setup with the calling app). You can also add members using the user's email as an alias for {user}. For example, the `user.name` can be `users/example@gmail.com`. To invite Gmail users or users from external Google Workspace domains, user's email must be used for `{user}`. Optional when setting `Space.spaceType` to `SPACE`. Required when setting `Space.spaceType` to `GROUP_CHAT`, along with at least two memberships. Required when setting `Space.spaceType` to `DIRECT_MESSAGE` with a human user, along with exactly one membership. Must be empty when creating a 1:1 conversation between a human and the calling Chat app (when setting `Space.spaceType` to `DIRECT_MESSAGE` and `Space.singleUserBotDm` to `true`).", + "description": "Optional. The Google Chat users or groups to invite to join the space. Omit the calling user, as they are added automatically. The set currently allows up to 20 memberships (in addition to the caller). For human membership, the `Membership.member` field must contain a `user` with `name` populated (format: `users/{user}`) and `type` set to `User.Type.HUMAN`. You can only add human users when setting up a space (adding Chat apps is only supported for direct message setup with the calling app). You can also add members using the user's email as an alias for {user}. For example, the `user.name` can be `users/example@gmail.com`. To invite Gmail users or users from external Google Workspace domains, user's email must be used for `{user}`. For Google group membership, the `Membership.group_member` field must contain a `group` with `name` populated (format `groups/{group}`). You can only add Google groups when setting `Space.spaceType` to `SPACE`. Optional when setting `Space.spaceType` to `SPACE`. Required when setting `Space.spaceType` to `GROUP_CHAT`, along with at least two memberships. Required when setting `Space.spaceType` to `DIRECT_MESSAGE` with a human user, along with exactly one membership. Must be empty when creating a 1:1 conversation between a human and the calling Chat app (when setting `Space.spaceType` to `DIRECT_MESSAGE` and `Space.singleUserBotDm` to `true`).", "items": { "$ref": "Membership" }, @@ -4053,6 +4079,10 @@ "description": "A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app.", "id": "Space", "properties": { + "accessSettings": { + "$ref": "AccessSettings", + "description": "Optional. Specifies the [access setting](https://support.google.com/chat/answer/11971020) of the space. Only populated when the `space_type` is `SPACE`." + }, "adminInstalled": { "description": "Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.", "readOnly": true, @@ -4134,6 +4164,11 @@ ], "type": "string" }, + "spaceUri": { + "description": "Output only. The URI for a user to access the space.", + "readOnly": true, + "type": "string" + }, "threaded": { "deprecated": true, "description": "Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages are threaded in this space.", diff --git a/discovery/checks-v1alpha.json b/discovery/checks-v1alpha.json index 1ab2da7718..31ab3bf79d 100644 --- a/discovery/checks-v1alpha.json +++ b/discovery/checks-v1alpha.json @@ -414,7 +414,7 @@ } } }, - "revision": "20240430", + "revision": "20240627", "rootUrl": "https://checks.googleapis.com/", "schemas": { "CancelOperationRequest": { @@ -674,7 +674,8 @@ "DATA_MONITORING_ENDPOINTS_DENYLIST_VIOLATION", "DATA_MONITORING_OUTDATED_SDK_VERSION", "DATA_MONITORING_CRITICAL_SDK_ISSUE", - "PRIVACY_POLICY_DATA_TYPE_SENSITIVE_INFO" + "PRIVACY_POLICY_DATA_TYPE_SENSITIVE_INFO", + "DATA_MONITORING_PII_LOGCAT_LEAK" ], "enumDescriptions": [ "Not specified.", @@ -764,7 +765,8 @@ "Checks if any endpoints were detected that are specified in the denylist.", "Checks if there are any outdated SDKs.", "Checks if there are any SDKs with critical issues.", - "Checks if the Sensitive Information data type declaration matches usage." + "Checks if the Sensitive Information data type declaration matches usage.", + "Checks if there were any PII leaked to device logs." ], "type": "string" } diff --git a/discovery/chromemanagement-v1.json b/discovery/chromemanagement-v1.json index c82d0884f4..91180ad8d2 100644 --- a/discovery/chromemanagement-v1.json +++ b/discovery/chromemanagement-v1.json @@ -1172,7 +1172,7 @@ } } }, - "revision": "20240604", + "revision": "20240627", "rootUrl": "https://chromemanagement.googleapis.com/", "schemas": { "GoogleChromeManagementV1AndroidAppInfo": { @@ -3681,7 +3681,8 @@ "APPLICATION_LAUNCH_SOURCE_INSTALLER", "APPLICATION_LAUNCH_SOURCE_FIRST_RUN", "APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR", - "APPLICATION_LAUNCH_SOURCE_FOCUS_MODE" + "APPLICATION_LAUNCH_SOURCE_FOCUS_MODE", + "APPLICATION_LAUNCH_SOURCE_SPARKY" ], "enumDescriptions": [ "Application launch source unknown.", @@ -3724,7 +3725,8 @@ "Application launched from source installer.", "Count first-run Help app launches separately so that we can understand the number of user-triggered launches.", "Application launched from welcome tour.", - "Applicationed launched from focus panel." + "Applicationed launched from focus panel.", + "Application launched from experimental feature Sparky." ], "type": "string" }, diff --git a/discovery/compute-alpha.json b/discovery/compute-alpha.json index fdd791c44c..d06cf7ddfb 100644 --- a/discovery/compute-alpha.json +++ b/discovery/compute-alpha.json @@ -28596,6 +28596,204 @@ } } }, + "regionMultiMigs": { + "methods": { + "delete": { + "description": "Deletes a regional multiMIG in the specified project.", + "flatPath": "projects/{project}/regions/{region}/multiMigs/{multiMig}", + "httpMethod": "DELETE", + "id": "compute.regionMultiMigs.delete", + "parameterOrder": [ + "project", + "region", + "multiMig" + ], + "parameters": { + "multiMig": { + "description": "Name of the multiMIG to delete.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/multiMigs/{multiMig}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "get": { + "description": "Returns the specified MultiMIG resource.", + "flatPath": "projects/{project}/regions/{region}/multiMigs/{multiMig}", + "httpMethod": "GET", + "id": "compute.regionMultiMigs.get", + "parameterOrder": [ + "project", + "region", + "multiMig" + ], + "parameters": { + "multiMig": { + "description": "Name of the MultiMig resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/multiMigs/{multiMig}", + "response": { + "$ref": "MultiMig" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "insert": { + "description": "Creates a regional multiMIG in the specified project.", + "flatPath": "projects/{project}/regions/{region}/multiMigs", + "httpMethod": "POST", + "id": "compute.regionMultiMigs.insert", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/multiMigs", + "request": { + "$ref": "MultiMig" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "list": { + "description": "Retrieves a list of MultiMIGs in a project and region.", + "flatPath": "projects/{project}/regions/{region}/multiMigs", + "httpMethod": "GET", + "id": "compute.regionMultiMigs.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/multiMigs", + "response": { + "$ref": "MultiMigsList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + } + } + }, "regionNetworkEndpointGroups": { "methods": { "attachNetworkEndpoints": { @@ -38770,7 +38968,7 @@ ] }, "update": { - "description": "Updates the specified storagePool with the data included in the request. The update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: size_tb and provisioned_iops.", + "description": "Updates the specified storagePool with the data included in the request. The update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: pool_provisioned_capacity_gb, pool_provisioned_iops and pool_provisioned_throughput.", "flatPath": "projects/{project}/zones/{zone}/storagePools/{storagePool}", "httpMethod": "PATCH", "id": "compute.storagePools.update", @@ -44517,7 +44715,7 @@ } } }, - "revision": "20240604", + "revision": "20240618", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -45903,6 +46101,26 @@ }, "type": "object" }, + "AllocationReservationSharingPolicy": { + "id": "AllocationReservationSharingPolicy", + "properties": { + "serviceShareType": { + "description": "Sharing config for all Google Cloud services.", + "enum": [ + "ALLOW_ALL", + "DISALLOW_ALL", + "SERVICE_SHARE_TYPE_UNSPECIFIED" + ], + "enumDescriptions": [ + "Allow all Google Cloud managed services to share reservations.", + "[Default] Disallow sharing with all Google Cloud services.", + "" + ], + "type": "string" + } + }, + "type": "object" + }, "AllocationResourceStatus": { "description": "[Output Only] Contains output only fields.", "id": "AllocationResourceStatus", @@ -59961,6 +60179,20 @@ "$ref": "InstanceGroupManagerInstanceLifecyclePolicyMetadataBasedReadinessSignal", "deprecated": true, "description": "The configuration for metadata based readiness signal sent by the instance during initialization when stopping / suspending an instance. The Instance Group Manager will wait for a signal that indicates successful initialization before stopping / suspending an instance. If a successful readiness signal is not sent before timeout, the corresponding instance will not be stopped / suspended. Instead, an error will be visible in the lastAttempt.errors field of the managed instance in the listmanagedinstances method. If metadataBasedReadinessSignal.timeoutSec is unset, the Instance Group Manager will directly proceed to suspend / stop instances, skipping initialization on them." + }, + "onFailedHealthCheck": { + "description": "The action that a MIG performs on an unhealthy VM. A VM is marked as unhealthy when the application running on that VM fails a health check. Valid values are: - DEFAULT_ACTION (default): The MIG performs the same action as specified in the instanceLifecyclePolicy.defaultActionOnFailure field. If the defaultActionOnFailure field is set to REPAIR, then the MIG repairs unhealthy VMs. If the defaultActionOnFailure field is set to DO_NOTHING, then the MIG doesn't repair unhealthy VMs. - REPAIR: The MIG repairs unhealthy VMs by recreating it. - DO_NOTHING: The MIG doesn't repair unhealthy VMs. For more information, see About repairing VMs in a MIG. ", + "enum": [ + "DEFAULT_ACTION", + "DO_NOTHING", + "REPAIR" + ], + "enumDescriptions": [ + "(Default) The MIG performs the same action as specified in the instanceLifecyclePolicy.defaultActionOnFailure field. If the defaultActionOnFailure field is set to REPAIR, then the MIG repairs unhealthy VMs. If the defaultActionOnFailure field is set to DO_NOTHING, then the MIG doesn't repair unhealthy VMs.", + "The MIG doesn't repair unhealthy VMs.", + "The MIG repairs unhealthy VMs by recreating it." + ], + "type": "string" } }, "type": "object" @@ -62148,7 +62380,7 @@ "compute.instanceTemplates.insert" ] }, - "description": "The machine type to use for instances that are created from these properties. This field only accept machine types name. e.g. n2-standard-4 and does not accept machine type full or partial url. e.g. projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4 will throw INTERNAL_ERROR.", + "description": "The machine type to use for instances that are created from these properties. This field only accepts a machine type name, for example `n2-standard-4`. If you use the machine type full or partial URL, for example `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`, the request will result in an `INTERNAL_ERROR`.", "type": "string" }, "metadata": { @@ -64111,7 +64343,7 @@ "type": "object" }, "InterconnectApplicationAwareInterconnectBandwidthPercentage": { - "description": "Specify bandwidth percentages (0-100) for various traffic classes in BandwidthPercentagePolicy. The sum of all percentages must equal 100. It is valid to specify percentages for some classes and not for others. The others will be implicitly marked as 0.", + "description": "Specify bandwidth percentages [1-100] for various traffic classes in BandwidthPercentagePolicy. The sum of all percentages must equal 100. All traffic classes must have a percentage value specified.", "id": "InterconnectApplicationAwareInterconnectBandwidthPercentage", "properties": { "percentage": { @@ -68360,6 +68592,271 @@ }, "type": "object" }, + "MultiMig": { + "description": "MultiMIG represents a group of Managed Instance Groups.", + "id": "MultiMig", + "properties": { + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "format": "uint64", + "type": "string" + }, + "kind": { + "default": "compute#multiMig", + "description": "[Output Only] Type of the resource. Always compute#multiMig for MultiMIGs.", + "type": "string" + }, + "locationPolicy": { + "$ref": "MultiMigLocationPolicy" + }, + "name": { + "description": "Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "parts": { + "additionalProperties": { + "$ref": "MultiMigPart" + }, + "description": "User-provided names for Parts of MultiMIG and the Parts themselves.", + "type": "object" + }, + "region": { + "description": "[Output Only] URL of the region where the resource resides. Only applicable for regional resources. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", + "type": "string" + }, + "schedulingPolicy": { + "$ref": "MultiMigSchedulingPolicy", + "description": "Policy for handling provisioning and other scheduling-related events." + }, + "selfLink": { + "description": "[Output only] Server-defined URL for the resource.", + "type": "string" + }, + "selfLinkWithId": { + "description": "[Output Only] Server-defined URL for this resource with the resource id.", + "type": "string" + } + }, + "type": "object" + }, + "MultiMigLocationPolicy": { + "description": "Policy regarding where to create MIGs Initially only zonal MIGs in the same zone are supported.", + "id": "MultiMigLocationPolicy", + "properties": { + "provisioningZones": { + "description": "List of zones where MIGs will be provisioned. Should be valid RFC1035 name", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "MultiMigPart": { + "description": "Config for an MMIG part.", + "id": "MultiMigPart", + "properties": { + "instanceGroupManager": { + "description": "Link to an existing InstanceGroupManager that will be adopted by a MultiMIG.", + "type": "string" + }, + "instanceGroupManagerProperties": { + "$ref": "InstanceGroupManager", + "description": "InstanceGroupManager to be created by the multiMig" + } + }, + "type": "object" + }, + "MultiMigSchedulingPolicy": { + "description": "Policy for handling provisioning and other scheduling-related events.", + "id": "MultiMigSchedulingPolicy", + "properties": { + "provisioning": { + "description": "How provisioning of MIGs should be scheduled (coordinated or not)", + "enum": [ + "ANY", + "COOORDINATED" + ], + "enumDescriptions": [ + "Allows idependent lifecycles of parts.", + "Requires all parts at the same time." + ], + "type": "string" + } + }, + "type": "object" + }, + "MultiMigsList": { + "id": "MultiMigsList", + "properties": { + "etag": { + "type": "string" + }, + "id": { + "description": "Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of MultiMig resources.", + "items": { + "$ref": "MultiMig" + }, + "type": "array" + }, + "kind": { + "default": "compute#multiMigList", + "description": "Type of resource.", + "type": "string" + }, + "nextPageToken": { + "description": "This token allows you to get the next page of results for maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output only] Server-defined URL for this resource.", + "type": "string" + }, + "unreachables": { + "description": "[Output only] Unreachable resources.", + "items": { + "type": "string" + }, + "type": "array" + }, + "warning": { + "description": "Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "type": "string" + }, + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", + "type": "string" + } + }, + "type": "object" + } + }, + "type": "object" + }, "MutualTls": { "description": "[Deprecated] Configuration for the mutual Tls mode for peer authentication. Configuration for the mutual Tls mode for peer authentication.", "id": "MutualTls", @@ -80801,6 +81298,10 @@ "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "type": "string" }, + "reservationSharingPolicy": { + "$ref": "AllocationReservationSharingPolicy", + "description": "Specify the reservation sharing policy. If unspecified, the reservation will not be shared with Google Cloud managed services." + }, "resourcePolicies": { "additionalProperties": { "type": "string" @@ -82564,7 +83065,7 @@ "type": "string" }, "nextHopIlb": { - "description": "The URL to a forwarding rule of type loadBalancingScheme=INTERNAL that should handle matching packets or the IP address of the forwarding Rule. For example, the following are all valid URLs: - 10.128.0.56 - https://www.googleapis.com/compute/v1/projects/project/regions/region /forwardingRules/forwardingRule - regions/region/forwardingRules/forwardingRule ", + "description": "The URL to a forwarding rule of type loadBalancingScheme=INTERNAL that should handle matching packets or the IP address of the forwarding Rule. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/project/regions/region /forwardingRules/forwardingRule - regions/region/forwardingRules/forwardingRule If an IP address is provided, must specify an IPv4 address in dot-decimal notation or an IPv6 address in RFC 4291 format. For example, the following are all valid IP addresses: - 10.128.0.56 - 2001:db8::2d9:51:0:0 - 2001:db8:0:0:2d9:51:0:0 IPv6 addresses will be displayed using RFC 5952 compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address.", "type": "string" }, "nextHopInstance": { @@ -84044,7 +84545,7 @@ "type": "string" }, "match": { - "description": "CEL expression that specifies the match condition that egress traffic from a VM is evaluated against. If it evaluates to true, the corresponding `action` is enforced. The following examples are valid match expressions for public NAT: \"inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, '2.2.0.0/16')\" \"destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'\" The following example is a valid match expression for private NAT: \"nexthop.hub == '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'\"", + "description": "CEL expression that specifies the match condition that egress traffic from a VM is evaluated against. If it evaluates to true, the corresponding `action` is enforced. The following examples are valid match expressions for public NAT: `inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, '2.2.0.0/16')` `destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'` The following example is a valid match expression for private NAT: `nexthop.hub == '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'`", "type": "string" }, "ruleNumber": { @@ -84128,14 +84629,14 @@ "id": "RouterStatus", "properties": { "bestRoutes": { - "description": "Best routes for this router's network.", + "description": "A list of the best dynamic routes for this Cloud Router's Virtual Private Cloud (VPC) network in the same region as this Cloud Router. Lists all of the best routes per prefix that are programmed into this region's VPC data plane. When global dynamic routing mode is turned on in the VPC network, this list can include cross-region dynamic routes from Cloud Routers in other regions.", "items": { "$ref": "Route" }, "type": "array" }, "bestRoutesForRouter": { - "description": "Best routes learned by this router.", + "description": "A list of the best BGP routes learned by this Cloud Router. It is possible that routes listed might not be programmed into the data plane, if the Google Cloud control plane finds a more optimal route for a prefix than a route learned by this Cloud Router.", "items": { "$ref": "Route" }, @@ -90615,7 +91116,12 @@ "type": "string" }, "poolProvisionedCapacityGb": { - "description": "Size, in GiB, of the storage pool.", + "annotations": { + "required": [ + "compute.storagePools.insert" + ] + }, + "description": "Size, in GiB, of the storage pool. For more information about the size limits, see https://cloud.google.com/compute/docs/disks/storage-pools.", "format": "int64", "type": "string" }, @@ -91292,7 +91798,7 @@ "type": "string" }, "poolUsedIops": { - "description": "Sum of all the disks' provisioned IOPS, minus some amount that is allowed per disk that is not counted towards pool's IOPS capacity.", + "description": "[Output Only] Sum of all the disks' provisioned IOPS, minus some amount that is allowed per disk that is not counted towards pool's IOPS capacity. For more information, see https://cloud.google.com/compute/docs/disks/storage-pools.", "format": "int64", "type": "string" }, diff --git a/discovery/compute-beta.json b/discovery/compute-beta.json index 55ef3790eb..4e768d5c6f 100644 --- a/discovery/compute-beta.json +++ b/discovery/compute-beta.json @@ -36142,7 +36142,7 @@ ] }, "update": { - "description": "Updates the specified storagePool with the data included in the request. The update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: size_tb and provisioned_iops.", + "description": "Updates the specified storagePool with the data included in the request. The update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: pool_provisioned_capacity_gb, pool_provisioned_iops and pool_provisioned_throughput.", "flatPath": "projects/{project}/zones/{zone}/storagePools/{storagePool}", "httpMethod": "PATCH", "id": "compute.storagePools.update", @@ -41579,7 +41579,7 @@ } } }, - "revision": "20240604", + "revision": "20240618", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -57977,7 +57977,7 @@ "compute.instanceTemplates.insert" ] }, - "description": "The machine type to use for instances that are created from these properties. This field only accept machine types name. e.g. n2-standard-4 and does not accept machine type full or partial url. e.g. projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4 will throw INTERNAL_ERROR.", + "description": "The machine type to use for instances that are created from these properties. This field only accepts a machine type name, for example `n2-standard-4`. If you use the machine type full or partial URL, for example `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`, the request will result in an `INTERNAL_ERROR`.", "type": "string" }, "metadata": { @@ -75111,7 +75111,7 @@ "type": "string" }, "nextHopIlb": { - "description": "The URL to a forwarding rule of type loadBalancingScheme=INTERNAL that should handle matching packets or the IP address of the forwarding Rule. For example, the following are all valid URLs: - 10.128.0.56 - https://www.googleapis.com/compute/v1/projects/project/regions/region /forwardingRules/forwardingRule - regions/region/forwardingRules/forwardingRule ", + "description": "The URL to a forwarding rule of type loadBalancingScheme=INTERNAL that should handle matching packets or the IP address of the forwarding Rule. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/project/regions/region /forwardingRules/forwardingRule - regions/region/forwardingRules/forwardingRule If an IP address is provided, must specify an IPv4 address in dot-decimal notation or an IPv6 address in RFC 4291 format. For example, the following are all valid IP addresses: - 10.128.0.56 - 2001:db8::2d9:51:0:0 - 2001:db8:0:0:2d9:51:0:0 IPv6 addresses will be displayed using RFC 5952 compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address.", "type": "string" }, "nextHopInstance": { @@ -76518,7 +76518,7 @@ "type": "string" }, "match": { - "description": "CEL expression that specifies the match condition that egress traffic from a VM is evaluated against. If it evaluates to true, the corresponding `action` is enforced. The following examples are valid match expressions for public NAT: \"inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, '2.2.0.0/16')\" \"destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'\" The following example is a valid match expression for private NAT: \"nexthop.hub == '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'\"", + "description": "CEL expression that specifies the match condition that egress traffic from a VM is evaluated against. If it evaluates to true, the corresponding `action` is enforced. The following examples are valid match expressions for public NAT: `inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, '2.2.0.0/16')` `destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'` The following example is a valid match expression for private NAT: `nexthop.hub == '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'`", "type": "string" }, "ruleNumber": { @@ -76602,14 +76602,14 @@ "id": "RouterStatus", "properties": { "bestRoutes": { - "description": "Best routes for this router's network.", + "description": "A list of the best dynamic routes for this Cloud Router's Virtual Private Cloud (VPC) network in the same region as this Cloud Router. Lists all of the best routes per prefix that are programmed into this region's VPC data plane. When global dynamic routing mode is turned on in the VPC network, this list can include cross-region dynamic routes from Cloud Routers in other regions.", "items": { "$ref": "Route" }, "type": "array" }, "bestRoutesForRouter": { - "description": "Best routes learned by this router.", + "description": "A list of the best BGP routes learned by this Cloud Router. It is possible that routes listed might not be programmed into the data plane, if the Google Cloud control plane finds a more optimal route for a prefix than a route learned by this Cloud Router.", "items": { "$ref": "Route" }, @@ -82295,7 +82295,12 @@ "type": "string" }, "poolProvisionedCapacityGb": { - "description": "Size, in GiB, of the storage pool.", + "annotations": { + "required": [ + "compute.storagePools.insert" + ] + }, + "description": "Size, in GiB, of the storage pool. For more information about the size limits, see https://cloud.google.com/compute/docs/disks/storage-pools.", "format": "int64", "type": "string" }, @@ -82937,7 +82942,7 @@ "type": "string" }, "poolUsedIops": { - "description": "Sum of all the disks' provisioned IOPS, minus some amount that is allowed per disk that is not counted towards pool's IOPS capacity.", + "description": "[Output Only] Sum of all the disks' provisioned IOPS, minus some amount that is allowed per disk that is not counted towards pool's IOPS capacity. For more information, see https://cloud.google.com/compute/docs/disks/storage-pools.", "format": "int64", "type": "string" }, diff --git a/discovery/compute-v1.json b/discovery/compute-v1.json index f68dab7595..9518b041c9 100644 --- a/discovery/compute-v1.json +++ b/discovery/compute-v1.json @@ -32401,7 +32401,7 @@ ] }, "update": { - "description": "Updates the specified storagePool with the data included in the request. The update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: size_tb and provisioned_iops.", + "description": "Updates the specified storagePool with the data included in the request. The update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: pool_provisioned_capacity_gb, pool_provisioned_iops and pool_provisioned_throughput.", "flatPath": "projects/{project}/zones/{zone}/storagePools/{storagePool}", "httpMethod": "PATCH", "id": "compute.storagePools.update", @@ -37421,7 +37421,7 @@ } } }, - "revision": "20240604", + "revision": "20240618", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -42935,6 +42935,47 @@ }, "type": "object" }, + "CustomErrorResponsePolicy": { + "description": "Specifies the custom error response policy that must be applied when the backend service or backend bucket responds with an error.", + "id": "CustomErrorResponsePolicy", + "properties": { + "errorResponseRules": { + "description": "Specifies rules for returning error responses. In a given policy, if you specify rules for both a range of error codes as well as rules for specific error codes then rules with specific error codes have a higher priority. For example, assume that you configure a rule for 401 (Un-authorized) code, and another for all 4 series error codes (4XX). If the backend service returns a 401, then the rule for 401 will be applied. However if the backend service returns a 403, the rule for 4xx takes effect.", + "items": { + "$ref": "CustomErrorResponsePolicyCustomErrorResponseRule" + }, + "type": "array" + }, + "errorService": { + "description": "The full or partial URL to the BackendBucket resource that contains the custom error content. Examples are: - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket - compute/v1/projects/project/global/backendBuckets/myBackendBucket - global/backendBuckets/myBackendBucket If errorService is not specified at lower levels like pathMatcher, pathRule and routeRule, an errorService specified at a higher level in the UrlMap will be used. If UrlMap.defaultCustomErrorResponsePolicy contains one or more errorResponseRules[], it must specify errorService. If load balancer cannot reach the backendBucket, a simple Not Found Error will be returned, with the original response code (or overrideResponseCode if configured). errorService is not supported for internal or regional HTTP/HTTPS load balancers.", + "type": "string" + } + }, + "type": "object" + }, + "CustomErrorResponsePolicyCustomErrorResponseRule": { + "description": "Specifies the mapping between the response code that will be returned along with the custom error content and the response code returned by the backend service.", + "id": "CustomErrorResponsePolicyCustomErrorResponseRule", + "properties": { + "matchResponseCodes": { + "description": "Valid values include: - A number between 400 and 599: For example 401 or 503, in which case the load balancer applies the policy if the error code exactly matches this value. - 5xx: Load Balancer will apply the policy if the backend service responds with any response code in the range of 500 to 599. - 4xx: Load Balancer will apply the policy if the backend service responds with any response code in the range of 400 to 499. Values must be unique within matchResponseCodes and across all errorResponseRules of CustomErrorResponsePolicy.", + "items": { + "type": "string" + }, + "type": "array" + }, + "overrideResponseCode": { + "description": "The HTTP status code returned with the response containing the custom error content. If overrideResponseCode is not supplied, the same response code returned by the original backend bucket or backend service is returned to the client.", + "format": "int32", + "type": "integer" + }, + "path": { + "description": "The full path to a file within backendBucket . For example: /errors/defaultError.html path must start with a leading slash. path cannot have trailing slashes. If the file is not available in backendBucket or the load balancer cannot reach the BackendBucket, a simple Not Found Error is returned to the client. The value must be from 1 to 1024 characters", + "type": "string" + } + }, + "type": "object" + }, "CustomerEncryptionKey": { "id": "CustomerEncryptionKey", "properties": { @@ -48419,6 +48460,10 @@ "description": "The HttpRouteRule setting specifies how to match an HTTP request and the corresponding routing action that load balancing proxies perform.", "id": "HttpRouteRule", "properties": { + "customErrorResponsePolicy": { + "$ref": "CustomErrorResponsePolicy", + "description": "customErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. If a policy for an error code is not configured for the RouteRule, a policy for the error code configured in pathMatcher.defaultCustomErrorResponsePolicy is applied. If one is not specified in pathMatcher.defaultCustomErrorResponsePolicy, the policy configured in UrlMap.defaultCustomErrorResponsePolicy takes effect. For example, consider a UrlMap with the following configuration: - UrlMap.defaultCustomErrorResponsePolicy are configured with policies for 5xx and 4xx errors - A RouteRule for /coming_soon/ is configured for the error code 404. If the request is for www.myotherdomain.com and a 404 is encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes effect. If a 404 response is encountered for the request www.example.com/current_events/, the pathMatcher's policy takes effect. If however, the request for www.example.com/coming_soon/ encounters a 404, the policy in RouteRule.customErrorResponsePolicy takes effect. If any of the requests in this example encounter a 500 error code, the policy at UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in conjunction with routeRules.routeAction.retryPolicy, retries take precedence. Only once all retries are exhausted, the customErrorResponsePolicy is applied. While attempting a retry, if load balancer is successful in reaching the service, the customErrorResponsePolicy is ignored and the response from the service is returned to the client. customErrorResponsePolicy is supported only for global external Application Load Balancers." + }, "description": { "description": "The short description conveying the intent of this routeRule. The description can have a maximum length of 1024 characters.", "type": "string" @@ -52388,7 +52433,7 @@ "compute.instanceTemplates.insert" ] }, - "description": "The machine type to use for instances that are created from these properties. This field only accept machine types name. e.g. n2-standard-4 and does not accept machine type full or partial url. e.g. projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4 will throw INTERNAL_ERROR.", + "description": "The machine type to use for instances that are created from these properties. This field only accepts a machine type name, for example `n2-standard-4`. If you use the machine type full or partial URL, for example `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`, the request will result in an `INTERNAL_ERROR`.", "type": "string" }, "metadata": { @@ -63987,6 +64032,10 @@ "description": "A matcher for the path portion of the URL. The BackendService from the longest-matched rule will serve the URL. If no rule was matched, the default service is used.", "id": "PathMatcher", "properties": { + "defaultCustomErrorResponsePolicy": { + "$ref": "CustomErrorResponsePolicy", + "description": "defaultCustomErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. This policy takes effect at the PathMatcher level and applies only when no policy has been defined for the error code at lower levels like RouteRule and PathRule within this PathMatcher. If an error code does not have a policy defined in defaultCustomErrorResponsePolicy, then a policy defined for the error code in UrlMap.defaultCustomErrorResponsePolicy takes effect. For example, consider a UrlMap with the following configuration: - UrlMap.defaultCustomErrorResponsePolicy is configured with policies for 5xx and 4xx errors - A RouteRule for /coming_soon/ is configured for the error code 404. If the request is for www.myotherdomain.com and a 404 is encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes effect. If a 404 response is encountered for the request www.example.com/current_events/, the pathMatcher's policy takes effect. If however, the request for www.example.com/coming_soon/ encounters a 404, the policy in RouteRule.customErrorResponsePolicy takes effect. If any of the requests in this example encounter a 500 error code, the policy at UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in conjunction with pathMatcher.defaultRouteAction.retryPolicy, retries take precedence. Only once all retries are exhausted, the defaultCustomErrorResponsePolicy is applied. While attempting a retry, if load balancer is successful in reaching the service, the defaultCustomErrorResponsePolicy is ignored and the response from the service is returned to the client. defaultCustomErrorResponsePolicy is supported only for global external Application Load Balancers." + }, "defaultRouteAction": { "$ref": "HttpRouteAction", "description": "defaultRouteAction takes effect when none of the pathRules or routeRules match. The load balancer performs advanced routing actions, such as URL rewrites and header transformations, before forwarding the request to the selected backend. If defaultRouteAction specifies any weightedBackendServices, defaultService must not be set. Conversely if defaultService is set, defaultRouteAction cannot contain any weightedBackendServices. If defaultRouteAction is specified, don't set defaultUrlRedirect. If defaultRouteAction.weightedBackendServices is specified, don't set defaultService. URL maps for classic Application Load Balancers only support the urlRewrite action within a path matcher's defaultRouteAction." @@ -64032,6 +64081,10 @@ "description": "A path-matching rule for a URL. If matched, will use the specified BackendService to handle the traffic arriving at this URL.", "id": "PathRule", "properties": { + "customErrorResponsePolicy": { + "$ref": "CustomErrorResponsePolicy", + "description": "customErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. If a policy for an error code is not configured for the PathRule, a policy for the error code configured in pathMatcher.defaultCustomErrorResponsePolicy is applied. If one is not specified in pathMatcher.defaultCustomErrorResponsePolicy, the policy configured in UrlMap.defaultCustomErrorResponsePolicy takes effect. For example, consider a UrlMap with the following configuration: - UrlMap.defaultCustomErrorResponsePolicy are configured with policies for 5xx and 4xx errors - A PathRule for /coming_soon/ is configured for the error code 404. If the request is for www.myotherdomain.com and a 404 is encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes effect. If a 404 response is encountered for the request www.example.com/current_events/, the pathMatcher's policy takes effect. If however, the request for www.example.com/coming_soon/ encounters a 404, the policy in PathRule.customErrorResponsePolicy takes effect. If any of the requests in this example encounter a 500 error code, the policy at UrlMap.defaultCustomErrorResponsePolicy takes effect. customErrorResponsePolicy is supported only for global external Application Load Balancers." + }, "paths": { "description": "The list of path patterns to match. Each must start with / and the only place a * is allowed is at the end following a /. The string fed to the path matcher does not include any text after the first ? or #, and those chars are not allowed here.", "items": { @@ -69024,7 +69077,7 @@ "type": "string" }, "nextHopIlb": { - "description": "The URL to a forwarding rule of type loadBalancingScheme=INTERNAL that should handle matching packets or the IP address of the forwarding Rule. For example, the following are all valid URLs: - 10.128.0.56 - https://www.googleapis.com/compute/v1/projects/project/regions/region /forwardingRules/forwardingRule - regions/region/forwardingRules/forwardingRule ", + "description": "The URL to a forwarding rule of type loadBalancingScheme=INTERNAL that should handle matching packets or the IP address of the forwarding Rule. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/project/regions/region /forwardingRules/forwardingRule - regions/region/forwardingRules/forwardingRule If an IP address is provided, must specify an IPv4 address in dot-decimal notation or an IPv6 address in RFC 4291 format. For example, the following are all valid IP addresses: - 10.128.0.56 - 2001:db8::2d9:51:0:0 - 2001:db8:0:0:2d9:51:0:0 IPv6 addresses will be displayed using RFC 5952 compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address.", "type": "string" }, "nextHopInstance": { @@ -70372,7 +70425,7 @@ "type": "string" }, "match": { - "description": "CEL expression that specifies the match condition that egress traffic from a VM is evaluated against. If it evaluates to true, the corresponding `action` is enforced. The following examples are valid match expressions for public NAT: \"inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, '2.2.0.0/16')\" \"destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'\" The following example is a valid match expression for private NAT: \"nexthop.hub == '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'\"", + "description": "CEL expression that specifies the match condition that egress traffic from a VM is evaluated against. If it evaluates to true, the corresponding `action` is enforced. The following examples are valid match expressions for public NAT: `inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, '2.2.0.0/16')` `destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'` The following example is a valid match expression for private NAT: `nexthop.hub == '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'`", "type": "string" }, "ruleNumber": { @@ -70456,14 +70509,14 @@ "id": "RouterStatus", "properties": { "bestRoutes": { - "description": "Best routes for this router's network.", + "description": "A list of the best dynamic routes for this Cloud Router's Virtual Private Cloud (VPC) network in the same region as this Cloud Router. Lists all of the best routes per prefix that are programmed into this region's VPC data plane. When global dynamic routing mode is turned on in the VPC network, this list can include cross-region dynamic routes from Cloud Routers in other regions.", "items": { "$ref": "Route" }, "type": "array" }, "bestRoutesForRouter": { - "description": "Best routes learned by this router.", + "description": "A list of the best BGP routes learned by this Cloud Router. It is possible that routes listed might not be programmed into the data plane, if the Google Cloud control plane finds a more optimal route for a prefix than a route learned by this Cloud Router.", "items": { "$ref": "Route" }, @@ -71773,10 +71826,58 @@ "format": "float", "type": "number" }, + "detectionAbsoluteQps": { + "format": "float", + "type": "number" + }, + "detectionLoadThreshold": { + "format": "float", + "type": "number" + }, + "detectionRelativeToBaselineQps": { + "format": "float", + "type": "number" + }, "name": { "description": "The name must be 1-63 characters long, and comply with RFC1035. The name must be unique within the security policy.", "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "type": "string" + }, + "trafficGranularityConfigs": { + "description": "Configuration options for enabling Adaptive Protection to operate on specified granular traffic units.", + "items": { + "$ref": "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig" + }, + "type": "array" + } + }, + "type": "object" + }, + "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig": { + "description": "Configurations to specifc granular traffic units processed by Adaptive Protection.", + "id": "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig", + "properties": { + "enableEachUniqueValue": { + "description": "If enabled, traffic matching each unique value for the specified type constitutes a separate traffic unit. It can only be set to true if `value` is empty.", + "type": "boolean" + }, + "type": { + "description": "Type of this configuration.", + "enum": [ + "HTTP_HEADER_HOST", + "HTTP_PATH", + "UNSPECIFIED_TYPE" + ], + "enumDescriptions": [ + "", + "", + "" + ], + "type": "string" + }, + "value": { + "description": "Requests that match this value constitute a granular traffic unit.", + "type": "string" } }, "type": "object" @@ -75394,7 +75495,12 @@ "type": "string" }, "poolProvisionedCapacityGb": { - "description": "Size, in GiB, of the storage pool.", + "annotations": { + "required": [ + "compute.storagePools.insert" + ] + }, + "description": "Size, in GiB, of the storage pool. For more information about the size limits, see https://cloud.google.com/compute/docs/disks/storage-pools.", "format": "int64", "type": "string" }, @@ -76036,7 +76142,7 @@ "type": "string" }, "poolUsedIops": { - "description": "Sum of all the disks' provisioned IOPS, minus some amount that is allowed per disk that is not counted towards pool's IOPS capacity.", + "description": "[Output Only] Sum of all the disks' provisioned IOPS, minus some amount that is allowed per disk that is not counted towards pool's IOPS capacity. For more information, see https://cloud.google.com/compute/docs/disks/storage-pools.", "format": "int64", "type": "string" }, @@ -81314,6 +81420,10 @@ "description": "[Output Only] Creation timestamp in RFC3339 text format.", "type": "string" }, + "defaultCustomErrorResponsePolicy": { + "$ref": "CustomErrorResponsePolicy", + "description": "defaultCustomErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. This policy takes effect at the load balancer level and applies only when no policy has been defined for the error code at lower levels like PathMatcher, RouteRule and PathRule within this UrlMap. For example, consider a UrlMap with the following configuration: - defaultCustomErrorResponsePolicy containing policies for responding to 5xx and 4xx errors - A PathMatcher configured for *.example.com has defaultCustomErrorResponsePolicy for 4xx. If a request for http://www.example.com/ encounters a 404, the policy in pathMatcher.defaultCustomErrorResponsePolicy will be enforced. When the request for http://www.example.com/ encounters a 502, the policy in UrlMap.defaultCustomErrorResponsePolicy will be enforced. When a request that does not match any host in *.example.com such as http://www.myotherexample.com/, encounters a 404, UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in conjunction with defaultRouteAction.retryPolicy, retries take precedence. Only once all retries are exhausted, the defaultCustomErrorResponsePolicy is applied. While attempting a retry, if load balancer is successful in reaching the service, the defaultCustomErrorResponsePolicy is ignored and the response from the service is returned to the client. defaultCustomErrorResponsePolicy is supported only for global external Application Load Balancers." + }, "defaultRouteAction": { "$ref": "HttpRouteAction", "description": "defaultRouteAction takes effect when none of the hostRules match. The load balancer performs advanced routing actions, such as URL rewrites and header transformations, before forwarding the request to the selected backend. If defaultRouteAction specifies any weightedBackendServices, defaultService must not be set. Conversely if defaultService is set, defaultRouteAction cannot contain any weightedBackendServices. Only one of defaultRouteAction or defaultUrlRedirect must be set. URL maps for classic Application Load Balancers only support the urlRewrite action within defaultRouteAction. defaultRouteAction has no effect when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true." diff --git a/discovery/containeranalysis-v1alpha1.json b/discovery/containeranalysis-v1alpha1.json index 3de1414253..9d687b266b 100644 --- a/discovery/containeranalysis-v1alpha1.json +++ b/discovery/containeranalysis-v1alpha1.json @@ -17,9 +17,9 @@ "documentationLink": "https://cloud.google.com/container-analysis/api/reference/rest/", "endpoints": [ { + "description": "Regional Endpoint", "location": "me-central2", - "endpointUrl": "https://containeranalysis.me-central2.rep.googleapis.com/", - "description": "Regional Endpoint" + "endpointUrl": "https://containeranalysis.me-central2.rep.googleapis.com/" } ], "fullyEncodeReservedExpansion": true, diff --git a/discovery/containeranalysis-v1beta1.json b/discovery/containeranalysis-v1beta1.json index 6deaed409d..2460798315 100644 --- a/discovery/containeranalysis-v1beta1.json +++ b/discovery/containeranalysis-v1beta1.json @@ -17,9 +17,9 @@ "documentationLink": "https://cloud.google.com/container-analysis/api/reference/rest/", "endpoints": [ { + "description": "Regional Endpoint", "location": "me-central2", - "endpointUrl": "https://containeranalysis.me-central2.rep.googleapis.com/", - "description": "Regional Endpoint" + "endpointUrl": "https://containeranalysis.me-central2.rep.googleapis.com/" } ], "fullyEncodeReservedExpansion": true, diff --git a/discovery/dataflow-v1b3.json b/discovery/dataflow-v1b3.json index be4d6e247e..9083259d4c 100644 --- a/discovery/dataflow-v1b3.json +++ b/discovery/dataflow-v1b3.json @@ -2197,7 +2197,7 @@ } } }, - "revision": "20240611", + "revision": "20240624", "rootUrl": "https://dataflow.googleapis.com/", "schemas": { "ApproximateProgress": { @@ -2967,7 +2967,7 @@ "description": "Configuration options for sampling elements from a running pipeline." }, "enableHotKeyLogging": { - "description": "When true, enables the logging of the literal hot key to the user's Cloud Logging.", + "description": "Optional. When true, enables the logging of the literal hot key to the user's Cloud Logging.", "type": "boolean" } }, @@ -3141,12 +3141,12 @@ "type": "string" }, "dataset": { - "description": "The dataset for the current project where various workflow related tables are stored. The supported resource type is: Google BigQuery: bigquery.googleapis.com/{dataset}", + "description": "Optional. The dataset for the current project where various workflow related tables are stored. The supported resource type is: Google BigQuery: bigquery.googleapis.com/{dataset}", "type": "string" }, "debugOptions": { "$ref": "DebugOptions", - "description": "Any debugging options to be supplied to the job." + "description": "Optional. Any debugging options to be supplied to the job." }, "experiments": { "description": "The list of experiments to enable. This field should be used for SDK related experiments and not for service related experiments. The proper field for service related experiments is service_options.", @@ -3156,7 +3156,7 @@ "type": "array" }, "flexResourceSchedulingGoal": { - "description": "Which Flexible Resource Scheduling mode to run in.", + "description": "Optional. Which Flexible Resource Scheduling mode to run in.", "enum": [ "FLEXRS_UNSPECIFIED", "FLEXRS_SPEED_OPTIMIZED", @@ -3186,11 +3186,11 @@ "type": "object" }, "serviceAccountEmail": { - "description": "Identity to run virtual machines as. Defaults to the default account.", + "description": "Optional. Identity to run virtual machines as. Defaults to the default account.", "type": "string" }, "serviceKmsKeyName": { - "description": "If set, contains the Cloud KMS key identifier used to encrypt data at rest, AKA a Customer Managed Encryption Key (CMEK). Format: projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY", + "description": "Optional. If set, contains the Cloud KMS key identifier used to encrypt data at rest, AKA a Customer Managed Encryption Key (CMEK). Format: projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY", "type": "string" }, "serviceOptions": { @@ -3262,11 +3262,11 @@ "type": "array" }, "workerRegion": { - "description": "The Compute Engine region (https://cloud.google.com/compute/docs/regions-zones/regions-zones) in which worker processing should occur, e.g. \"us-west1\". Mutually exclusive with worker_zone. If neither worker_region nor worker_zone is specified, default to the control plane's region.", + "description": "Optional. The Compute Engine region (https://cloud.google.com/compute/docs/regions-zones/regions-zones) in which worker processing should occur, e.g. \"us-west1\". Mutually exclusive with worker_zone. If neither worker_region nor worker_zone is specified, default to the control plane's region.", "type": "string" }, "workerZone": { - "description": "The Compute Engine zone (https://cloud.google.com/compute/docs/regions-zones/regions-zones) in which worker processing should occur, e.g. \"us-west1-a\". Mutually exclusive with worker_region. If neither worker_region nor worker_zone is specified, a zone in the control plane's region is chosen based on available capacity.", + "description": "Optional. The Compute Engine zone (https://cloud.google.com/compute/docs/regions-zones/regions-zones) in which worker processing should occur, e.g. \"us-west1-a\". Mutually exclusive with worker_region. If neither worker_region nor worker_zone is specified, a zone in the control plane's region is chosen based on available capacity.", "type": "string" } }, @@ -3935,7 +3935,7 @@ "type": "object" }, "location": { - "description": "The [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that contains this job.", + "description": "Optional. The [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that contains this job.", "type": "string" }, "name": { @@ -4005,6 +4005,11 @@ "description": "Reserved for future use. This field is set only in responses from the server; it is ignored if it is set in any requests.", "type": "boolean" }, + "serviceResources": { + "$ref": "ServiceResources", + "description": "Output only. Resources used by the Dataflow Service to run the job.", + "readOnly": true + }, "stageStates": { "description": "This field may be mutated by the Cloud Dataflow service; callers cannot mutate it.", "items": { @@ -4039,7 +4044,7 @@ "additionalProperties": { "type": "string" }, - "description": "The map of transform name prefixes of the job to be replaced to the corresponding name prefixes of the new job.", + "description": "Optional. The map of transform name prefixes of the job to be replaced to the corresponding name prefixes of the new job.", "type": "object" }, "type": { @@ -5881,6 +5886,21 @@ }, "type": "object" }, + "ServiceResources": { + "description": "Resources used by the Dataflow Service to run the job.", + "id": "ServiceResources", + "properties": { + "zones": { + "description": "Output only. List of Cloud Zones being used by the Dataflow Service for this job. Example: us-central1-c", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, "ShellTask": { "description": "A task which consists of a shell command for the worker to execute.", "id": "ShellTask", diff --git a/discovery/dialogflow-v2.json b/discovery/dialogflow-v2.json index 2f4cc9d6c0..2af05b0c91 100644 --- a/discovery/dialogflow-v2.json +++ b/discovery/dialogflow-v2.json @@ -8655,7 +8655,7 @@ } } }, - "revision": "20240614", + "revision": "20240617", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -10472,11 +10472,11 @@ "id": "GoogleCloudDialogflowCxV3TestConfig", "properties": { "flow": { - "description": "Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow.", + "description": "Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow.", "type": "string" }, "page": { - "description": "The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow.", + "description": "The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow.", "type": "string" }, "trackingParameters": { @@ -12854,11 +12854,11 @@ "id": "GoogleCloudDialogflowCxV3beta1TestConfig", "properties": { "flow": { - "description": "Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow.", + "description": "Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow.", "type": "string" }, "page": { - "description": "The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow.", + "description": "The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow.", "type": "string" }, "trackingParameters": { @@ -18581,10 +18581,54 @@ "description": "Configures speech transcription for ConversationProfile.", "id": "GoogleCloudDialogflowV2SpeechToTextConfig", "properties": { + "alternativeLanguageCodes": { + "description": "Defines the list of other language codes in addition to the one provided by the conversation profile that may be detected as the language code for the utterances over the conversation. See [Language Support](https://cloud.google.com/dialogflow/docs/reference/language) for a list of the currently supported language codes.", + "items": { + "type": "string" + }, + "type": "array" + }, + "audioEncoding": { + "description": "Audio encoding of the audio content to process.", + "enum": [ + "AUDIO_ENCODING_UNSPECIFIED", + "AUDIO_ENCODING_LINEAR_16", + "AUDIO_ENCODING_FLAC", + "AUDIO_ENCODING_MULAW", + "AUDIO_ENCODING_AMR", + "AUDIO_ENCODING_AMR_WB", + "AUDIO_ENCODING_OGG_OPUS", + "AUDIO_ENCODING_SPEEX_WITH_HEADER_BYTE" + ], + "enumDescriptions": [ + "Not specified.", + "Uncompressed 16-bit signed little-endian samples (Linear PCM).", + "[`FLAC`](https://xiph.org/flac/documentation.html) (Free Lossless Audio Codec) is the recommended encoding because it is lossless (therefore recognition is not compromised) and requires only about half the bandwidth of `LINEAR16`. `FLAC` stream encoding supports 16-bit and 24-bit samples, however, not all fields in `STREAMINFO` are supported.", + "8-bit samples that compand 14-bit audio samples using G.711 PCMU/mu-law.", + "Adaptive Multi-Rate Narrowband codec. `sample_rate_hertz` must be 8000.", + "Adaptive Multi-Rate Wideband codec. `sample_rate_hertz` must be 16000.", + "Opus encoded audio frames in Ogg container ([OggOpus](https://wiki.xiph.org/OggOpus)). `sample_rate_hertz` must be 16000.", + "Although the use of lossy encodings is not recommended, if a very low bitrate encoding is required, `OGG_OPUS` is highly preferred over Speex encoding. The [Speex](https://speex.org/) encoding supported by Dialogflow API has a header byte in each block, as in MIME type `audio/x-speex-with-header-byte`. It is a variant of the RTP Speex encoding defined in [RFC 5574](https://tools.ietf.org/html/rfc5574). The stream is a sequence of blocks, one block per RTP packet. Each block starts with a byte containing the length of the block, in bytes, followed by one or more frames of Speex data, padded to an integral number of bytes (octets) as specified in RFC 5574. In other words, each RTP header is replaced with a single byte containing the block length. Only Speex wideband is supported. `sample_rate_hertz` must be 16000." + ], + "type": "string" + }, + "enableWordInfo": { + "description": "If `true`, Dialogflow returns SpeechWordInfo in StreamingRecognitionResult with information about the recognized speech words, e.g. start and end time offsets. If false or unspecified, Speech doesn't return any word-level information.", + "type": "boolean" + }, + "languageCode": { + "description": "The language of the supplied audio. Dialogflow does not do translations. See [Language Support](https://cloud.google.com/dialogflow/docs/reference/language) for a list of the currently supported language codes. Note that queries in the same session do not necessarily need to specify the same language.", + "type": "string" + }, "model": { "description": "Which Speech model to select. Select the model best suited to your domain to get best results. If a model is not explicitly specified, then Dialogflow auto-selects a model based on other parameters in the SpeechToTextConfig and Agent settings. If enhanced speech model is enabled for the agent and an enhanced version of the specified model for the language does not exist, then the speech is recognized using the standard version of the specified model. Refer to [Cloud Speech API documentation](https://cloud.google.com/speech-to-text/docs/basics#select-model) for more details. If you specify a model, the following models typically have the best performance: - phone_call (best for Agent Assist and telephony) - latest_short (best for Dialogflow non-telephony) - command_and_search Leave this field unspecified to use [Agent Speech settings](https://cloud.google.com/dialogflow/cx/docs/concept/agent#settings-speech) for model selection.", "type": "string" }, + "sampleRateHertz": { + "description": "Sample rate (in Hertz) of the audio content sent in the query. Refer to [Cloud Speech API documentation](https://cloud.google.com/speech-to-text/docs/basics) for more details.", + "format": "int32", + "type": "integer" + }, "speechModelVariant": { "description": "The speech model used in speech to text. `SPEECH_MODEL_VARIANT_UNSPECIFIED`, `USE_BEST_AVAILABLE` will be treated as `USE_ENHANCED`. It can be overridden in AnalyzeContentRequest and StreamingAnalyzeContentRequest request. If enhanced model variant is specified and an enhanced version of the specified model for the language does not exist, then it would emit an error.", "enum": [ diff --git a/discovery/dialogflow-v2beta1.json b/discovery/dialogflow-v2beta1.json index cef253fd7d..7f86ade11d 100644 --- a/discovery/dialogflow-v2beta1.json +++ b/discovery/dialogflow-v2beta1.json @@ -8023,7 +8023,7 @@ } } }, - "revision": "20240614", + "revision": "20240617", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -9840,11 +9840,11 @@ "id": "GoogleCloudDialogflowCxV3TestConfig", "properties": { "flow": { - "description": "Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow.", + "description": "Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow.", "type": "string" }, "page": { - "description": "The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow.", + "description": "The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow.", "type": "string" }, "trackingParameters": { @@ -12222,11 +12222,11 @@ "id": "GoogleCloudDialogflowCxV3beta1TestConfig", "properties": { "flow": { - "description": "Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow.", + "description": "Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow.", "type": "string" }, "page": { - "description": "The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow.", + "description": "The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow.", "type": "string" }, "trackingParameters": { @@ -20363,10 +20363,54 @@ "description": "Configures speech transcription for ConversationProfile.", "id": "GoogleCloudDialogflowV2beta1SpeechToTextConfig", "properties": { + "alternativeLanguageCodes": { + "description": "Defines the list of other language codes in addition to the one provided by the conversation profile that may be detected as the language code for the utterances over the conversation. See [Language Support](https://cloud.google.com/dialogflow/docs/reference/language) for a list of the currently supported language codes.", + "items": { + "type": "string" + }, + "type": "array" + }, + "audioEncoding": { + "description": "Audio encoding of the audio content to process.", + "enum": [ + "AUDIO_ENCODING_UNSPECIFIED", + "AUDIO_ENCODING_LINEAR_16", + "AUDIO_ENCODING_FLAC", + "AUDIO_ENCODING_MULAW", + "AUDIO_ENCODING_AMR", + "AUDIO_ENCODING_AMR_WB", + "AUDIO_ENCODING_OGG_OPUS", + "AUDIO_ENCODING_SPEEX_WITH_HEADER_BYTE" + ], + "enumDescriptions": [ + "Not specified.", + "Uncompressed 16-bit signed little-endian samples (Linear PCM).", + "[`FLAC`](https://xiph.org/flac/documentation.html) (Free Lossless Audio Codec) is the recommended encoding because it is lossless (therefore recognition is not compromised) and requires only about half the bandwidth of `LINEAR16`. `FLAC` stream encoding supports 16-bit and 24-bit samples, however, not all fields in `STREAMINFO` are supported.", + "8-bit samples that compand 14-bit audio samples using G.711 PCMU/mu-law.", + "Adaptive Multi-Rate Narrowband codec. `sample_rate_hertz` must be 8000.", + "Adaptive Multi-Rate Wideband codec. `sample_rate_hertz` must be 16000.", + "Opus encoded audio frames in Ogg container ([OggOpus](https://wiki.xiph.org/OggOpus)). `sample_rate_hertz` must be 16000.", + "Although the use of lossy encodings is not recommended, if a very low bitrate encoding is required, `OGG_OPUS` is highly preferred over Speex encoding. The [Speex](https://speex.org/) encoding supported by Dialogflow API has a header byte in each block, as in MIME type `audio/x-speex-with-header-byte`. It is a variant of the RTP Speex encoding defined in [RFC 5574](https://tools.ietf.org/html/rfc5574). The stream is a sequence of blocks, one block per RTP packet. Each block starts with a byte containing the length of the block, in bytes, followed by one or more frames of Speex data, padded to an integral number of bytes (octets) as specified in RFC 5574. In other words, each RTP header is replaced with a single byte containing the block length. Only Speex wideband is supported. `sample_rate_hertz` must be 16000." + ], + "type": "string" + }, + "enableWordInfo": { + "description": "If `true`, Dialogflow returns SpeechWordInfo in StreamingRecognitionResult with information about the recognized speech words, e.g. start and end time offsets. If false or unspecified, Speech doesn't return any word-level information.", + "type": "boolean" + }, + "languageCode": { + "description": "The language of the supplied audio. Dialogflow does not do translations. See [Language Support](https://cloud.google.com/dialogflow/docs/reference/language) for a list of the currently supported language codes. Note that queries in the same session do not necessarily need to specify the same language.", + "type": "string" + }, "model": { "description": "Which Speech model to select. Select the model best suited to your domain to get best results. If a model is not explicitly specified, then Dialogflow auto-selects a model based on other parameters in the SpeechToTextConfig and Agent settings. If enhanced speech model is enabled for the agent and an enhanced version of the specified model for the language does not exist, then the speech is recognized using the standard version of the specified model. Refer to [Cloud Speech API documentation](https://cloud.google.com/speech-to-text/docs/basics#select-model) for more details. If you specify a model, the following models typically have the best performance: - phone_call (best for Agent Assist and telephony) - latest_short (best for Dialogflow non-telephony) - command_and_search Leave this field unspecified to use [Agent Speech settings](https://cloud.google.com/dialogflow/cx/docs/concept/agent#settings-speech) for model selection.", "type": "string" }, + "sampleRateHertz": { + "description": "Sample rate (in Hertz) of the audio content sent in the query. Refer to [Cloud Speech API documentation](https://cloud.google.com/speech-to-text/docs/basics) for more details.", + "format": "int32", + "type": "integer" + }, "speechModelVariant": { "description": "The speech model used in speech to text. `SPEECH_MODEL_VARIANT_UNSPECIFIED`, `USE_BEST_AVAILABLE` will be treated as `USE_ENHANCED`. It can be overridden in AnalyzeContentRequest and StreamingAnalyzeContentRequest request. If enhanced model variant is specified and an enhanced version of the specified model for the language does not exist, then it would emit an error.", "enum": [ diff --git a/discovery/dialogflow-v3.json b/discovery/dialogflow-v3.json index 1dbeb8a223..a172551792 100644 --- a/discovery/dialogflow-v3.json +++ b/discovery/dialogflow-v3.json @@ -4453,7 +4453,7 @@ } } }, - "revision": "20240603", + "revision": "20240617", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -9236,11 +9236,11 @@ "id": "GoogleCloudDialogflowCxV3TestConfig", "properties": { "flow": { - "description": "Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow.", + "description": "Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow.", "type": "string" }, "page": { - "description": "The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow.", + "description": "The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow.", "type": "string" }, "trackingParameters": { @@ -12009,11 +12009,11 @@ "id": "GoogleCloudDialogflowCxV3beta1TestConfig", "properties": { "flow": { - "description": "Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow.", + "description": "Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow.", "type": "string" }, "page": { - "description": "The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow.", + "description": "The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow.", "type": "string" }, "trackingParameters": { diff --git a/discovery/dialogflow-v3beta1.json b/discovery/dialogflow-v3beta1.json index a7fcea84be..d6ec23502b 100644 --- a/discovery/dialogflow-v3beta1.json +++ b/discovery/dialogflow-v3beta1.json @@ -5185,7 +5185,7 @@ } } }, - "revision": "20240603", + "revision": "20240617", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -7002,11 +7002,11 @@ "id": "GoogleCloudDialogflowCxV3TestConfig", "properties": { "flow": { - "description": "Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow.", + "description": "Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow.", "type": "string" }, "page": { - "description": "The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow.", + "description": "The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow.", "type": "string" }, "trackingParameters": { @@ -13255,11 +13255,11 @@ "id": "GoogleCloudDialogflowCxV3beta1TestConfig", "properties": { "flow": { - "description": "Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow.", + "description": "Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow.", "type": "string" }, "page": { - "description": "The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow.", + "description": "The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow.", "type": "string" }, "trackingParameters": { diff --git a/discovery/displayvideo-v3.json b/discovery/displayvideo-v3.json index f839ee5007..b27c068990 100644 --- a/discovery/displayvideo-v3.json +++ b/discovery/displayvideo-v3.json @@ -9222,7 +9222,7 @@ } } }, - "revision": "20240620", + "revision": "20240627", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActiveViewVideoViewabilityMetricConfig": { @@ -16718,6 +16718,14 @@ }, "type": "array" }, + "adGroupQaIds": { + "description": "Optional. YouTube Ad Groups QA to download by ID. All IDs must belong to the same Advertiser or Partner specified in CreateSdfDownloadTaskRequest.", + "items": { + "format": "int64", + "type": "string" + }, + "type": "array" + }, "campaignIds": { "description": "Campaigns to download by ID. All IDs must belong to the same Advertiser or Partner specified in CreateSdfDownloadTaskRequest.", "items": { @@ -16742,6 +16750,14 @@ }, "type": "array" }, + "lineItemQaIds": { + "description": "Optional. Line Items QA to download by ID. All IDs must belong to the same Advertiser or Partner specified in CreateSdfDownloadTaskRequest.", + "items": { + "format": "int64", + "type": "string" + }, + "type": "array" + }, "mediaProductIds": { "description": "Media Products to download by ID. All IDs must belong to the same Advertiser or Partner specified in CreateSdfDownloadTaskRequest.", "items": { @@ -19596,7 +19612,9 @@ "FILE_TYPE_INSERTION_ORDER", "FILE_TYPE_LINE_ITEM", "FILE_TYPE_AD_GROUP", - "FILE_TYPE_AD" + "FILE_TYPE_AD", + "FILE_TYPE_LINE_ITEM_QA", + "FILE_TYPE_AD_GROUP_QA" ], "enumDescriptions": [ "Default value when type is unspecified or is unknown in this version.", @@ -19605,7 +19623,9 @@ "Insertion Order.", "Line Item.", "YouTube Ad Group.", - "YouTube Ad." + "YouTube Ad.", + "Line Item QA.", + "YouTube Ad Group QA." ], "type": "string" }, diff --git a/discovery/dlp-v2.json b/discovery/dlp-v2.json index 9d3a57525d..91ea56f64e 100644 --- a/discovery/dlp-v2.json +++ b/discovery/dlp-v2.json @@ -17,14 +17,14 @@ "documentationLink": "https://cloud.google.com/sensitive-data-protection/docs/", "endpoints": [ { - "description": "Regional Endpoint", + "endpointUrl": "https://dlp.africa-south1.rep.googleapis.com/", "location": "africa-south1", - "endpointUrl": "https://dlp.africa-south1.rep.googleapis.com/" + "description": "Regional Endpoint" }, { + "description": "Regional Endpoint", "endpointUrl": "https://dlp.australia-southeast1.rep.googleapis.com/", - "location": "australia-southeast1", - "description": "Regional Endpoint" + "location": "australia-southeast1" }, { "location": "europe-west9", @@ -1129,6 +1129,106 @@ } } }, + "fileStoreDataProfiles": { + "methods": { + "delete": { + "description": "Delete a FileStoreDataProfile. Will not prevent the profile from being regenerated if the resource is still included in a discovery configuration.", + "flatPath": "v2/organizations/{organizationsId}/locations/{locationsId}/fileStoreDataProfiles/{fileStoreDataProfilesId}", + "httpMethod": "DELETE", + "id": "dlp.organizations.locations.fileStoreDataProfiles.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Resource name of the file store data profile.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+/fileStoreDataProfiles/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+name}", + "response": { + "$ref": "GoogleProtobufEmpty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets a file store data profile.", + "flatPath": "v2/organizations/{organizationsId}/locations/{locationsId}/fileStoreDataProfiles/{fileStoreDataProfilesId}", + "httpMethod": "GET", + "id": "dlp.organizations.locations.fileStoreDataProfiles.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Resource name, for example `organizations/12345/locations/us/fileStoreDataProfiles/53234423`.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+/fileStoreDataProfiles/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+name}", + "response": { + "$ref": "GooglePrivacyDlpV2FileStoreDataProfile" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists file store data profiles for an organization.", + "flatPath": "v2/organizations/{organizationsId}/locations/{locationsId}/fileStoreDataProfiles", + "httpMethod": "GET", + "id": "dlp.organizations.locations.fileStoreDataProfiles.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Optional. Allows filtering. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * Supported fields/values: - `project_id` - The Google Cloud project ID. - `file_store_path` - The path like \"gs://bucket\". - `sensitivity_level` - HIGH|MODERATE|LOW - `data_risk_level` - HIGH|MODERATE|LOW - `resource_visibility`: PUBLIC|RESTRICTED - `status_code` - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto * The operator must be `=` or `!=`. Examples: * `project_id = 12345 AND status_code = 1` * `project_id = 12345 AND sensitivity_level = HIGH` * `project_id = 12345 AND resource_visibility = PUBLIC` . * 'file_store_path = \"gs://mybucket\"` The length of this field should be no more than 500 characters.", + "location": "query", + "type": "string" + }, + "orderBy": { + "description": "Optional. Comma separated list of fields to order by, followed by `asc` or `desc` postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed. Examples: * `project_id asc` * `name` * `sensitivity_level desc` Supported fields are: - `project_id`: The Google Cloud project ID. - `sensitivity_level`: How sensitive the data in a table is, at most. - `data_risk_level`: How much risk is associated with this data. - `profile_last_generated`: When the profile was last updated in epoch seconds. - `last_modified`: The last time the resource was modified. - `resource_visibility`: Visibility restriction for this resource. - `name`: The name of the profile. - `create_time`: The time the file store was first created.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. Size of the page. This value can be limited by the server. If zero, server returns a page of max size 100.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. Page token to continue retrieval.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. Resource name of the organization or project, for example `organizations/433245324/locations/europe` or `projects/project-id/locations/asia`.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+parent}/fileStoreDataProfiles", + "response": { + "$ref": "GooglePrivacyDlpV2ListFileStoreDataProfilesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "inspectTemplates": { "methods": { "create": { @@ -3662,6 +3762,106 @@ } } }, + "fileStoreDataProfiles": { + "methods": { + "delete": { + "description": "Delete a FileStoreDataProfile. Will not prevent the profile from being regenerated if the resource is still included in a discovery configuration.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/fileStoreDataProfiles/{fileStoreDataProfilesId}", + "httpMethod": "DELETE", + "id": "dlp.projects.locations.fileStoreDataProfiles.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Resource name of the file store data profile.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/fileStoreDataProfiles/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+name}", + "response": { + "$ref": "GoogleProtobufEmpty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets a file store data profile.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/fileStoreDataProfiles/{fileStoreDataProfilesId}", + "httpMethod": "GET", + "id": "dlp.projects.locations.fileStoreDataProfiles.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Resource name, for example `organizations/12345/locations/us/fileStoreDataProfiles/53234423`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/fileStoreDataProfiles/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+name}", + "response": { + "$ref": "GooglePrivacyDlpV2FileStoreDataProfile" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists file store data profiles for an organization.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/fileStoreDataProfiles", + "httpMethod": "GET", + "id": "dlp.projects.locations.fileStoreDataProfiles.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Optional. Allows filtering. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * Supported fields/values: - `project_id` - The Google Cloud project ID. - `file_store_path` - The path like \"gs://bucket\". - `sensitivity_level` - HIGH|MODERATE|LOW - `data_risk_level` - HIGH|MODERATE|LOW - `resource_visibility`: PUBLIC|RESTRICTED - `status_code` - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto * The operator must be `=` or `!=`. Examples: * `project_id = 12345 AND status_code = 1` * `project_id = 12345 AND sensitivity_level = HIGH` * `project_id = 12345 AND resource_visibility = PUBLIC` . * 'file_store_path = \"gs://mybucket\"` The length of this field should be no more than 500 characters.", + "location": "query", + "type": "string" + }, + "orderBy": { + "description": "Optional. Comma separated list of fields to order by, followed by `asc` or `desc` postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed. Examples: * `project_id asc` * `name` * `sensitivity_level desc` Supported fields are: - `project_id`: The Google Cloud project ID. - `sensitivity_level`: How sensitive the data in a table is, at most. - `data_risk_level`: How much risk is associated with this data. - `profile_last_generated`: When the profile was last updated in epoch seconds. - `last_modified`: The last time the resource was modified. - `resource_visibility`: Visibility restriction for this resource. - `name`: The name of the profile. - `create_time`: The time the file store was first created.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. Size of the page. This value can be limited by the server. If zero, server returns a page of max size 100.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. Page token to continue retrieval.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. Resource name of the organization or project, for example `organizations/433245324/locations/europe` or `projects/project-id/locations/asia`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+parent}/fileStoreDataProfiles", + "response": { + "$ref": "GooglePrivacyDlpV2ListFileStoreDataProfilesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "image": { "methods": { "redact": { @@ -4574,7 +4774,7 @@ } } }, - "revision": "20240616", + "revision": "20240624", "rootUrl": "https://dlp.googleapis.com/", "schemas": { "GooglePrivacyDlpV2Action": { @@ -5000,7 +5200,10 @@ "EXCEL_DOCUMENT", "AVRO", "CSV", - "TSV" + "TSV", + "AUDIO", + "VIDEO", + "EXECUTABLE" ], "enumDescriptions": [ "Unused", @@ -5016,7 +5219,10 @@ "xlsx, xlsm, xltx, xltm", "avro", "csv", - "tsv" + "tsv", + "Audio file types. Only used for profiling.", + "Video file types. Only used for profiling.", + "Executable file types. Only used for profiling." ], "type": "string" } @@ -6030,6 +6236,10 @@ "$ref": "GooglePrivacyDlpV2ColumnDataProfile", "description": "Column data profile column" }, + "fileStoreProfile": { + "$ref": "GooglePrivacyDlpV2FileStoreDataProfile", + "description": "File store data profile column." + }, "tableProfile": { "$ref": "GooglePrivacyDlpV2TableDataProfile", "description": "Table data profile column" @@ -6145,6 +6355,10 @@ ], "type": "string" }, + "fileStoreProfile": { + "$ref": "GooglePrivacyDlpV2FileStoreDataProfile", + "description": "If `DetailLevel` is `FILE_STORE_PROFILE` this will be fully populated. Otherwise, if `DetailLevel` is `RESOURCE_NAME`, then only `name` and `file_store_path` will be populated." + }, "profile": { "$ref": "GooglePrivacyDlpV2TableDataProfile", "description": "If `DetailLevel` is `TABLE_PROFILE` this will be fully populated. Otherwise, if `DetailLevel` is `RESOURCE_NAME`, then only `name` and `full_resource` will be populated." @@ -6161,12 +6375,14 @@ "enum": [ "RISK_SCORE_UNSPECIFIED", "RISK_LOW", + "RISK_UNKNOWN", "RISK_MODERATE", "RISK_HIGH" ], "enumDescriptions": [ "Unused.", "Low risk - Lower indication of sensitive data that appears to have additional access restrictions in place or no indication of sensitive data found.", + "Unable to determine risk.", "Medium risk - Sensitive data may be present but additional access or fine grain access restrictions appear to be present. Consider limiting access even further or transform data to mask.", "High risk – SPII may be present. Access controls may include public ACLs. Exfiltration of data may lead to user data loss. Re-identification of users may be possible. Consider limiting usage and or removing SPII." ], @@ -7145,6 +7361,20 @@ "$ref": "GoogleRpcStatus", "description": "Detailed error codes and messages." }, + "extraInfo": { + "description": "Additional information about the error.", + "enum": [ + "ERROR_INFO_UNSPECIFIED", + "IMAGE_SCAN_UNAVAILABLE_IN_REGION", + "FILE_STORE_CLUSTER_UNSUPPORTED" + ], + "enumDescriptions": [ + "Unused.", + "Image scan is not available in the region.", + "File store cluster is not supported for profile generation." + ], + "type": "string" + }, "timestamps": { "description": "The times the error occurred. List includes the oldest timestamp and the last 9 timestamps.", "items": { @@ -7295,6 +7525,103 @@ }, "type": "object" }, + "GooglePrivacyDlpV2FileClusterSummary": { + "description": "The file cluster summary.", + "id": "GooglePrivacyDlpV2FileClusterSummary", + "properties": { + "dataRiskLevel": { + "$ref": "GooglePrivacyDlpV2DataRiskLevel", + "description": "The data risk level of this cluster. RISK_LOW if nothing has been scanned." + }, + "errors": { + "description": "A list of Errors detected while scanning this cluster. The list is truncated to 10 per cluster.", + "items": { + "$ref": "GooglePrivacyDlpV2Error" + }, + "type": "array" + }, + "fileClusterType": { + "$ref": "GooglePrivacyDlpV2FileClusterType", + "description": "The file cluster type." + }, + "fileExtensionsScanned": { + "description": "A sample of file types scanned in this cluster. Empty if no files were scanned.", + "items": { + "$ref": "GooglePrivacyDlpV2FileExtensionInfo" + }, + "type": "array" + }, + "fileExtensionsSeen": { + "description": "A sample of file types seen in this cluster. Empty if no files were seen.", + "items": { + "$ref": "GooglePrivacyDlpV2FileExtensionInfo" + }, + "type": "array" + }, + "fileStoreInfoTypeSummaries": { + "description": "InfoTypes detected in this cluster.", + "items": { + "$ref": "GooglePrivacyDlpV2FileStoreInfoTypeSummary" + }, + "type": "array" + }, + "noFilesExist": { + "description": "True if no files exist in this cluster. If the bucket had more files than could be listed, this will be false even if no files for this cluster were seen and file_extensions_seen is empty.", + "type": "boolean" + }, + "sensitivityScore": { + "$ref": "GooglePrivacyDlpV2SensitivityScore", + "description": "The sensitivity score of this cluster. The score will be SENSITIVITY_LOW if nothing has been scanned." + } + }, + "type": "object" + }, + "GooglePrivacyDlpV2FileClusterType": { + "description": "Message used to identify file cluster type being profiled.", + "id": "GooglePrivacyDlpV2FileClusterType", + "properties": { + "cluster": { + "description": "Cluster type.", + "enum": [ + "CLUSTER_UNSPECIFIED", + "CLUSTER_UNKNOWN", + "CLUSTER_TEXT", + "CLUSTER_STRUCTURED_DATA", + "CLUSTER_SOURCE_CODE", + "CLUSTER_RICH_DOCUMENT", + "CLUSTER_IMAGE", + "CLUSTER_ARCHIVE", + "CLUSTER_MULTIMEDIA", + "CLUSTER_EXECUTABLE" + ], + "enumDescriptions": [ + "Unused.", + "Unsupported files.", + "Plain text.", + "Structured data like CSV, TSV etc.", + "Source code.", + "Rich document like docx, xlsx etc.", + "Images like jpeg, bmp.", + "Archives and containers like .zip, .tar etc.", + "Multimedia like .mp4, .avi etc.", + "Executable files like .exe, .class, .apk etc." + ], + "type": "string" + } + }, + "type": "object" + }, + "GooglePrivacyDlpV2FileExtensionInfo": { + "description": "Information regarding the discovered file extension.", + "id": "GooglePrivacyDlpV2FileExtensionInfo", + "properties": { + "fileExtension": { + "description": "The file extension if set. (aka .pdf, .jpg, .txt)", + "type": "string" + } + }, + "type": "object" + }, "GooglePrivacyDlpV2FileSet": { "description": "Set of files to scan.", "id": "GooglePrivacyDlpV2FileSet", @@ -7310,6 +7637,156 @@ }, "type": "object" }, + "GooglePrivacyDlpV2FileStoreDataProfile": { + "description": "The profile for a file store. * Google Cloud Storage: maps 1:1 with a bucket.", + "id": "GooglePrivacyDlpV2FileStoreDataProfile", + "properties": { + "configSnapshot": { + "$ref": "GooglePrivacyDlpV2DataProfileConfigSnapshot", + "description": "The snapshot of the configurations used to generate the profile." + }, + "createTime": { + "description": "The time the file store was first created.", + "format": "google-datetime", + "type": "string" + }, + "dataRiskLevel": { + "$ref": "GooglePrivacyDlpV2DataRiskLevel", + "description": "The data risk level of this resource." + }, + "dataSourceType": { + "$ref": "GooglePrivacyDlpV2DataSourceType", + "description": "The resource type that was profiled." + }, + "dataStorageLocations": { + "description": "For resources that have multiple storage locations, these are those regions. For Google Cloud Storage this is the list of regions chosen for dual-region storage. `file_store_location` will normally be the corresponding multi-region for the list of individual locations. The first region is always picked as the processing and storage location for the data profile.", + "items": { + "type": "string" + }, + "type": "array" + }, + "fileClusterSummaries": { + "description": "FileClusterSummary per each cluster.", + "items": { + "$ref": "GooglePrivacyDlpV2FileClusterSummary" + }, + "type": "array" + }, + "fileStoreInfoTypeSummaries": { + "description": "InfoTypes detected in this file store.", + "items": { + "$ref": "GooglePrivacyDlpV2FileStoreInfoTypeSummary" + }, + "type": "array" + }, + "fileStoreIsEmpty": { + "description": "The file store does not have any files.", + "type": "boolean" + }, + "fileStoreLocation": { + "description": "The location of the file store. * Google Cloud Storage: https://cloud.google.com/storage/docs/locations#available-locations", + "type": "string" + }, + "fileStorePath": { + "description": "The file store path. * Google Cloud Storage: `gs://{bucket}`", + "type": "string" + }, + "fullResource": { + "description": "The resource name of the resource profiled. https://cloud.google.com/apis/design/resource_names#full_resource_name", + "type": "string" + }, + "lastModifiedTime": { + "description": "The time the file store was last modified.", + "format": "google-datetime", + "type": "string" + }, + "locationType": { + "description": "The location type of the bucket (region, dual-region, multi-region, etc). If dual-region, expect data_storage_locations to be populated.", + "type": "string" + }, + "name": { + "description": "The name of the profile.", + "type": "string" + }, + "profileLastGenerated": { + "description": "The last time the profile was generated.", + "format": "google-datetime", + "type": "string" + }, + "profileStatus": { + "$ref": "GooglePrivacyDlpV2ProfileStatus", + "description": "Success or error status from the most recent profile generation attempt. May be empty if the profile is still being generated." + }, + "projectDataProfile": { + "description": "The resource name to the project data profile for this file store.", + "type": "string" + }, + "projectId": { + "description": "The Google Cloud project ID that owns the resource.", + "type": "string" + }, + "resourceAttributes": { + "additionalProperties": { + "$ref": "GooglePrivacyDlpV2Value" + }, + "description": "Attributes of the resource being profiled. Currently used attributes: - customer_managed_encryption: boolean true: the resource is encrypted with a customer-managed key. false: the resource is encrypted with a provider-managed key.", + "type": "object" + }, + "resourceLabels": { + "additionalProperties": { + "type": "string" + }, + "description": "The labels applied to the resource at the time the profile was generated.", + "type": "object" + }, + "resourceVisibility": { + "description": "How broadly a resource has been shared.", + "enum": [ + "RESOURCE_VISIBILITY_UNSPECIFIED", + "RESOURCE_VISIBILITY_PUBLIC", + "RESOURCE_VISIBILITY_INCONCLUSIVE", + "RESOURCE_VISIBILITY_RESTRICTED" + ], + "enumDescriptions": [ + "Unused.", + "Visible to any user.", + "May contain public items. For example, if a Cloud Storage bucket has uniform bucket level access disabled, some objects inside it may be public, but none are known yet.", + "Visible only to specific users." + ], + "type": "string" + }, + "sensitivityScore": { + "$ref": "GooglePrivacyDlpV2SensitivityScore", + "description": "The sensitivity score of this resource." + }, + "state": { + "description": "State of a profile.", + "enum": [ + "STATE_UNSPECIFIED", + "RUNNING", + "DONE" + ], + "enumDescriptions": [ + "Unused.", + "The profile is currently running. Once a profile has finished it will transition to DONE.", + "The profile is no longer generating. If profile_status.status.code is 0, the profile succeeded, otherwise, it failed." + ], + "type": "string" + } + }, + "type": "object" + }, + "GooglePrivacyDlpV2FileStoreInfoTypeSummary": { + "description": "Information regarding the discovered InfoType.", + "id": "GooglePrivacyDlpV2FileStoreInfoTypeSummary", + "properties": { + "infoType": { + "$ref": "GooglePrivacyDlpV2InfoType", + "description": "The InfoType seen." + } + }, + "type": "object" + }, "GooglePrivacyDlpV2Finding": { "description": "Represents a piece of potentially sensitive content.", "id": "GooglePrivacyDlpV2Finding", @@ -8802,6 +9279,24 @@ }, "type": "object" }, + "GooglePrivacyDlpV2ListFileStoreDataProfilesResponse": { + "description": "List of file store data profiles generated for a given organization or project.", + "id": "GooglePrivacyDlpV2ListFileStoreDataProfilesResponse", + "properties": { + "fileStoreDataProfiles": { + "description": "List of data profiles.", + "items": { + "$ref": "GooglePrivacyDlpV2FileStoreDataProfile" + }, + "type": "array" + }, + "nextPageToken": { + "description": "The next page token.", + "type": "string" + } + }, + "type": "object" + }, "GooglePrivacyDlpV2ListInfoTypesResponse": { "description": "Response to the ListInfoTypes request.", "id": "GooglePrivacyDlpV2ListInfoTypesResponse", @@ -9222,6 +9717,11 @@ "$ref": "GooglePrivacyDlpV2DataRiskLevel", "description": "The data risk level of this project." }, + "fileStoreDataProfileCount": { + "description": "The number of file store data profiles generated for this project.", + "format": "int64", + "type": "string" + }, "name": { "description": "The resource name of the profile.", "type": "string" @@ -9242,6 +9742,11 @@ "sensitivityScore": { "$ref": "GooglePrivacyDlpV2SensitivityScore", "description": "The sensitivity score of this project." + }, + "tableDataProfileCount": { + "description": "The number of table data profiles generated for this project.", + "format": "int64", + "type": "string" } }, "type": "object" @@ -9335,12 +9840,14 @@ "enum": [ "DETAIL_LEVEL_UNSPECIFIED", "TABLE_PROFILE", - "RESOURCE_NAME" + "RESOURCE_NAME", + "FILE_STORE_PROFILE" ], "enumDescriptions": [ "Unused.", "The full table data profile.", - "The name of the profiled resource." + "The name of the profiled resource.", + "The full file store data profile." ], "type": "string" }, @@ -9975,12 +10482,14 @@ "enum": [ "SENSITIVITY_SCORE_UNSPECIFIED", "SENSITIVITY_LOW", + "SENSITIVITY_UNKNOWN", "SENSITIVITY_MODERATE", "SENSITIVITY_HIGH" ], "enumDescriptions": [ "Unused.", "No sensitive information detected. The resource isn't publicly accessible.", + "Unable to determine sensitivity.", "Medium risk. Contains personally identifiable information (PII), potentially sensitive data, or fields with free-text data that are at a higher risk of having intermittent sensitive data. Consider limiting access.", "High risk. Sensitive personally identifiable information (SPII) can be present. Exfiltration of data can lead to user data loss. Re-identification of users might be possible. Consider limiting usage and or removing SPII." ], @@ -10342,7 +10851,7 @@ "enumDescriptions": [ "Unused.", "Visible to any user.", - "May contain public items. For example, if a Cloud Storage bucket has uniform bucket level access disabled, some objects inside it may be public.", + "May contain public items. For example, if a Cloud Storage bucket has uniform bucket level access disabled, some objects inside it may be public, but none are known yet.", "Visible only to specific users." ], "type": "string" diff --git a/discovery/firebaseappdistribution-v1alpha.json b/discovery/firebaseappdistribution-v1alpha.json index 2bc38a3c80..49dc142510 100644 --- a/discovery/firebaseappdistribution-v1alpha.json +++ b/discovery/firebaseappdistribution-v1alpha.json @@ -585,7 +585,7 @@ } } }, - "revision": "20231221", + "revision": "20240628", "rootUrl": "https://firebaseappdistribution.googleapis.com/", "schemas": { "GoogleFirebaseAppdistroV1Release": { @@ -697,6 +697,39 @@ }, "type": "object" }, + "GoogleFirebaseAppdistroV1alphaAiInstructions": { + "description": "Instructions for AI driven test", + "id": "GoogleFirebaseAppdistroV1alphaAiInstructions", + "properties": { + "appDescription": { + "description": "Optional. Describes the app to give the AI some context", + "type": "string" + }, + "steps": { + "description": "Required. Steps to be accomplished by the AI", + "items": { + "$ref": "GoogleFirebaseAppdistroV1alphaAiInstructionsStep" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleFirebaseAppdistroV1alphaAiInstructionsStep": { + "description": "A step to be accomplished by the AI", + "id": "GoogleFirebaseAppdistroV1alphaAiInstructionsStep", + "properties": { + "assertion": { + "description": "An assertion to be checked by the AI", + "type": "string" + }, + "goal": { + "description": "A goal to be accomplished by the AI", + "type": "string" + } + }, + "type": "object" + }, "GoogleFirebaseAppdistroV1alphaApp": { "id": "GoogleFirebaseAppdistroV1alphaApp", "properties": { @@ -1177,6 +1210,10 @@ "description": "The results of running an automated test on a release.", "id": "GoogleFirebaseAppdistroV1alphaReleaseTest", "properties": { + "aiInstructions": { + "$ref": "GoogleFirebaseAppdistroV1alphaAiInstructions", + "description": "Optional. Input only. Instructions for AI driven test. Input only." + }, "createTime": { "description": "Output only. Timestamp when the test was run.", "format": "google-datetime", @@ -1205,6 +1242,10 @@ "description": "Configuration for Robo crawler", "id": "GoogleFirebaseAppdistroV1alphaRoboCrawler", "properties": { + "aiInstructions": { + "$ref": "GoogleFirebaseAppdistroV1alphaAiInstructions", + "description": "Optional. Instructions for AI driven test" + }, "loginCredential": { "$ref": "GoogleFirebaseAppdistroV1alphaLoginCredential", "description": "Optional. Login credential for automated tests" diff --git a/discovery/gkehub-v1.json b/discovery/gkehub-v1.json index 32c2bff83e..b01203ef50 100644 --- a/discovery/gkehub-v1.json +++ b/discovery/gkehub-v1.json @@ -1143,6 +1143,46 @@ ] } } + }, + "rbacrolebindings": { + "methods": { + "list": { + "description": "Lists all Membership RBACRoleBindings.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/memberships/{membershipsId}/rbacrolebindings", + "httpMethod": "GET", + "id": "gkehub.projects.locations.memberships.rbacrolebindings.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Optional. When requesting a 'page' of resources, `page_size` specifies number of resources to return. If unspecified or set to 0, all resources will be returned.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. Token returned by previous call to `ListMembershipRBACRoleBindings` which specifies the position in the list from where to continue listing the resources.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent (project and location) where the Features will be listed. Specified in the format `projects/*/locations/*/memberships/*`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/memberships/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/rbacrolebindings", + "response": { + "$ref": "ListMembershipRBACRoleBindingsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } } } }, @@ -1911,7 +1951,7 @@ } } }, - "revision": "20240519", + "revision": "20240623", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AppDevExperienceFeatureSpec": { @@ -4336,6 +4376,31 @@ }, "type": "object" }, + "ListMembershipRBACRoleBindingsResponse": { + "description": "List of Membership RBACRoleBindings.", + "id": "ListMembershipRBACRoleBindingsResponse", + "properties": { + "nextPageToken": { + "description": "A token to request the next page of resources from the `ListMembershipRBACRoleBindings` method. The value of an empty string means that there are no more resources to return.", + "type": "string" + }, + "rbacrolebindings": { + "description": "The list of Membership RBACRoleBindings.", + "items": { + "$ref": "RBACRoleBinding" + }, + "type": "array" + }, + "unreachable": { + "description": "List of locations that could not be reached while fetching this list.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "ListMembershipsResponse": { "description": "Response message for the `GkeHub.ListMemberships` method.", "id": "ListMembershipsResponse", diff --git a/discovery/healthcare-v1.json b/discovery/healthcare-v1.json index 345baa07d0..33c61c42c6 100644 --- a/discovery/healthcare-v1.json +++ b/discovery/healthcare-v1.json @@ -4380,7 +4380,7 @@ ], "parameters": { "name": { - "description": "Output only. Resource name of the Message, of the form `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/hl7V2Stores/{hl7_v2_store_id}/messages/{message_id}`. Assigned by the server.", + "description": "Output only. Resource name of the Message, of the form `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/hl7V2Stores/{hl7_v2_store_id}/messages/{message_id}`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/hl7V2Stores/[^/]+/messages/[^/]+$", "required": true, @@ -4554,7 +4554,7 @@ } } }, - "revision": "20240605", + "revision": "20240619", "rootUrl": "https://healthcare.googleapis.com/", "schemas": { "ActivateConsentRequest": { @@ -6747,7 +6747,7 @@ "type": "string" }, "name": { - "description": "Output only. Resource name of the Message, of the form `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/hl7V2Stores/{hl7_v2_store_id}/messages/{message_id}`. Assigned by the server.", + "description": "Output only. Resource name of the Message, of the form `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/hl7V2Stores/{hl7_v2_store_id}/messages/{message_id}`.", "readOnly": true, "type": "string" }, diff --git a/discovery/healthcare-v1beta1.json b/discovery/healthcare-v1beta1.json index 1ed056c102..2af54bc977 100644 --- a/discovery/healthcare-v1beta1.json +++ b/discovery/healthcare-v1beta1.json @@ -2869,7 +2869,7 @@ ], "parameters": { "resource": { - "description": "Required. The path of the resource for which the storage info is requested (for exaxmple for a DICOM Instance: `projects/{projectID}/locations/{locationID}/datasets/{datasetID}/dicomStores/{dicomStoreId}/dicomWeb/studies/{study_uid}/series/{series_uid}/instances/{instance_uid}`)", + "description": "Required. The path of the instance to return storage info for, in the form: `projects/{projectID}/locations/{locationID}/datasets/{datasetID}/dicomStores/{dicomStoreID}/dicomWeb/studies/{studyUID}/series/{seriesUID}/instances/{instanceUID}`", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/dicomStores/[^/]+/dicomWeb/studies/[^/]+/series/[^/]+/instances/[^/]+$", "required": true, @@ -5672,7 +5672,7 @@ } } }, - "revision": "20240605", + "revision": "20240619", "rootUrl": "https://healthcare.googleapis.com/", "schemas": { "AccessDeterminationLogConfig": { @@ -9930,7 +9930,7 @@ "description": "Info about the data stored in blob storage for the resource." }, "referencedResource": { - "description": "The resource whose storage info is returned. For example, to specify the resource path of a DICOM Instance: `projects/{projectID}/locations/{locationID}/datasets/{datasetID}/dicomStores/{dicom_store_id}/dicomWeb/studi/{study_uid}/series/{series_uid}/instances/{instance_uid}`", + "description": "The resource whose storage info is returned. For example: `projects/{projectID}/locations/{locationID}/datasets/{datasetID}/dicomStores/{dicomStoreID}/dicomWeb/studies/{studyUID}/series/{seriesUID}/instances/{instanceUID}`", "type": "string" }, "structuredStorageInfo": { diff --git a/discovery/logging-v2.json b/discovery/logging-v2.json index 0817d8aad2..5db00b4cf9 100644 --- a/discovery/logging-v2.json +++ b/discovery/logging-v2.json @@ -1226,6 +1226,11 @@ "parent" ], "parameters": { + "filter": { + "description": "Optional. Specifies the type (\"Logging\" or \"OpsAnalytics\") of the recent queries to list. The only valid value for this field is one of the two allowable type function calls, which are the following: type(\"Logging\") type(\"OpsAnalytics\")", + "location": "query", + "type": "string" + }, "pageSize": { "description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.", "format": "int32", @@ -1320,6 +1325,34 @@ "https://www.googleapis.com/auth/logging.admin" ] }, + "get": { + "description": "Returns all data associated with the requested query.", + "flatPath": "v2/billingAccounts/{billingAccountsId}/locations/{locationsId}/savedQueries/{savedQueriesId}", + "httpMethod": "GET", + "id": "logging.billingAccounts.locations.savedQueries.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name of the saved query. \"projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" \"organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" \"billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" \"folders/[FOLDER_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" For example: \"projects/my-project/locations/global/savedQueries/my-saved-query\" ", + "location": "path", + "pattern": "^billingAccounts/[^/]+/locations/[^/]+/savedQueries/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+name}", + "response": { + "$ref": "SavedQuery" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only", + "https://www.googleapis.com/auth/logging.admin", + "https://www.googleapis.com/auth/logging.read" + ] + }, "list": { "description": "Lists the SavedQueries that were created by the user making the request.", "flatPath": "v2/billingAccounts/{billingAccountsId}/locations/{locationsId}/savedQueries", @@ -1358,6 +1391,41 @@ "https://www.googleapis.com/auth/logging.admin", "https://www.googleapis.com/auth/logging.read" ] + }, + "patch": { + "description": "Updates an existing SavedQuery.", + "flatPath": "v2/billingAccounts/{billingAccountsId}/locations/{locationsId}/savedQueries/{savedQueriesId}", + "httpMethod": "PATCH", + "id": "logging.billingAccounts.locations.savedQueries.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Output only. Resource name of the saved query.In the format: \"projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" For a list of supported locations, see Supported Regions (https://cloud.google.com/logging/docs/region-support#bucket-regions)After the saved query is created, the location cannot be changed.If the user doesn't provide a QUERY_ID, the system will generate an alphanumeric ID.", + "location": "path", + "pattern": "^billingAccounts/[^/]+/locations/[^/]+/savedQueries/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. A non-empty list of fields to change in the existing saved query. Fields are relative to the saved_query and new values for the fields are taken from the corresponding fields in the SavedQuery included in this request. Fields not mentioned in update_mask are not changed and are ignored in the request.To update all mutable fields, specify an update_mask of *.For example, to change the description and query filter text of a saved query, specify an update_mask of \"description, query.filter\".", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v2/{+name}", + "request": { + "$ref": "SavedQuery" + }, + "response": { + "$ref": "SavedQuery" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/logging.admin" + ] } } } @@ -1450,7 +1518,7 @@ ], "parameters": { "customWriterIdentity": { - "description": "Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated.", + "description": "Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated.", "location": "query", "type": "string" }, @@ -1587,7 +1655,7 @@ ], "parameters": { "customWriterIdentity": { - "description": "Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated.", + "description": "Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated.", "location": "query", "type": "string" }, @@ -1632,7 +1700,7 @@ ], "parameters": { "customWriterIdentity": { - "description": "Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated.", + "description": "Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated.", "location": "query", "type": "string" }, @@ -3070,6 +3138,11 @@ "parent" ], "parameters": { + "filter": { + "description": "Optional. Specifies the type (\"Logging\" or \"OpsAnalytics\") of the recent queries to list. The only valid value for this field is one of the two allowable type function calls, which are the following: type(\"Logging\") type(\"OpsAnalytics\")", + "location": "query", + "type": "string" + }, "pageSize": { "description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.", "format": "int32", @@ -3164,6 +3237,34 @@ "https://www.googleapis.com/auth/logging.admin" ] }, + "get": { + "description": "Returns all data associated with the requested query.", + "flatPath": "v2/folders/{foldersId}/locations/{locationsId}/savedQueries/{savedQueriesId}", + "httpMethod": "GET", + "id": "logging.folders.locations.savedQueries.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name of the saved query. \"projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" \"organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" \"billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" \"folders/[FOLDER_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" For example: \"projects/my-project/locations/global/savedQueries/my-saved-query\" ", + "location": "path", + "pattern": "^folders/[^/]+/locations/[^/]+/savedQueries/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+name}", + "response": { + "$ref": "SavedQuery" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only", + "https://www.googleapis.com/auth/logging.admin", + "https://www.googleapis.com/auth/logging.read" + ] + }, "list": { "description": "Lists the SavedQueries that were created by the user making the request.", "flatPath": "v2/folders/{foldersId}/locations/{locationsId}/savedQueries", @@ -3202,6 +3303,41 @@ "https://www.googleapis.com/auth/logging.admin", "https://www.googleapis.com/auth/logging.read" ] + }, + "patch": { + "description": "Updates an existing SavedQuery.", + "flatPath": "v2/folders/{foldersId}/locations/{locationsId}/savedQueries/{savedQueriesId}", + "httpMethod": "PATCH", + "id": "logging.folders.locations.savedQueries.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Output only. Resource name of the saved query.In the format: \"projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" For a list of supported locations, see Supported Regions (https://cloud.google.com/logging/docs/region-support#bucket-regions)After the saved query is created, the location cannot be changed.If the user doesn't provide a QUERY_ID, the system will generate an alphanumeric ID.", + "location": "path", + "pattern": "^folders/[^/]+/locations/[^/]+/savedQueries/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. A non-empty list of fields to change in the existing saved query. Fields are relative to the saved_query and new values for the fields are taken from the corresponding fields in the SavedQuery included in this request. Fields not mentioned in update_mask are not changed and are ignored in the request.To update all mutable fields, specify an update_mask of *.For example, to change the description and query filter text of a saved query, specify an update_mask of \"description, query.filter\".", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v2/{+name}", + "request": { + "$ref": "SavedQuery" + }, + "response": { + "$ref": "SavedQuery" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/logging.admin" + ] } } } @@ -3294,7 +3430,7 @@ ], "parameters": { "customWriterIdentity": { - "description": "Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated.", + "description": "Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated.", "location": "query", "type": "string" }, @@ -3431,7 +3567,7 @@ ], "parameters": { "customWriterIdentity": { - "description": "Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated.", + "description": "Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated.", "location": "query", "type": "string" }, @@ -3476,7 +3612,7 @@ ], "parameters": { "customWriterIdentity": { - "description": "Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated.", + "description": "Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated.", "location": "query", "type": "string" }, @@ -5649,6 +5785,11 @@ "parent" ], "parameters": { + "filter": { + "description": "Optional. Specifies the type (\"Logging\" or \"OpsAnalytics\") of the recent queries to list. The only valid value for this field is one of the two allowable type function calls, which are the following: type(\"Logging\") type(\"OpsAnalytics\")", + "location": "query", + "type": "string" + }, "pageSize": { "description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.", "format": "int32", @@ -5743,6 +5884,34 @@ "https://www.googleapis.com/auth/logging.admin" ] }, + "get": { + "description": "Returns all data associated with the requested query.", + "flatPath": "v2/organizations/{organizationsId}/locations/{locationsId}/savedQueries/{savedQueriesId}", + "httpMethod": "GET", + "id": "logging.organizations.locations.savedQueries.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name of the saved query. \"projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" \"organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" \"billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" \"folders/[FOLDER_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" For example: \"projects/my-project/locations/global/savedQueries/my-saved-query\" ", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+/savedQueries/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+name}", + "response": { + "$ref": "SavedQuery" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only", + "https://www.googleapis.com/auth/logging.admin", + "https://www.googleapis.com/auth/logging.read" + ] + }, "list": { "description": "Lists the SavedQueries that were created by the user making the request.", "flatPath": "v2/organizations/{organizationsId}/locations/{locationsId}/savedQueries", @@ -5781,6 +5950,41 @@ "https://www.googleapis.com/auth/logging.admin", "https://www.googleapis.com/auth/logging.read" ] + }, + "patch": { + "description": "Updates an existing SavedQuery.", + "flatPath": "v2/organizations/{organizationsId}/locations/{locationsId}/savedQueries/{savedQueriesId}", + "httpMethod": "PATCH", + "id": "logging.organizations.locations.savedQueries.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Output only. Resource name of the saved query.In the format: \"projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" For a list of supported locations, see Supported Regions (https://cloud.google.com/logging/docs/region-support#bucket-regions)After the saved query is created, the location cannot be changed.If the user doesn't provide a QUERY_ID, the system will generate an alphanumeric ID.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+/savedQueries/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. A non-empty list of fields to change in the existing saved query. Fields are relative to the saved_query and new values for the fields are taken from the corresponding fields in the SavedQuery included in this request. Fields not mentioned in update_mask are not changed and are ignored in the request.To update all mutable fields, specify an update_mask of *.For example, to change the description and query filter text of a saved query, specify an update_mask of \"description, query.filter\".", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v2/{+name}", + "request": { + "$ref": "SavedQuery" + }, + "response": { + "$ref": "SavedQuery" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/logging.admin" + ] } } } @@ -5873,7 +6077,7 @@ ], "parameters": { "customWriterIdentity": { - "description": "Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated.", + "description": "Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated.", "location": "query", "type": "string" }, @@ -6010,7 +6214,7 @@ ], "parameters": { "customWriterIdentity": { - "description": "Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated.", + "description": "Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated.", "location": "query", "type": "string" }, @@ -6055,7 +6259,7 @@ ], "parameters": { "customWriterIdentity": { - "description": "Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated.", + "description": "Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated.", "location": "query", "type": "string" }, @@ -7212,6 +7416,11 @@ "parent" ], "parameters": { + "filter": { + "description": "Optional. Specifies the type (\"Logging\" or \"OpsAnalytics\") of the recent queries to list. The only valid value for this field is one of the two allowable type function calls, which are the following: type(\"Logging\") type(\"OpsAnalytics\")", + "location": "query", + "type": "string" + }, "pageSize": { "description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.", "format": "int32", @@ -7306,6 +7515,34 @@ "https://www.googleapis.com/auth/logging.admin" ] }, + "get": { + "description": "Returns all data associated with the requested query.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/savedQueries/{savedQueriesId}", + "httpMethod": "GET", + "id": "logging.projects.locations.savedQueries.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name of the saved query. \"projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" \"organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" \"billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" \"folders/[FOLDER_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" For example: \"projects/my-project/locations/global/savedQueries/my-saved-query\" ", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/savedQueries/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+name}", + "response": { + "$ref": "SavedQuery" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only", + "https://www.googleapis.com/auth/logging.admin", + "https://www.googleapis.com/auth/logging.read" + ] + }, "list": { "description": "Lists the SavedQueries that were created by the user making the request.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/savedQueries", @@ -7344,6 +7581,41 @@ "https://www.googleapis.com/auth/logging.admin", "https://www.googleapis.com/auth/logging.read" ] + }, + "patch": { + "description": "Updates an existing SavedQuery.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/savedQueries/{savedQueriesId}", + "httpMethod": "PATCH", + "id": "logging.projects.locations.savedQueries.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Output only. Resource name of the saved query.In the format: \"projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" For a list of supported locations, see Supported Regions (https://cloud.google.com/logging/docs/region-support#bucket-regions)After the saved query is created, the location cannot be changed.If the user doesn't provide a QUERY_ID, the system will generate an alphanumeric ID.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/savedQueries/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. A non-empty list of fields to change in the existing saved query. Fields are relative to the saved_query and new values for the fields are taken from the corresponding fields in the SavedQuery included in this request. Fields not mentioned in update_mask are not changed and are ignored in the request.To update all mutable fields, specify an update_mask of *.For example, to change the description and query filter text of a saved query, specify an update_mask of \"description, query.filter\".", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v2/{+name}", + "request": { + "$ref": "SavedQuery" + }, + "response": { + "$ref": "SavedQuery" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/logging.admin" + ] } } } @@ -7594,7 +7866,7 @@ ], "parameters": { "customWriterIdentity": { - "description": "Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated.", + "description": "Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated.", "location": "query", "type": "string" }, @@ -7731,7 +8003,7 @@ ], "parameters": { "customWriterIdentity": { - "description": "Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated.", + "description": "Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated.", "location": "query", "type": "string" }, @@ -7776,7 +8048,7 @@ ], "parameters": { "customWriterIdentity": { - "description": "Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated.", + "description": "Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated.", "location": "query", "type": "string" }, @@ -7827,7 +8099,7 @@ ], "parameters": { "customWriterIdentity": { - "description": "Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated.", + "description": "Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated.", "location": "query", "type": "string" }, @@ -7964,7 +8236,7 @@ ], "parameters": { "customWriterIdentity": { - "description": "Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated.", + "description": "Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated.", "location": "query", "type": "string" }, @@ -8132,7 +8404,7 @@ } } }, - "revision": "20240503", + "revision": "20240620", "rootUrl": "https://logging.googleapis.com/", "schemas": { "AuditConfig": { @@ -8629,12 +8901,12 @@ "type": "boolean" }, "latency": { - "description": "The request processing latency on the server, from the time the request was received until the response was sent.", + "description": "The request processing latency on the server, from the time the request was received until the response was sent. For WebSocket connections, this field refers to the entire time duration of the connection.", "format": "google-duration", "type": "string" }, "protocol": { - "description": "Protocol used for the request. Examples: \"HTTP/1.1\", \"HTTP/2\", \"websocket\"", + "description": "Protocol used for the request. Examples: \"HTTP/1.1\", \"HTTP/2\"", "type": "string" }, "referer": { diff --git a/discovery/meet-v2.json b/discovery/meet-v2.json index a1e8c12ee9..54ef93fb5a 100644 --- a/discovery/meet-v2.json +++ b/discovery/meet-v2.json @@ -144,7 +144,7 @@ "parameterOrder": [], "parameters": { "filter": { - "description": "Optional. User specified filtering condition in [EBNF format](https://en.wikipedia.org/wiki/Extended_Backus%E2%80%93Naur_form). The following are the filterable fields: * `space.meeting_code` * `space.name` * `start_time` * `end_time` For example, `space.meeting_code = \"abc-mnop-xyz\"`.", + "description": "Optional. User specified filtering condition in [EBNF format](https://en.wikipedia.org/wiki/Extended_Backus%E2%80%93Naur_form). The following are the filterable fields: * `space.meeting_code` * `space.name` * `start_time` * `end_time` For example, consider the following filters: * `space.name = \"spaces/NAME\"` * `space.meeting_code = \"abc-mnop-xyz\"` * `start_time>=\"2024-01-01T00:00:00.000Z\" AND start_time<=\"2024-01-02T00:00:00.000Z\"` * `end_time IS NULL`", "location": "query", "type": "string" }, @@ -633,7 +633,7 @@ } } }, - "revision": "20240625", + "revision": "20240627", "rootUrl": "https://meet.googleapis.com/", "schemas": { "ActiveConference": { diff --git a/discovery/monitoring-v1.json b/discovery/monitoring-v1.json index 6bc026bc06..454cbb34e7 100644 --- a/discovery/monitoring-v1.json +++ b/discovery/monitoring-v1.json @@ -753,7 +753,7 @@ } } }, - "revision": "20240616", + "revision": "20240623", "rootUrl": "https://monitoring.googleapis.com/", "schemas": { "Aggregation": { @@ -1644,7 +1644,7 @@ "type": "string" }, "resourceNames": { - "description": "The names of logging resources to collect logs for. Currently only projects are supported. If empty, the widget will default to the host project.", + "description": "The names of logging resources to collect logs for. Currently projects and storage views are supported. If empty, the widget will default to the host project.", "items": { "type": "string" }, diff --git a/discovery/pubsub-v1.json b/discovery/pubsub-v1.json index 12ae0e1292..30116a81a4 100644 --- a/discovery/pubsub-v1.json +++ b/discovery/pubsub-v1.json @@ -1583,7 +1583,7 @@ } } }, - "revision": "20240613", + "revision": "20240618", "rootUrl": "https://pubsub.googleapis.com/", "schemas": { "AcknowledgeRequest": { @@ -1600,6 +1600,21 @@ }, "type": "object" }, + "AnalyticsHubSubscriptionInfo": { + "description": "Information about an associated Analytics Hub subscription (https://cloud.google.com/bigquery/docs/analytics-hub-manage-subscriptions).", + "id": "AnalyticsHubSubscriptionInfo", + "properties": { + "listing": { + "description": "Optional. The name of the associated Analytics Hub listing resource. Pattern: \"projects/{project}/locations/{location}/dataExchanges/{data_exchange}/listings/{listing}\"", + "type": "string" + }, + "subscription": { + "description": "Optional. The name of the associated Analytics Hub subscription resource. Pattern: \"projects/{project}/locations/{location}/subscriptions/{subscription}\"", + "type": "string" + } + }, + "type": "object" + }, "AvroConfig": { "description": "Configuration for writing message data in Avro format. Message payloads and metadata will be written to files as an Avro binary.", "id": "AvroConfig", @@ -2443,6 +2458,11 @@ "format": "int32", "type": "integer" }, + "analyticsHubSubscriptionInfo": { + "$ref": "AnalyticsHubSubscriptionInfo", + "description": "Output only. Information about the associated Analytics Hub subscription. Only set if the subscritpion is created by Analytics Hub.", + "readOnly": true + }, "bigqueryConfig": { "$ref": "BigQueryConfig", "description": "Optional. If delivery to BigQuery is used with this subscription, this field is used to configure it." diff --git a/discovery/servicenetworking-v1.json b/discovery/servicenetworking-v1.json index a633f763a9..7491df43d9 100644 --- a/discovery/servicenetworking-v1.json +++ b/discovery/servicenetworking-v1.json @@ -1029,7 +1029,7 @@ } } }, - "revision": "20240529", + "revision": "20240626", "rootUrl": "https://servicenetworking.googleapis.com/", "schemas": { "AddDnsRecordSetMetadata": { @@ -1957,7 +1957,7 @@ "type": "object" }, "Documentation": { - "description": "`Documentation` provides the information for describing a service. Example: documentation: summary: > The Google Calendar API gives access to most calendar features. pages: - name: Overview content: (== include google/foo/overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==) subpages: - name: Java content: (== include google/foo/tutorial_java.md ==) rules: - selector: google.calendar.Calendar.Get description: > ... - selector: google.calendar.Calendar.Put description: > ... Documentation is provided in markdown syntax. In addition to standard markdown features, definition lists, tables and fenced code blocks are supported. Section headers can be provided and are interpreted relative to the section nesting of the context where a documentation fragment is embedded. Documentation from the IDL is merged with documentation defined via the config at normalization time, where documentation provided by config rules overrides IDL provided. A number of constructs specific to the API platform are supported in documentation text. In order to reference a proto element, the following notation can be used: [fully.qualified.proto.name][] To override the display text used for the link, this can be used: [display text][fully.qualified.proto.name] Text can be excluded from doc using the following notation: (-- internal comment --) A few directives are available in documentation. Note that directives must appear on a single line to be properly identified. The `include` directive includes a markdown file from an external source: (== include path/to/file ==) The `resource_for` directive marks a message to be the resource of a collection in REST view. If it is not specified, tools attempt to infer the resource from the operations in a collection: (== resource_for v1.shelves.books ==) The directive `suppress_warning` does not directly affect documentation and is documented together with service config validation.", + "description": "`Documentation` provides the information for describing a service. Example: documentation: summary: > The Google Calendar API gives access to most calendar features. pages: - name: Overview content: (== include google/foo/overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==) subpages: - name: Java content: (== include google/foo/tutorial_java.md ==) rules: - selector: google.calendar.Calendar.Get description: > ... - selector: google.calendar.Calendar.Put description: > ... code_snippet_rules: - selector: google.calendar.Calendar.Delete code_snippets: - includes: - github_include: region_tag: calendar_delete code_language: JAVA account: GoogleCloudPlatform project: java-docs-samples file: calendar/delete.java Documentation is provided in markdown syntax. In addition to standard markdown features, definition lists, tables and fenced code blocks are supported. Section headers can be provided and are interpreted relative to the section nesting of the context where a documentation fragment is embedded. Documentation from the IDL is merged with documentation defined via the config at normalization time, where documentation provided by config rules overrides IDL provided. A number of constructs specific to the API platform are supported in documentation text. In order to reference a proto element, the following notation can be used: [fully.qualified.proto.name][] To override the display text used for the link, this can be used: [display text][fully.qualified.proto.name] Text can be excluded from doc using the following notation: (-- internal comment --) A few directives are available in documentation. Note that directives must appear on a single line to be properly identified. The `include` directive includes a markdown file from an external source: (== include path/to/file ==) The `resource_for` directive marks a message to be the resource of a collection in REST view. If it is not specified, tools attempt to infer the resource from the operations in a collection: (== resource_for v1.shelves.books ==) The directive `suppress_warning` does not directly affect documentation and is documented together with service config validation.", "id": "Documentation", "properties": { "documentationRootUrl": { diff --git a/discovery/servicenetworking-v1beta.json b/discovery/servicenetworking-v1beta.json index 7f00409b50..edfdf0293d 100644 --- a/discovery/servicenetworking-v1beta.json +++ b/discovery/servicenetworking-v1beta.json @@ -307,7 +307,7 @@ } } }, - "revision": "20240529", + "revision": "20240626", "rootUrl": "https://servicenetworking.googleapis.com/", "schemas": { "AddDnsRecordSetMetadata": { @@ -1073,7 +1073,7 @@ "type": "object" }, "Documentation": { - "description": "`Documentation` provides the information for describing a service. Example: documentation: summary: > The Google Calendar API gives access to most calendar features. pages: - name: Overview content: (== include google/foo/overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==) subpages: - name: Java content: (== include google/foo/tutorial_java.md ==) rules: - selector: google.calendar.Calendar.Get description: > ... - selector: google.calendar.Calendar.Put description: > ... Documentation is provided in markdown syntax. In addition to standard markdown features, definition lists, tables and fenced code blocks are supported. Section headers can be provided and are interpreted relative to the section nesting of the context where a documentation fragment is embedded. Documentation from the IDL is merged with documentation defined via the config at normalization time, where documentation provided by config rules overrides IDL provided. A number of constructs specific to the API platform are supported in documentation text. In order to reference a proto element, the following notation can be used: [fully.qualified.proto.name][] To override the display text used for the link, this can be used: [display text][fully.qualified.proto.name] Text can be excluded from doc using the following notation: (-- internal comment --) A few directives are available in documentation. Note that directives must appear on a single line to be properly identified. The `include` directive includes a markdown file from an external source: (== include path/to/file ==) The `resource_for` directive marks a message to be the resource of a collection in REST view. If it is not specified, tools attempt to infer the resource from the operations in a collection: (== resource_for v1.shelves.books ==) The directive `suppress_warning` does not directly affect documentation and is documented together with service config validation.", + "description": "`Documentation` provides the information for describing a service. Example: documentation: summary: > The Google Calendar API gives access to most calendar features. pages: - name: Overview content: (== include google/foo/overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==) subpages: - name: Java content: (== include google/foo/tutorial_java.md ==) rules: - selector: google.calendar.Calendar.Get description: > ... - selector: google.calendar.Calendar.Put description: > ... code_snippet_rules: - selector: google.calendar.Calendar.Delete code_snippets: - includes: - github_include: region_tag: calendar_delete code_language: JAVA account: GoogleCloudPlatform project: java-docs-samples file: calendar/delete.java Documentation is provided in markdown syntax. In addition to standard markdown features, definition lists, tables and fenced code blocks are supported. Section headers can be provided and are interpreted relative to the section nesting of the context where a documentation fragment is embedded. Documentation from the IDL is merged with documentation defined via the config at normalization time, where documentation provided by config rules overrides IDL provided. A number of constructs specific to the API platform are supported in documentation text. In order to reference a proto element, the following notation can be used: [fully.qualified.proto.name][] To override the display text used for the link, this can be used: [display text][fully.qualified.proto.name] Text can be excluded from doc using the following notation: (-- internal comment --) A few directives are available in documentation. Note that directives must appear on a single line to be properly identified. The `include` directive includes a markdown file from an external source: (== include path/to/file ==) The `resource_for` directive marks a message to be the resource of a collection in REST view. If it is not specified, tools attempt to infer the resource from the operations in a collection: (== resource_for v1.shelves.books ==) The directive `suppress_warning` does not directly affect documentation and is documented together with service config validation.", "id": "Documentation", "properties": { "documentationRootUrl": { diff --git a/discovery/sqladmin-v1.json b/discovery/sqladmin-v1.json index 714597fb0a..935f713a88 100644 --- a/discovery/sqladmin-v1.json +++ b/discovery/sqladmin-v1.json @@ -2267,7 +2267,7 @@ } } }, - "revision": "20240618", + "revision": "20240622", "rootUrl": "https://sqladmin.googleapis.com/", "schemas": { "AclEntry": { @@ -3711,6 +3711,20 @@ "description": "Optional. Whether or not the export should be parallel.", "type": "boolean" }, + "postgresExportOptions": { + "description": "Options for exporting from a Cloud SQL for PostgreSQL instance.", + "properties": { + "clean": { + "description": "Optional. Use this option to include DROP SQL statements. These statements are used to delete database objects before running the import operation.", + "type": "boolean" + }, + "ifExists": { + "description": "Optional. Option to include an IF EXISTS SQL statement with each DROP statement produced by clean.", + "type": "boolean" + } + }, + "type": "object" + }, "schemaOnly": { "description": "Export only schemas.", "type": "boolean" @@ -4193,6 +4207,20 @@ "description": "Optional. Whether or not the import should be parallel.", "type": "boolean" }, + "postgresImportOptions": { + "description": "Optional. Options for importing from a Cloud SQL for PostgreSQL instance.", + "properties": { + "clean": { + "description": "Optional. The --clean flag for the pg_restore utility. This flag applies only if you enabled Cloud SQL to import files in parallel.", + "type": "boolean" + }, + "ifExists": { + "description": "Optional. The --if-exists flag for the pg_restore utility. This flag applies only if you enabled Cloud SQL to import files in parallel.", + "type": "boolean" + } + }, + "type": "object" + }, "threads": { "description": "Optional. The number of threads to use for parallel import.", "format": "int32", diff --git a/discovery/sqladmin-v1beta4.json b/discovery/sqladmin-v1beta4.json index 40660b458c..2e619e43fa 100644 --- a/discovery/sqladmin-v1beta4.json +++ b/discovery/sqladmin-v1beta4.json @@ -2267,7 +2267,7 @@ } } }, - "revision": "20240618", + "revision": "20240622", "rootUrl": "https://sqladmin.googleapis.com/", "schemas": { "AclEntry": { @@ -3712,6 +3712,20 @@ "description": "Optional. Whether or not the export should be parallel.", "type": "boolean" }, + "postgresExportOptions": { + "description": "Options for exporting from a Cloud SQL for PostgreSQL instance.", + "properties": { + "clean": { + "description": "Optional. Use this option to include DROP SQL statements. These statements are used to delete database objects before running the import operation.", + "type": "boolean" + }, + "ifExists": { + "description": "Optional. Option to include an IF EXISTS SQL statement with each DROP statement produced by clean.", + "type": "boolean" + } + }, + "type": "object" + }, "schemaOnly": { "description": "Export only schemas.", "type": "boolean" @@ -4194,6 +4208,20 @@ "description": "Optional. Whether or not the import should be parallel.", "type": "boolean" }, + "postgresImportOptions": { + "description": "Optional. Options for importing from a Cloud SQL for PostgreSQL instance.", + "properties": { + "clean": { + "description": "Optional. The --clean flag for the pg_restore utility. This flag applies only if you enabled Cloud SQL to import files in parallel.", + "type": "boolean" + }, + "ifExists": { + "description": "Optional. The --if-exists flag for the pg_restore utility. This flag applies only if you enabled Cloud SQL to import files in parallel.", + "type": "boolean" + } + }, + "type": "object" + }, "threads": { "description": "Optional. The number of threads to use for parallel import.", "format": "int32", diff --git a/discovery/walletobjects-v1.json b/discovery/walletobjects-v1.json index 29462e4d5f..45fa23b42c 100644 --- a/discovery/walletobjects-v1.json +++ b/discovery/walletobjects-v1.json @@ -2681,7 +2681,7 @@ } } }, - "revision": "20240626", + "revision": "20240628", "rootUrl": "https://walletobjects.googleapis.com/", "schemas": { "ActivationOptions": { @@ -8264,7 +8264,7 @@ "type": "string" }, "id": { - "description": "The ID associated with a text module. This field is here to enable ease of management of text modules.", + "description": "The ID associated with a text module. This field is here to enable ease of management of text modules and referencing them in template overrides. The ID should only include alphanumeric characters, '_', or '-'. It can not include dots, as dots are used to separate fields within FieldReference.fieldPaths in template overrides.", "type": "string" }, "localizedBody": { diff --git a/discovery/workstations-v1beta.json b/discovery/workstations-v1beta.json index d156cda52a..6a06a9a850 100644 --- a/discovery/workstations-v1beta.json +++ b/discovery/workstations-v1beta.json @@ -1127,7 +1127,7 @@ } } }, - "revision": "20240528", + "revision": "20240619", "rootUrl": "https://workstations.googleapis.com/", "schemas": { "Accelerator": { @@ -1595,6 +1595,17 @@ }, "type": "object" }, + "HttpOptions": { + "description": "Http options for the running workstations.", + "id": "HttpOptions", + "properties": { + "allowedUnauthenticatedCorsPreflightRequests": { + "description": "Optional. By default, the workstations service makes sure that all requests to the workstation are authenticated. CORS preflight requests do not include cookies or custom headers, and so are considered unauthenticated and blocked by the workstations service. Enabling this option allows these unauthenticated CORS preflight requests through to the workstation, where it becomes the responsibility of the destination server in the workstation to validate the request.", + "type": "boolean" + } + }, + "type": "object" + }, "ListOperationsResponse": { "description": "The response message for Operations.ListOperations.", "id": "ListOperationsResponse", @@ -2088,6 +2099,10 @@ "readOnly": true, "type": "boolean" }, + "sourceWorkstation": { + "description": "Optional. The source workstation from which this workstations persistent directories were cloned on creation.", + "type": "string" + }, "startTime": { "description": "Output only. Time when this workstation was most recently successfully started, regardless of the workstation's initial state.", "format": "google-datetime", @@ -2300,6 +2315,10 @@ "$ref": "Host", "description": "Optional. Runtime host for the workstation." }, + "httpOptions": { + "$ref": "HttpOptions", + "description": "Optional. Http options that customize the behavior of the workstation service's http proxy." + }, "idleTimeout": { "description": "Optional. Number of seconds to wait before automatically stopping a workstation after it last received user traffic. A value of `\"0s\"` indicates that Cloud Workstations VMs created with this configuration should never time out due to idleness. Provide [duration](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#duration) terminated by `s` for seconds—for example, `\"7200s\"` (2 hours). The default is `\"1200s\"` (20 minutes).", "format": "google-duration", diff --git a/src/apis/analyticshub/v1.ts b/src/apis/analyticshub/v1.ts index 12acd5bb04..427ba15534 100644 --- a/src/apis/analyticshub/v1.ts +++ b/src/apis/analyticshub/v1.ts @@ -126,6 +126,19 @@ export namespace analyticshub_v1 { } } + /** + * Information about an associated Analytics Hub subscription (https://cloud.google.com/bigquery/docs/analytics-hub-manage-subscriptions). + */ + export interface Schema$AnalyticsHubSubscriptionInfo { + /** + * Optional. The name of the associated Analytics Hub listing resource. Pattern: "projects/{project\}/locations/{location\}/dataExchanges/{data_exchange\}/listings/{listing\}" + */ + listing?: string | null; + /** + * Optional. The name of the associated Analytics Hub subscription resource. Pattern: "projects/{project\}/locations/{location\}/subscriptions/{subscription\}" + */ + subscription?: string | null; + } /** * Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { "audit_configs": [ { "service": "allServices", "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] \}, { "log_type": "DATA_WRITE" \}, { "log_type": "ADMIN_READ" \} ] \}, { "service": "sampleservice.googleapis.com", "audit_log_configs": [ { "log_type": "DATA_READ" \}, { "log_type": "DATA_WRITE", "exempted_members": [ "user:aliya@example.com" ] \} ] \} ] \} For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts `jose@example.com` from DATA_READ logging, and `aliya@example.com` from DATA_WRITE logging. */ @@ -152,6 +165,52 @@ export namespace analyticshub_v1 { */ logType?: string | null; } + /** + * Configuration for writing message data in Avro format. Message payloads and metadata will be written to files as an Avro binary. + */ + export interface Schema$AvroConfig { + /** + * Optional. When true, the output Cloud Storage file will be serialized using the topic schema, if it exists. + */ + useTopicSchema?: boolean | null; + /** + * Optional. When true, write the subscription name, message_id, publish_time, attributes, and ordering_key as additional fields in the output. The subscription name, message_id, and publish_time fields are put in their own fields while all other message properties other than data (for example, an ordering_key, if present) are added as entries in the attributes map. + */ + writeMetadata?: boolean | null; + } + /** + * Configuration for a BigQuery subscription. + */ + export interface Schema$BigQueryConfig { + /** + * Optional. When true and use_topic_schema is true, any fields that are a part of the topic schema that are not part of the BigQuery table schema are dropped when writing to BigQuery. Otherwise, the schemas must be kept in sync and any messages with extra fields are not written and remain in the subscription's backlog. + */ + dropUnknownFields?: boolean | null; + /** + * Optional. The service account to use to write to BigQuery. The subscription creator or updater that specifies this field must have `iam.serviceAccounts.actAs` permission on the service account. If not specified, the Pub/Sub [service agent](https://cloud.google.com/iam/docs/service-agents), service-{project_number\}@gcp-sa-pubsub.iam.gserviceaccount.com, is used. + */ + serviceAccountEmail?: string | null; + /** + * Output only. An output-only field that indicates whether or not the subscription can receive messages. + */ + state?: string | null; + /** + * Optional. The name of the table to which to write data, of the form {projectId\}.{datasetId\}.{tableId\} + */ + table?: string | null; + /** + * Optional. When true, use the BigQuery table's schema as the columns to write to in BigQuery. `use_table_schema` and `use_topic_schema` cannot be enabled at the same time. + */ + useTableSchema?: boolean | null; + /** + * Optional. When true, use the topic's schema as the columns to write to in BigQuery, if it exists. `use_topic_schema` and `use_table_schema` cannot be enabled at the same time. + */ + useTopicSchema?: boolean | null; + /** + * Optional. When true, write the subscription name, message_id, publish_time, attributes, and ordering_key to additional columns in the table. The subscription name, message_id, and publish_time fields are put in their own columns while all other message properties (other than data) are written to a JSON object in the attributes column. + */ + writeMetadata?: boolean | null; + } /** * A reference to a shared dataset. It is an existing BigQuery dataset with a collection of objects such as tables and views that you want to share with subscribers. When subscriber's subscribe to a listing, Analytics Hub creates a linked dataset in the subscriber's project. A Linked dataset is an opaque, read-only BigQuery dataset that serves as a _symbolic link_ to a shared dataset. */ @@ -165,7 +224,7 @@ export namespace analyticshub_v1 { */ restrictedExportPolicy?: Schema$RestrictedExportPolicy; /** - * Optional. Resources in this dataset that are selectively shared. If this field is empty, then the entire dataset (all resources) are shared. This field is only valid for data clean room exchanges. + * Optional. Resource in this dataset that is selectively shared. This field is required for data clean room exchanges. */ selectedResources?: Schema$SelectedResource[]; } @@ -186,6 +245,55 @@ export namespace analyticshub_v1 { */ role?: string | null; } + /** + * Configuration for a Cloud Storage subscription. + */ + export interface Schema$CloudStorageConfig { + /** + * Optional. If set, message data will be written to Cloud Storage in Avro format. + */ + avroConfig?: Schema$AvroConfig; + /** + * Required. User-provided name for the Cloud Storage bucket. The bucket must be created by the user. The bucket name must be without any prefix like "gs://". See the [bucket naming requirements] (https://cloud.google.com/storage/docs/buckets#naming). + */ + bucket?: string | null; + /** + * Optional. User-provided format string specifying how to represent datetimes in Cloud Storage filenames. See the [datetime format guidance](https://cloud.google.com/pubsub/docs/create-cloudstorage-subscription#file_names). + */ + filenameDatetimeFormat?: string | null; + /** + * Optional. User-provided prefix for Cloud Storage filename. See the [object naming requirements](https://cloud.google.com/storage/docs/objects#naming). + */ + filenamePrefix?: string | null; + /** + * Optional. User-provided suffix for Cloud Storage filename. See the [object naming requirements](https://cloud.google.com/storage/docs/objects#naming). Must not end in "/". + */ + filenameSuffix?: string | null; + /** + * Optional. The maximum bytes that can be written to a Cloud Storage file before a new file is created. Min 1 KB, max 10 GiB. The max_bytes limit may be exceeded in cases where messages are larger than the limit. + */ + maxBytes?: string | null; + /** + * 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. + */ + maxDuration?: string | null; + /** + * Optional. The maximum number of messages that can be written to a Cloud Storage file before a new file is created. Min 1000 messages. + */ + maxMessages?: string | null; + /** + * Optional. The service account to use to write to Cloud Storage. The subscription creator or updater that specifies this field must have `iam.serviceAccounts.actAs` permission on the service account. If not specified, the Pub/Sub [service agent](https://cloud.google.com/iam/docs/service-agents), service-{project_number\}@gcp-sa-pubsub.iam.gserviceaccount.com, is used. + */ + serviceAccountEmail?: string | null; + /** + * Output only. An output-only field that indicates whether or not the subscription can receive messages. + */ + state?: string | null; + /** + * Optional. If set, message data will be written to Cloud Storage in text format. + */ + textConfig?: Schema$TextConfig; + } /** * A data exchange is a container that lets you share data. Along with the descriptive information about the data exchange, it contains listings that reference shared datasets. */ @@ -194,6 +302,10 @@ export namespace analyticshub_v1 { * Optional. Description of the data exchange. The description must not contain Unicode non-characters as well as C0 and C1 control codes except tabs (HT), new lines (LF), carriage returns (CR), and page breaks (FF). Default value is an empty string. Max length: 2000 bytes. */ description?: string | null; + /** + * Optional. Type of discovery on the discovery page for all the listings under this exchange. Updating this field also updates (overwrites) the discovery_type field for all the listings under this exchange. + */ + discoveryType?: string | null; /** * Required. Human-readable display name of the data exchange. The display name must contain only Unicode letters, numbers (0-9), underscores (_), dashes (-), spaces ( ), ampersands (&) and must not start or end with spaces. Default value is an empty string. Max length: 63 bytes. */ @@ -249,6 +361,19 @@ export namespace analyticshub_v1 { */ singleSelectedResourceSharingRestriction?: boolean | null; } + /** + * Dead lettering is done on a best effort basis. The same message might be dead lettered multiple times. If validation on any of the fields fails at subscription creation/updation, the create/update subscription request will fail. + */ + export interface Schema$DeadLetterPolicy { + /** + * Optional. The name of the topic to which dead letter messages should be published. Format is `projects/{project\}/topics/{topic\}`.The Pub/Sub service account associated with the enclosing subscription's parent project (i.e., service-{project_number\}@gcp-sa-pubsub.iam.gserviceaccount.com) must have permission to Publish() to this topic. The operation will fail if the topic does not exist. Users should ensure that there is a subscription attached to this topic since messages published to a topic with no subscriptions are lost. + */ + deadLetterTopic?: string | null; + /** + * Optional. The maximum number of delivery attempts for any message. The 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 for the message). A NACK is any call to ModifyAckDeadline with a 0 deadline. Note that client libraries may automatically extend ack_deadlines. This field will be honored on a best effort basis. If this parameter is 0, a default value of 5 is used. + */ + maxDeliveryAttempts?: number | null; + } /** * Default Analytics Hub data exchange, used for secured data sharing. */ @@ -291,10 +416,28 @@ export namespace analyticshub_v1 { */ projectId?: string | null; } + /** + * Defines the destination Pub/Sub subscription. + */ + export interface Schema$DestinationPubSubSubscription { + /** + * Required. Destination Pub/Sub subscription resource. + */ + pubsubSubscription?: Schema$GooglePubsubV1Subscription; + } /** * A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); \} */ export interface Schema$Empty {} + /** + * A policy that specifies the conditions for resource expiration (i.e., automatic resource deletion). + */ + export interface Schema$ExpirationPolicy { + /** + * Optional. Specifies the "time-to-live" duration for an associated resource. The resource expires if it is not active for a period of `ttl`. The definition of "activity" depends on the type of the associated resource. The minimum and maximum allowed values for `ttl` depend on the type of the associated resource, as well. If `ttl` is not set, the associated resource never expires. + */ + ttl?: string | null; + } /** * Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: "Summary size limit" description: "Determines if a summary is less than 100 chars" expression: "document.summary.size() < 100" Example (Equality): title: "Requestor is owner" description: "Determines if requestor is the document owner" expression: "document.owner == request.auth.claims.email" Example (Logic): title: "Public documents" description: "Determine whether the document should be publicly visible" expression: "document.type != 'private' && document.type != 'internal'" Example (Data Manipulation): title: "Notification string" description: "Create a notification string with a timestamp." expression: "'New message received at ' + string(document.create_time)" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information. */ @@ -334,6 +477,83 @@ export namespace analyticshub_v1 { */ requestedPolicyVersion?: number | null; } + /** + * A subscription resource. If none of `push_config`, `bigquery_config`, or `cloud_storage_config` is set, then the subscriber will pull and ack messages using API methods. At most one of these fields may be set. + */ + export interface Schema$GooglePubsubV1Subscription { + /** + * Optional. The approximate amount of time (on a best-effort basis) Pub/Sub waits for the subscriber to acknowledge receipt before resending the message. In the interval after the message is delivered and before it is acknowledged, it is considered to be _outstanding_. During that time period, the message will not be redelivered (on a best-effort basis). For pull subscriptions, this value is used as the initial value for the ack deadline. To override this value for a given message, call `ModifyAckDeadline` with the corresponding `ack_id` if using non-streaming pull or send the `ack_id` in a `StreamingModifyAckDeadlineRequest` if using streaming pull. The minimum custom deadline you can specify is 10 seconds. The maximum custom deadline you can specify is 600 seconds (10 minutes). If this parameter is 0, a default value of 10 seconds is used. For push delivery, this value is also used to set the request timeout for the call to the push endpoint. If the subscriber never acknowledges the message, the Pub/Sub system will eventually redeliver the message. + */ + ackDeadlineSeconds?: number | null; + /** + * Output only. Information about the associated Analytics Hub subscription. Only set if the subscritpion is created by Analytics Hub. + */ + analyticsHubSubscriptionInfo?: Schema$AnalyticsHubSubscriptionInfo; + /** + * Optional. If delivery to BigQuery is used with this subscription, this field is used to configure it. + */ + bigqueryConfig?: Schema$BigQueryConfig; + /** + * Optional. If delivery to Google Cloud Storage is used with this subscription, this field is used to configure it. + */ + cloudStorageConfig?: Schema$CloudStorageConfig; + /** + * Optional. A policy that specifies the conditions for dead lettering messages in this subscription. If dead_letter_policy is not set, dead lettering is disabled. The Pub/Sub service account associated with this subscriptions's parent project (i.e., service-{project_number\}@gcp-sa-pubsub.iam.gserviceaccount.com) must have permission to Acknowledge() messages on this subscription. + */ + deadLetterPolicy?: Schema$DeadLetterPolicy; + /** + * Optional. Indicates whether the subscription is detached from its topic. Detached subscriptions don't receive messages from their topic and don't retain any backlog. `Pull` and `StreamingPull` requests will return FAILED_PRECONDITION. If the subscription is a push subscription, pushes to the endpoint will not be made. + */ + detached?: boolean | null; + /** + * Optional. If true, Pub/Sub provides the following guarantees for the delivery of a message with a given value of `message_id` on this subscription: * The message sent to a subscriber is guaranteed not to be resent before the message's acknowledgement deadline expires. * An acknowledged message will not be resent to a subscriber. Note that subscribers may still receive multiple copies of a message when `enable_exactly_once_delivery` is true if the message was published multiple times by a publisher client. These copies are considered distinct by Pub/Sub and have distinct `message_id` values. + */ + enableExactlyOnceDelivery?: boolean | null; + /** + * Optional. If true, messages published with the same `ordering_key` in `PubsubMessage` will be delivered to the subscribers in the order in which they are received by the Pub/Sub system. Otherwise, they may be delivered in any order. + */ + enableMessageOrdering?: boolean | null; + /** + * Optional. A policy that specifies the conditions for this subscription's expiration. A subscription is considered active as long as any connected subscriber is successfully consuming messages from the subscription or is issuing operations on the subscription. If `expiration_policy` is not set, a *default policy* with `ttl` of 31 days will be used. The minimum allowed value for `expiration_policy.ttl` is 1 day. If `expiration_policy` is set, but `expiration_policy.ttl` is not set, the subscription never expires. + */ + expirationPolicy?: Schema$ExpirationPolicy; + /** + * Optional. An expression written in the Pub/Sub [filter language](https://cloud.google.com/pubsub/docs/filtering). If non-empty, then only `PubsubMessage`s whose `attributes` field matches the filter are delivered on this subscription. If empty, then no messages are filtered out. + */ + filter?: string | null; + /** + * Optional. See [Creating and managing labels](https://cloud.google.com/pubsub/docs/labels). + */ + labels?: {[key: string]: string} | null; + /** + * Optional. How long to retain unacknowledged messages in the subscription's backlog, from the moment a message is published. If `retain_acked_messages` is true, then this also configures the retention of acknowledged messages, and thus configures how far back in time a `Seek` can be done. Defaults to 7 days. Cannot be more than 7 days or less than 10 minutes. + */ + messageRetentionDuration?: string | null; + /** + * Required. Name of the subscription. Format is `projects/{project\}/subscriptions/{sub\}`. + */ + name?: string | null; + /** + * Optional. If push delivery is used with this subscription, this field is used to configure it. + */ + pushConfig?: Schema$PushConfig; + /** + * Optional. Indicates whether to retain acknowledged messages. If true, then messages are not expunged from the subscription's backlog, even if they are acknowledged, until they fall out of the `message_retention_duration` window. This must be true if you would like to [`Seek` to a timestamp] (https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time) in the past to replay previously-acknowledged messages. + */ + retainAckedMessages?: boolean | null; + /** + * Optional. A policy that specifies how Pub/Sub retries message delivery for this 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?: Schema$RetryPolicy; + /** + * Output only. An output-only field indicating whether or not the subscription can receive messages. + */ + state?: string | null; + /** + * Output only. Indicates the minimum duration for which a message is retained after it is published to the subscription's topic. If this field is set, messages published to the subscription's topic in the last `topic_message_retention_duration` are always available to subscribers. See the `message_retention_duration` field in `Topic`. This field is set only in responses from the server; it is ignored if it is set in any requests. + */ + topicMessageRetentionDuration?: string | null; + } /** * Reference to a linked resource tracked by this Subscription. */ @@ -342,6 +562,14 @@ export namespace analyticshub_v1 { * Output only. Name of the linked dataset, e.g. projects/subscriberproject/datasets/linked_dataset */ linkedDataset?: string | null; + /** + * Output only. Name of the Pub/Sub subscription, e.g. projects/subscriberproject/subscriptions/subscriptions/sub_id + */ + linkedPubsubSubscription?: string | null; + /** + * Output only. Listing for which linked resource is created. + */ + listing?: string | null; } /** * Message for response to the list of data exchanges. @@ -376,6 +604,10 @@ export namespace analyticshub_v1 { * Optional. Short description of the listing. The description must not contain Unicode non-characters and C0 and C1 control codes except tabs (HT), new lines (LF), carriage returns (CR), and page breaks (FF). Default value is an empty string. Max length: 2000 bytes. */ description?: string | null; + /** + * Optional. Type of discovery of the listing on the discovery page. + */ + discoveryType?: string | null; /** * Required. Human-readable display name of the listing. The display name must contain only Unicode letters, numbers (0-9), underscores (_), dashes (-), spaces ( ), ampersands (&) and can't start or end with spaces. Default value is an empty string. Max length: 63 bytes. */ @@ -400,10 +632,18 @@ export namespace analyticshub_v1 { * Optional. Details of the publisher who owns the listing and who can share the source data. */ publisher?: Schema$Publisher; + /** + * Required. Pub/Sub topic source. + */ + pubsubTopic?: Schema$PubSubTopicSource; /** * Optional. Email or URL of the request access of the listing. Subscribers can use this reference to request access. Max Length: 1000 bytes. */ requestAccess?: string | null; + /** + * Output only. Listing shared asset type. + */ + resourceType?: string | null; /** * Optional. If set, restricted export configuration will be propagated and enforced on the linked dataset. */ @@ -465,6 +705,28 @@ export namespace analyticshub_v1 { */ subscriptions?: Schema$Subscription[]; } + /** + * Sets the `data` field as the HTTP body for delivery. + */ + export interface Schema$NoWrapper { + /** + * Optional. When true, writes the Pub/Sub message metadata to `x-goog-pubsub-:` headers of the HTTP request. Writes the Pub/Sub message attributes to `:` headers of the HTTP request. + */ + writeMetadata?: boolean | null; + } + /** + * Contains information needed for generating an [OpenID Connect token](https://developers.google.com/identity/protocols/OpenIDConnect). + */ + export interface Schema$OidcToken { + /** + * Optional. Audience to be used when generating OIDC token. The audience claim identifies the recipients that the JWT is intended for. The audience value is a single case-sensitive string. Having multiple values (array) for the audience field is not supported. More info about the OIDC JWT token audience here: https://tools.ietf.org/html/rfc7519#section-4.1.3 Note: if not specified, the Push endpoint URL will be used. + */ + audience?: string | null; + /** + * Optional. [Service account email](https://cloud.google.com/iam/docs/service-accounts) used for generating the OIDC token. For more information on setting up authentication, see [Push subscriptions](https://cloud.google.com/pubsub/docs/push). + */ + serviceAccountEmail?: string | null; + } /** * This resource represents a long-running operation that is the result of a network API call. */ @@ -557,6 +819,48 @@ export namespace analyticshub_v1 { */ primaryContact?: string | null; } + /** + * Pub/Sub topic source. + */ + export interface Schema$PubSubTopicSource { + /** + * Optional. Region hint on where the data might be published. Data affinity regions are modifiable. See go/regions for full listing of possible Cloud regions. + */ + dataAffinityRegions?: string[] | null; + /** + * Required. Resource name of the Pub/Sub topic source for this listing. e.g. projects/myproject/topics/topicId + */ + topic?: string | null; + } + /** + * The payload to the push endpoint is in the form of the JSON representation of a PubsubMessage (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#pubsubmessage). + */ + export interface Schema$PubsubWrapper {} + /** + * Configuration for a push delivery endpoint. + */ + export interface Schema$PushConfig { + /** + * Optional. Endpoint configuration attributes that can be used to control different aspects of the message delivery. The only currently supported attribute is `x-goog-version`, which you can use to change the format of the pushed message. This attribute indicates the version of the data expected by the endpoint. This controls the shape of the pushed message (i.e., its fields and metadata). If not present during the `CreateSubscription` call, it will default to the version of the Pub/Sub API used to make such call. If not present in a `ModifyPushConfig` call, its value will not be changed. `GetSubscription` calls will always return a valid version, even if the subscription was created without this attribute. The only supported values for the `x-goog-version` attribute are: * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API. * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API. For example: `attributes { "x-goog-version": "v1" \}` + */ + attributes?: {[key: string]: string} | null; + /** + * Optional. When set, the payload to the push endpoint is not wrapped. + */ + noWrapper?: Schema$NoWrapper; + /** + * Optional. If specified, Pub/Sub will generate and attach an OIDC JWT token as an `Authorization` header in the HTTP request for every pushed message. + */ + oidcToken?: Schema$OidcToken; + /** + * Optional. When set, the payload to the push endpoint is in the form of the JSON representation of a PubsubMessage (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#pubsubmessage). + */ + pubsubWrapper?: Schema$PubsubWrapper; + /** + * Optional. A URL locating the endpoint to which messages should be pushed. For example, a Webhook endpoint might use `https://example.com/push`. + */ + pushEndpoint?: string | null; + } /** * Message for refreshing a subscription. */ @@ -604,6 +908,19 @@ export namespace analyticshub_v1 { */ restrictQueryResult?: boolean | null; } + /** + * A policy that specifies how Pub/Sub retries message delivery. Retry delay will be exponential based on provided minimum and maximum backoffs. https://en.wikipedia.org/wiki/Exponential_backoff. RetryPolicy will be triggered on NACKs or acknowledgement deadline exceeded events for a given message. Retry Policy is implemented on a best effort basis. At times, the delay between consecutive deliveries may not match the configuration. That is, delay can be more or less than configured backoff. + */ + export interface Schema$RetryPolicy { + /** + * Optional. The maximum delay between consecutive deliveries of a given message. Value should be between 0 and 600 seconds. Defaults to 600 seconds. + */ + maximumBackoff?: string | null; + /** + * Optional. The minimum delay between consecutive deliveries of a given message. Value should be between 0 and 600 seconds. Defaults to 10 seconds. + */ + minimumBackoff?: string | null; + } /** * Message for revoking a subscription. */ @@ -613,7 +930,7 @@ export namespace analyticshub_v1 { */ export interface Schema$RevokeSubscriptionResponse {} /** - * Resource in this dataset that are selectively shared. + * Resource in this dataset that is selectively shared. */ export interface Schema$SelectedResource { /** @@ -698,6 +1015,10 @@ export namespace analyticshub_v1 { * Input only. BigQuery destination dataset to create for the subscriber. */ destinationDataset?: Schema$DestinationDataset; + /** + * Required. Input only. Destination Pub/Sub subscription to create for the subscriber. + */ + destinationPubsubSubscription?: Schema$DestinationPubSubSubscription; } /** * Message for response when you subscribe to a listing. @@ -728,6 +1049,10 @@ export namespace analyticshub_v1 { * Output only. Map of listing resource names to associated linked resource, e.g. projects/123/locations/US/dataExchanges/456/listings/789 -\> projects/123/datasets/my_dataset For listing-level subscriptions, this is a map of size 1. Only contains values if state == STATE_ACTIVE. */ linkedDatasetMap?: {[key: string]: Schema$LinkedResource} | null; + /** + * Output only. Linked resources created in the subscription. Only contains values if state = STATE_ACTIVE. + */ + linkedResources?: Schema$LinkedResource[]; /** * Output only. Resource name of the source Listing. e.g. projects/123/locations/US/dataExchanges/456/listings/789 */ @@ -744,6 +1069,10 @@ export namespace analyticshub_v1 { * Output only. Organization of the project this subscription belongs to. */ organizationId?: string | null; + /** + * Output only. Listing shared asset type. + */ + resourceType?: string | null; /** * Output only. Current state of the subscription. */ @@ -771,6 +1100,10 @@ export namespace analyticshub_v1 { */ permissions?: string[] | null; } + /** + * Configuration for writing message data in text format. Message payloads will be written to files as raw text, separated by a newline. + */ + export interface Schema$TextConfig {} export class Resource$Organizations { context: APIRequestContext; diff --git a/src/apis/analyticshub/v1beta1.ts b/src/apis/analyticshub/v1beta1.ts index 635bfe47bb..fe1377bec4 100644 --- a/src/apis/analyticshub/v1beta1.ts +++ b/src/apis/analyticshub/v1beta1.ts @@ -313,6 +313,14 @@ export namespace analyticshub_v1beta1 { * Output only. Name of the linked dataset, e.g. projects/subscriberproject/datasets/linked_dataset */ linkedDataset?: string | null; + /** + * Output only. Name of the Pub/Sub subscription, e.g. projects/subscriberproject/subscriptions/subscriptions/sub_id + */ + linkedPubsubSubscription?: string | null; + /** + * Output only. Listing for which linked resource is created. + */ + listing?: string | null; } /** * Message for response to the list of data exchanges. @@ -376,7 +384,7 @@ export namespace analyticshub_v1beta1 { */ requestAccess?: string | null; /** - * Optional. If set, restricted export configuration will be propagated and enforced on the linked dataset. + * Optional. If set, restricted export configuration will be propagated and enforced on the linked dataset. This is a required field for data clean room exchanges. */ restrictedExportConfig?: Schema$RestrictedExportConfig; /** @@ -558,6 +566,10 @@ export namespace analyticshub_v1beta1 { * Output only. Map of listing resource names to associated linked resource, e.g. projects/123/locations/US/dataExchanges/456/listings/789 -\> projects/123/datasets/my_dataset For listing-level subscriptions, this is a map of size 1. Only contains values if state == STATE_ACTIVE. */ linkedDatasetMap?: {[key: string]: Schema$LinkedResource} | null; + /** + * Output only. Linked resources created in the subscription. Only contains values if state = STATE_ACTIVE. + */ + linkedResources?: Schema$LinkedResource[]; /** * Output only. Resource name of the source Listing. e.g. projects/123/locations/US/dataExchanges/456/listings/789 */ @@ -574,6 +586,10 @@ export namespace analyticshub_v1beta1 { * Output only. Organization of the project this subscription belongs to. */ organizationId?: string | null; + /** + * Output only. Listing shared asset type. + */ + resourceType?: string | null; /** * Output only. Current state of the subscription. */ diff --git a/src/apis/assuredworkloads/v1beta1.ts b/src/apis/assuredworkloads/v1beta1.ts index 44eefd6130..ca0ee7690d 100644 --- a/src/apis/assuredworkloads/v1beta1.ts +++ b/src/apis/assuredworkloads/v1beta1.ts @@ -200,10 +200,6 @@ export namespace assuredworkloads_v1beta1 { */ resourceSettings?: Schema$GoogleCloudAssuredworkloadsV1beta1WorkloadResourceSettings[]; } - /** - * Response for EnableComplianceUpdates endpoint. - */ - export interface Schema$GoogleCloudAssuredworkloadsV1beta1EnableComplianceUpdatesResponse {} /** * Response for EnableResourceMonitoring endpoint. */ @@ -472,10 +468,6 @@ export namespace assuredworkloads_v1beta1 { * Output only. Count of active Violations in the Workload. */ complianceStatus?: Schema$GoogleCloudAssuredworkloadsV1beta1WorkloadComplianceStatus; - /** - * Output only. Indicates whether the compliance updates feature is enabled for a workload. The compliance updates feature can be enabled via the EnableComplianceUpdates endpoint. - */ - complianceUpdatesEnabled?: boolean | null; /** * Output only. Urls for services which are compliant for this Assured Workload, but which are currently disallowed by the ResourceUsageRestriction org policy. Invoke RestrictAllowedResources endpoint to allow your project developers to use these services in their environment. */ @@ -1310,105 +1302,6 @@ export namespace assuredworkloads_v1beta1 { } } - /** - * This endpoint enables Assured Workloads service to offer compliance updates for the folder based assured workload. It sets up an Assured Workloads Service Agent, having permissions to read compliance controls (for example: Org Policies) applied on the workload. The caller must have `resourcemanager.folders.getIamPolicy` and `resourcemanager.folders.setIamPolicy` permissions on the assured workload folder. - * - * @param params - Parameters for request - * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. - * @param callback - Optional callback that handles the response. - * @returns A promise if used with async/await, or void if used with a callback. - */ - enableComplianceUpdates( - params: Params$Resource$Organizations$Locations$Workloads$Enablecomplianceupdates, - options: StreamMethodOptions - ): GaxiosPromise; - enableComplianceUpdates( - params?: Params$Resource$Organizations$Locations$Workloads$Enablecomplianceupdates, - options?: MethodOptions - ): GaxiosPromise; - enableComplianceUpdates( - params: Params$Resource$Organizations$Locations$Workloads$Enablecomplianceupdates, - options: StreamMethodOptions | BodyResponseCallback, - callback: BodyResponseCallback - ): void; - enableComplianceUpdates( - params: Params$Resource$Organizations$Locations$Workloads$Enablecomplianceupdates, - options: - | MethodOptions - | BodyResponseCallback, - callback: BodyResponseCallback - ): void; - enableComplianceUpdates( - params: Params$Resource$Organizations$Locations$Workloads$Enablecomplianceupdates, - callback: BodyResponseCallback - ): void; - enableComplianceUpdates( - callback: BodyResponseCallback - ): void; - enableComplianceUpdates( - paramsOrCallback?: - | Params$Resource$Organizations$Locations$Workloads$Enablecomplianceupdates - | BodyResponseCallback - | BodyResponseCallback, - optionsOrCallback?: - | MethodOptions - | StreamMethodOptions - | BodyResponseCallback - | BodyResponseCallback, - callback?: - | BodyResponseCallback - | BodyResponseCallback - ): - | void - | GaxiosPromise - | GaxiosPromise { - let params = (paramsOrCallback || - {}) as Params$Resource$Organizations$Locations$Workloads$Enablecomplianceupdates; - let options = (optionsOrCallback || {}) as MethodOptions; - - if (typeof paramsOrCallback === 'function') { - callback = paramsOrCallback; - params = - {} as Params$Resource$Organizations$Locations$Workloads$Enablecomplianceupdates; - options = {}; - } - - if (typeof optionsOrCallback === 'function') { - callback = optionsOrCallback; - options = {}; - } - - const rootUrl = - options.rootUrl || 'https://assuredworkloads.googleapis.com/'; - const parameters = { - options: Object.assign( - { - url: (rootUrl + '/v1beta1/{+name}:enableComplianceUpdates').replace( - /([^:]\/)\/+/g, - '$1' - ), - method: 'PUT', - apiVersion: '', - }, - options - ), - params, - requiredParams: ['name'], - pathParams: ['name'], - context: this.context, - }; - if (callback) { - createAPIRequest( - parameters, - callback as BodyResponseCallback - ); - } else { - return createAPIRequest( - parameters - ); - } - } - /** * Enable resource violation monitoring for a workload. * @@ -1944,13 +1837,6 @@ export namespace assuredworkloads_v1beta1 { */ name?: string; } - export interface Params$Resource$Organizations$Locations$Workloads$Enablecomplianceupdates - extends StandardParameters { - /** - * Required. The `name` field is used to identify the workload. Format: organizations/{org_id\}/locations/{location_id\}/workloads/{workload_id\} - */ - name?: string; - } export interface Params$Resource$Organizations$Locations$Workloads$Enableresourcemonitoring extends StandardParameters { /** diff --git a/src/apis/beyondcorp/v1alpha.ts b/src/apis/beyondcorp/v1alpha.ts index eb2dcde90d..2ce1b15eea 100644 --- a/src/apis/beyondcorp/v1alpha.ts +++ b/src/apis/beyondcorp/v1alpha.ts @@ -1262,6 +1262,10 @@ export namespace beyondcorp_v1alpha { * Output only. ProxyConfig resource name. */ name?: string | null; + /** + * Optional. Protocol config data for the Proxy. + */ + proxyProtocolConfig?: Schema$GoogleCloudBeyondcorpPartnerservicesV1alphaProxyProtocolConfig; /** * Required. The URI of the proxy server. */ @@ -1279,6 +1283,15 @@ export namespace beyondcorp_v1alpha { */ updateTime?: string | null; } + /** + * The protocol data that specifies how to communicate with Partner's Proxy. + */ + export interface Schema$GoogleCloudBeyondcorpPartnerservicesV1alphaProxyProtocolConfig { + /** + * Optional. Untyped property bag to be sent back to the proxy using client specific mechanism. + */ + metadata?: {[key: string]: string} | null; + } /** * Message contains the routing information to direct traffic to the proxy server. */ @@ -1579,7 +1592,7 @@ export namespace beyondcorp_v1alpha { */ endTime?: string | null; /** - * Required. Unique resource name of the Subscription. The name is ignored when creating a subscription. + * Identifier. Unique resource name of the Subscription. The name is ignored when creating a subscription. */ name?: string | null; /** @@ -6212,7 +6225,7 @@ export namespace beyondcorp_v1alpha { export interface Params$Resource$Organizations$Locations$Subscriptions$Patch extends StandardParameters { /** - * Required. Unique resource name of the Subscription. The name is ignored when creating a subscription. + * Identifier. Unique resource name of the Subscription. The name is ignored when creating a subscription. */ name?: string; /** diff --git a/src/apis/chat/v1.ts b/src/apis/chat/v1.ts index d9f406f8a8..7f6100df47 100644 --- a/src/apis/chat/v1.ts +++ b/src/apis/chat/v1.ts @@ -137,6 +137,19 @@ export namespace chat_v1 { */ buttonList?: Schema$GoogleAppsCardV1ButtonList; } + /** + * Represents the [access setting](https://support.google.com/chat/answer/11971020) of the space. + */ + export interface Schema$AccessSettings { + /** + * Output only. Indicates the access state of the space. + */ + accessState?: string | null; + /** + * Optional. The resource name of the [target audience](https://support.google.com/a/answer/9934697) who can discover the space, join the space, and preview the messages in the space. For details, see [Make a space discoverable to a target audience](https://developers.google.com/workspace/chat/space-target-audience). Format: `audiences/{audience\}` To use the default target audience for the Google Workspace organization, set to `audiences/default`. + */ + audience?: string | null; + } /** * List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze one day, snooze next week. You might use `action method = snooze()`, passing the snooze type and snooze time in the list of string parameters. */ @@ -809,7 +822,7 @@ export namespace chat_v1 { title?: string | null; } /** - * A column. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend): Columns for Google Workspace Add-ons are in Developer Preview. + * A column. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend) */ export interface Schema$GoogleAppsCardV1Column { /** @@ -1344,7 +1357,7 @@ export namespace chat_v1 { textParagraph?: Schema$GoogleAppsCardV1TextParagraph; } /** - * The supported widgets that you can include in a column. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend): Columns for Google Workspace Add-ons are in Developer Preview. + * The supported widgets that you can include in a column. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend) */ export interface Schema$GoogleAppsCardV1Widgets { /** @@ -1586,7 +1599,7 @@ export namespace chat_v1 { */ deleteTime?: string | null; /** - * The Google Group the membership corresponds to. Only supports read operations. Other operations, like creating or updating a membership, aren't currently supported. + * The Google Group the membership corresponds to. */ groupMember?: Schema$Group; /** @@ -1955,7 +1968,7 @@ export namespace chat_v1 { */ export interface Schema$SetUpSpaceRequest { /** - * Optional. The Google Chat users to invite to join the space. Omit the calling user, as they are added automatically. The set currently allows up to 20 memberships (in addition to the caller). For human membership, the `Membership.member` field must contain a `user` with `name` populated (format: `users/{user\}`) and `type` set to `User.Type.HUMAN`. You can only add human users when setting up a space (adding Chat apps is only supported for direct message setup with the calling app). You can also add members using the user's email as an alias for {user\}. For example, the `user.name` can be `users/example@gmail.com`. To invite Gmail users or users from external Google Workspace domains, user's email must be used for `{user\}`. Optional when setting `Space.spaceType` to `SPACE`. Required when setting `Space.spaceType` to `GROUP_CHAT`, along with at least two memberships. Required when setting `Space.spaceType` to `DIRECT_MESSAGE` with a human user, along with exactly one membership. Must be empty when creating a 1:1 conversation between a human and the calling Chat app (when setting `Space.spaceType` to `DIRECT_MESSAGE` and `Space.singleUserBotDm` to `true`). + * Optional. The Google Chat users or groups to invite to join the space. Omit the calling user, as they are added automatically. The set currently allows up to 20 memberships (in addition to the caller). For human membership, the `Membership.member` field must contain a `user` with `name` populated (format: `users/{user\}`) and `type` set to `User.Type.HUMAN`. You can only add human users when setting up a space (adding Chat apps is only supported for direct message setup with the calling app). You can also add members using the user's email as an alias for {user\}. For example, the `user.name` can be `users/example@gmail.com`. To invite Gmail users or users from external Google Workspace domains, user's email must be used for `{user\}`. For Google group membership, the `Membership.group_member` field must contain a `group` with `name` populated (format `groups/{group\}`). You can only add Google groups when setting `Space.spaceType` to `SPACE`. Optional when setting `Space.spaceType` to `SPACE`. Required when setting `Space.spaceType` to `GROUP_CHAT`, along with at least two memberships. Required when setting `Space.spaceType` to `DIRECT_MESSAGE` with a human user, along with exactly one membership. Must be empty when creating a 1:1 conversation between a human and the calling Chat app (when setting `Space.spaceType` to `DIRECT_MESSAGE` and `Space.singleUserBotDm` to `true`). */ memberships?: Schema$Membership[]; /** @@ -2005,6 +2018,10 @@ export namespace chat_v1 { * A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. */ export interface Schema$Space { + /** + * Optional. Specifies the [access setting](https://support.google.com/chat/answer/11971020) of the space. Only populated when the `space_type` is `SPACE`. + */ + accessSettings?: Schema$AccessSettings; /** * Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging. */ @@ -2049,6 +2066,10 @@ export namespace chat_v1 { * The type of space. Required when creating a space or updating the space type of a space. Output only for other usage. */ spaceType?: string | null; + /** + * Output only. The URI for a user to access the space. + */ + spaceUri?: string | null; /** * Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages are threaded in this space. */ @@ -3232,7 +3253,7 @@ export namespace chat_v1 { } /** - * Creates a space and adds specified users to it. The calling user is automatically added to the space, and shouldn't be specified as a membership in the request. For an example, see [Set up a space with initial members](https://developers.google.com/workspace/chat/set-up-spaces). To specify the human members to add, add memberships with the appropriate `membership.member.name`. To add a human user, use `users/{user\}`, where `{user\}` can be the email address for the user. For users in the same Workspace organization `{user\}` can also be the `id` for the person from the People API, or the `id` for the user in the Directory API. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can add the user to the space by setting the `membership.member.name` to `users/user@example.com` or `users/123456789`. For a named space or group chat, if the caller blocks, or is blocked by some members, or doesn't have permission to add some members, then those members aren't added to the created space. To create a direct message (DM) between the calling user and another human user, specify exactly one membership to represent the human user. If one user blocks the other, the request fails and the DM isn't created. To create a DM between the calling user and the calling app, set `Space.singleUserBotDm` to `true` and don't specify any memberships. You can only use this method to set up a DM with the calling app. To add the calling app as a member of a space or an existing DM between two human users, see [Invite or add a user or app to a space](https://developers.google.com/workspace/chat/create-members). If a DM already exists between two users, even when one user blocks the other at the time a request is made, then the existing DM is returned. Spaces with threaded replies aren't supported. If you receive the error message `ALREADY_EXISTS` when setting up a space, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). + * Creates a space and adds specified users to it. The calling user is automatically added to the space, and shouldn't be specified as a membership in the request. For an example, see [Set up a space with initial members](https://developers.google.com/workspace/chat/set-up-spaces). To specify the human members to add, add memberships with the appropriate `membership.member.name`. To add a human user, use `users/{user\}`, where `{user\}` can be the email address for the user. For users in the same Workspace organization `{user\}` can also be the `id` for the person from the People API, or the `id` for the user in the Directory API. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can add the user to the space by setting the `membership.member.name` to `users/user@example.com` or `users/123456789`. To specify the Google groups to add, add memberships with the appropriate `membership.group_member.name`. To add or invite a Google group, use `groups/{group\}`, where `{group\}` is the `id` for the group from the Cloud Identity Groups API. For example, you can use [Cloud Identity Groups lookup API](https://cloud.google.com/identity/docs/reference/rest/v1/groups/lookup) to retrieve the ID `123456789` for group email `group@example.com`, then you can add the group to the space by setting the `membership.group_member.name` to `groups/123456789`. Group email is not supported, and Google groups can only be added as members in named spaces. For a named space or group chat, if the caller blocks, or is blocked by some members, or doesn't have permission to add some members, then those members aren't added to the created space. To create a direct message (DM) between the calling user and another human user, specify exactly one membership to represent the human user. If one user blocks the other, the request fails and the DM isn't created. To create a DM between the calling user and the calling app, set `Space.singleUserBotDm` to `true` and don't specify any memberships. You can only use this method to set up a DM with the calling app. To add the calling app as a member of a space or an existing DM between two human users, see [Invite or add a user or app to a space](https://developers.google.com/workspace/chat/create-members). If a DM already exists between two users, even when one user blocks the other at the time a request is made, then the existing DM is returned. Spaces with threaded replies aren't supported. If you receive the error message `ALREADY_EXISTS` when setting up a space, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). * * @param params - Parameters for request * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. @@ -3378,7 +3399,7 @@ export namespace chat_v1 { */ name?: string; /** - * Required. The updated field paths, comma separated if there are multiple. Currently supported field paths: - `display_name` (Only supports changing the display name of a space with the `SPACE` type, or when also including the `space_type` mask to change a `GROUP_CHAT` space type to `SPACE`. Trying to update the display name of a `GROUP_CHAT` or a `DIRECT_MESSAGE` space results in an invalid argument error. If you receive the error message `ALREADY_EXISTS` when updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name.) - `space_type` (Only supports changing a `GROUP_CHAT` space type to `SPACE`. Include `display_name` together with `space_type` in the update mask and ensure that the specified space has a non-empty display name and the `SPACE` space type. Including the `space_type` mask and the `SPACE` type in the specified space when updating the display name is optional if the existing space already has the `SPACE` type. Trying to update the space type in other ways results in an invalid argument error). `space_type` is not supported with admin access. - `space_details` - `space_history_state` (Supports [turning history on or off for the space](https://support.google.com/chat/answer/7664687) if [the organization allows users to change their history setting](https://support.google.com/a/answer/7664184). Warning: mutually exclusive with all other field paths.) `space_history_state` is not supported with admin access. - Developer Preview: `access_settings.audience` (Supports changing the [access setting](https://support.google.com/chat/answer/11971020) of a space. If no audience is specified in the access setting, the space's access setting is updated to restricted. Warning: mutually exclusive with all other field paths.) `access_settings.audience` is not supported with admin access. - Developer Preview: Supports changing the [permission settings](https://support.google.com/chat/answer/13340792) of a space, supported field paths include: `permission_settings.manage_members_and_groups`, `permission_settings.modify_space_details`, `permission_settings.toggle_history`, `permission_settings.use_at_mention_all`, `permission_settings.manage_apps`, `permission_settings.manage_webhooks`, `permission_settings.reply_messages` (Warning: mutually exclusive with all other non-permission settings field paths). `permission_settings` is not supported with admin access. + * Required. The updated field paths, comma separated if there are multiple. Currently supported field paths: - `display_name` (Only supports changing the display name of a space with the `SPACE` type, or when also including the `space_type` mask to change a `GROUP_CHAT` space type to `SPACE`. Trying to update the display name of a `GROUP_CHAT` or a `DIRECT_MESSAGE` space results in an invalid argument error. If you receive the error message `ALREADY_EXISTS` when updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name.) - `space_type` (Only supports changing a `GROUP_CHAT` space type to `SPACE`. Include `display_name` together with `space_type` in the update mask and ensure that the specified space has a non-empty display name and the `SPACE` space type. Including the `space_type` mask and the `SPACE` type in the specified space when updating the display name is optional if the existing space already has the `SPACE` type. Trying to update the space type in other ways results in an invalid argument error). `space_type` is not supported with admin access. - `space_details` - `space_history_state` (Supports [turning history on or off for the space](https://support.google.com/chat/answer/7664687) if [the organization allows users to change their history setting](https://support.google.com/a/answer/7664184). Warning: mutually exclusive with all other field paths.) `space_history_state` is not supported with admin access. - `access_settings.audience` (Supports changing the [access setting](https://support.google.com/chat/answer/11971020) of who can discover the space, join the space, and preview the messages in space. If no audience is specified in the access setting, the space's access setting is updated to private. Warning: mutually exclusive with all other field paths.) `access_settings.audience` is not supported with admin access. - Developer Preview: Supports changing the [permission settings](https://support.google.com/chat/answer/13340792) of a space, supported field paths include: `permission_settings.manage_members_and_groups`, `permission_settings.modify_space_details`, `permission_settings.toggle_history`, `permission_settings.use_at_mention_all`, `permission_settings.manage_apps`, `permission_settings.manage_webhooks`, `permission_settings.reply_messages` (Warning: mutually exclusive with all other non-permission settings field paths). `permission_settings` is not supported with admin access. */ updateMask?: string; @@ -3401,7 +3422,7 @@ export namespace chat_v1 { } /** - * Creates a human membership or app membership for the calling app. Creating memberships for other apps isn't supported. For an example, see [Invite or add a user or a Google Chat app to a space](https://developers.google.com/workspace/chat/create-members). When creating a membership, if the specified member has their auto-accept policy turned off, then they're invited, and must accept the space invitation before joining. Otherwise, creating a membership adds the member directly to the specified space. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). To specify the member to add, set the `membership.member.name` for the human or app member. - To add the calling app to a space or a direct message between two human users, use `users/app`. Unable to add other apps to the space. - To add a human user, use `users/{user\}`, where `{user\}` can be the email address for the user. For users in the same Workspace organization `{user\}` can also be the `id` for the person from the People API, or the `id` for the user in the Directory API. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can add the user to the space by setting the `membership.member.name` to `users/user@example.com` or `users/123456789`. + * Creates a human membership or app membership for the calling app. Creating memberships for other apps isn't supported. For an example, see [Invite or add a user or a Google Chat app to a space](https://developers.google.com/workspace/chat/create-members). When creating a membership, if the specified member has their auto-accept policy turned off, then they're invited, and must accept the space invitation before joining. Otherwise, creating a membership adds the member directly to the specified space. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). To specify the member to add, set the `membership.member.name` for the human or app member, or set the `membership.group_member.name` for the group member. - To add the calling app to a space or a direct message between two human users, use `users/app`. Unable to add other apps to the space. - To add a human user, use `users/{user\}`, where `{user\}` can be the email address for the user. For users in the same Workspace organization `{user\}` can also be the `id` for the person from the People API, or the `id` for the user in the Directory API. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can add the user to the space by setting the `membership.member.name` to `users/user@example.com` or `users/123456789`. - To add or invite a Google group in a named space, use `groups/{group\}`, where `{group\}` is the `id` for the group from the Cloud Identity Groups API. For example, you can use [Cloud Identity Groups lookup API](https://cloud.google.com/identity/docs/reference/rest/v1/groups/lookup) to retrieve the ID `123456789` for group email `group@example.com`, then you can add or invite the group to a named space by setting the `membership.group_member.name` to `groups/123456789`. Group email is not supported, and Google groups can only be added as members in named spaces. * * @param params - Parameters for request * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. diff --git a/src/apis/compute/alpha.ts b/src/apis/compute/alpha.ts index d6d1de6e14..5524f4e740 100644 --- a/src/apis/compute/alpha.ts +++ b/src/apis/compute/alpha.ts @@ -183,6 +183,7 @@ export namespace compute_alpha { regionInstances: Resource$Regioninstances; regionInstanceTemplates: Resource$Regioninstancetemplates; regionInstantSnapshots: Resource$Regioninstantsnapshots; + regionMultiMigs: Resource$Regionmultimigs; regionNetworkEndpointGroups: Resource$Regionnetworkendpointgroups; regionNetworkFirewallPolicies: Resource$Regionnetworkfirewallpolicies; regionNotificationEndpoints: Resource$Regionnotificationendpoints; @@ -333,6 +334,7 @@ export namespace compute_alpha { this.regionInstantSnapshots = new Resource$Regioninstantsnapshots( this.context ); + this.regionMultiMigs = new Resource$Regionmultimigs(this.context); this.regionNetworkEndpointGroups = new Resource$Regionnetworkendpointgroups(this.context); this.regionNetworkFirewallPolicies = @@ -842,6 +844,12 @@ export namespace compute_alpha { */ acceleratorType?: string | null; } + export interface Schema$AllocationReservationSharingPolicy { + /** + * Sharing config for all Google Cloud services. + */ + serviceShareType?: string | null; + } /** * [Output Only] Contains output only fields. */ @@ -7123,6 +7131,10 @@ export namespace compute_alpha { * The configuration for metadata based readiness signal sent by the instance during initialization when stopping / suspending an instance. The Instance Group Manager will wait for a signal that indicates successful initialization before stopping / suspending an instance. If a successful readiness signal is not sent before timeout, the corresponding instance will not be stopped / suspended. Instead, an error will be visible in the lastAttempt.errors field of the managed instance in the listmanagedinstances method. If metadataBasedReadinessSignal.timeoutSec is unset, the Instance Group Manager will directly proceed to suspend / stop instances, skipping initialization on them. */ metadataBasedReadinessSignal?: Schema$InstanceGroupManagerInstanceLifecyclePolicyMetadataBasedReadinessSignal; + /** + * The action that a MIG performs on an unhealthy VM. A VM is marked as unhealthy when the application running on that VM fails a health check. Valid values are: - DEFAULT_ACTION (default): The MIG performs the same action as specified in the instanceLifecyclePolicy.defaultActionOnFailure field. If the defaultActionOnFailure field is set to REPAIR, then the MIG repairs unhealthy VMs. If the defaultActionOnFailure field is set to DO_NOTHING, then the MIG doesn't repair unhealthy VMs. - REPAIR: The MIG repairs unhealthy VMs by recreating it. - DO_NOTHING: The MIG doesn't repair unhealthy VMs. For more information, see About repairing VMs in a MIG. + */ + onFailedHealthCheck?: string | null; } export interface Schema$InstanceGroupManagerInstanceLifecyclePolicyMetadataBasedReadinessSignal { /** @@ -7863,7 +7875,7 @@ export namespace compute_alpha { */ labels?: {[key: string]: string} | null; /** - * The machine type to use for instances that are created from these properties. This field only accept machine types name. e.g. n2-standard-4 and does not accept machine type full or partial url. e.g. projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4 will throw INTERNAL_ERROR. + * The machine type to use for instances that are created from these properties. This field only accepts a machine type name, for example `n2-standard-4`. If you use the machine type full or partial URL, for example `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`, the request will result in an `INTERNAL_ERROR`. */ machineType?: string | null; /** @@ -8630,7 +8642,7 @@ export namespace compute_alpha { strictPriorityPolicy?: Schema$InterconnectApplicationAwareInterconnectStrictPriorityPolicy; } /** - * Specify bandwidth percentages (0-100) for various traffic classes in BandwidthPercentagePolicy. The sum of all percentages must equal 100. It is valid to specify percentages for some classes and not for others. The others will be implicitly marked as 0. + * Specify bandwidth percentages [1-100] for various traffic classes in BandwidthPercentagePolicy. The sum of all percentages must equal 100. All traffic classes must have a percentage value specified. */ export interface Schema$InterconnectApplicationAwareInterconnectBandwidthPercentage { /** @@ -10388,6 +10400,118 @@ export namespace compute_alpha { */ units?: string | null; } + /** + * MultiMIG represents a group of Managed Instance Groups. + */ + export interface Schema$MultiMig { + /** + * [Output Only] Creation timestamp in RFC3339 text format. + */ + creationTimestamp?: string | null; + /** + * An optional description of this resource. Provide this property when you create the resource. + */ + description?: string | null; + /** + * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + */ + id?: string | null; + /** + * [Output Only] Type of the resource. Always compute#multiMig for MultiMIGs. + */ + kind?: string | null; + locationPolicy?: Schema$MultiMigLocationPolicy; + /** + * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + */ + name?: string | null; + /** + * User-provided names for Parts of MultiMIG and the Parts themselves. + */ + parts?: {[key: string]: Schema$MultiMigPart} | null; + /** + * [Output Only] URL of the region where the resource resides. Only applicable for regional resources. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + */ + region?: string | null; + /** + * Policy for handling provisioning and other scheduling-related events. + */ + schedulingPolicy?: Schema$MultiMigSchedulingPolicy; + /** + * [Output only] Server-defined URL for the resource. + */ + selfLink?: string | null; + /** + * [Output Only] Server-defined URL for this resource with the resource id. + */ + selfLinkWithId?: string | null; + } + /** + * Policy regarding where to create MIGs Initially only zonal MIGs in the same zone are supported. + */ + export interface Schema$MultiMigLocationPolicy { + /** + * List of zones where MIGs will be provisioned. Should be valid RFC1035 name + */ + provisioningZones?: string[] | null; + } + /** + * Config for an MMIG part. + */ + export interface Schema$MultiMigPart { + /** + * Link to an existing InstanceGroupManager that will be adopted by a MultiMIG. + */ + instanceGroupManager?: string | null; + /** + * InstanceGroupManager to be created by the multiMig + */ + instanceGroupManagerProperties?: Schema$InstanceGroupManager; + } + /** + * Policy for handling provisioning and other scheduling-related events. + */ + export interface Schema$MultiMigSchedulingPolicy { + /** + * How provisioning of MIGs should be scheduled (coordinated or not) + */ + provisioning?: string | null; + } + export interface Schema$MultiMigsList { + etag?: string | null; + /** + * Unique identifier for the resource; defined by the server. + */ + id?: string | null; + /** + * A list of MultiMig resources. + */ + items?: Schema$MultiMig[]; + /** + * Type of resource. + */ + kind?: string | null; + /** + * This token allows you to get the next page of results for maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + */ + nextPageToken?: string | null; + /** + * [Output only] Server-defined URL for this resource. + */ + selfLink?: string | null; + /** + * [Output only] Unreachable resources. + */ + unreachables?: string[] | null; + /** + * Informational warning message. + */ + warning?: { + code?: string; + data?: Array<{key?: string; value?: string}>; + message?: string; + } | null; + } /** * [Deprecated] Configuration for the mutual Tls mode for peer authentication. Configuration for the mutual Tls mode for peer authentication. */ @@ -14692,6 +14816,10 @@ export namespace compute_alpha { * The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. */ name?: string | null; + /** + * Specify the reservation sharing policy. If unspecified, the reservation will not be shared with Google Cloud managed services. + */ + reservationSharingPolicy?: Schema$AllocationReservationSharingPolicy; /** * Resource policies to be added to this reservation. The key is defined by user, and the value is resource policy url. This is to define placement policy with reservation. */ @@ -15375,7 +15503,7 @@ export namespace compute_alpha { */ nextHopHub?: string | null; /** - * The URL to a forwarding rule of type loadBalancingScheme=INTERNAL that should handle matching packets or the IP address of the forwarding Rule. For example, the following are all valid URLs: - 10.128.0.56 - https://www.googleapis.com/compute/v1/projects/project/regions/region /forwardingRules/forwardingRule - regions/region/forwardingRules/forwardingRule + * The URL to a forwarding rule of type loadBalancingScheme=INTERNAL that should handle matching packets or the IP address of the forwarding Rule. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/project/regions/region /forwardingRules/forwardingRule - regions/region/forwardingRules/forwardingRule If an IP address is provided, must specify an IPv4 address in dot-decimal notation or an IPv6 address in RFC 4291 format. For example, the following are all valid IP addresses: - 10.128.0.56 - 2001:db8::2d9:51:0:0 - 2001:db8:0:0:2d9:51:0:0 IPv6 addresses will be displayed using RFC 5952 compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address. */ nextHopIlb?: string | null; /** @@ -15980,7 +16108,7 @@ export namespace compute_alpha { */ description?: string | null; /** - * CEL expression that specifies the match condition that egress traffic from a VM is evaluated against. If it evaluates to true, the corresponding `action` is enforced. The following examples are valid match expressions for public NAT: "inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, '2.2.0.0/16')" "destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'" The following example is a valid match expression for private NAT: "nexthop.hub == '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'" + * CEL expression that specifies the match condition that egress traffic from a VM is evaluated against. If it evaluates to true, the corresponding `action` is enforced. The following examples are valid match expressions for public NAT: `inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, '2.2.0.0/16')` `destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'` The following example is a valid match expression for private NAT: `nexthop.hub == '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'` */ match?: string | null; /** @@ -16164,11 +16292,11 @@ export namespace compute_alpha { } export interface Schema$RouterStatus { /** - * Best routes for this router's network. + * A list of the best dynamic routes for this Cloud Router's Virtual Private Cloud (VPC) network in the same region as this Cloud Router. Lists all of the best routes per prefix that are programmed into this region's VPC data plane. When global dynamic routing mode is turned on in the VPC network, this list can include cross-region dynamic routes from Cloud Routers in other regions. */ bestRoutes?: Schema$Route[]; /** - * Best routes learned by this router. + * A list of the best BGP routes learned by this Cloud Router. It is possible that routes listed might not be programmed into the data plane, if the Google Cloud control plane finds a more optimal route for a prefix than a route learned by this Cloud Router. */ bestRoutesForRouter?: Schema$Route[]; bgpPeerStatus?: Schema$RouterStatusBgpPeerStatus[]; @@ -18670,7 +18798,7 @@ export namespace compute_alpha { */ performanceProvisioningType?: string | null; /** - * Size, in GiB, of the storage pool. + * Size, in GiB, of the storage pool. For more information about the size limits, see https://cloud.google.com/compute/docs/disks/storage-pools. */ poolProvisionedCapacityGb?: string | null; /** @@ -18913,7 +19041,7 @@ export namespace compute_alpha { */ poolUsedCapacityBytes?: string | null; /** - * Sum of all the disks' provisioned IOPS, minus some amount that is allowed per disk that is not counted towards pool's IOPS capacity. + * [Output Only] Sum of all the disks' provisioned IOPS, minus some amount that is allowed per disk that is not counted towards pool's IOPS capacity. For more information, see https://cloud.google.com/compute/docs/disks/storage-pools. */ poolUsedIops?: string | null; /** @@ -89410,6 +89538,451 @@ export namespace compute_alpha { requestBody?: Schema$TestPermissionsRequest; } + export class Resource$Regionmultimigs { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * Deletes a regional multiMIG in the specified project. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + delete( + params: Params$Resource$Regionmultimigs$Delete, + options: StreamMethodOptions + ): GaxiosPromise; + delete( + params?: Params$Resource$Regionmultimigs$Delete, + options?: MethodOptions + ): GaxiosPromise; + delete( + params: Params$Resource$Regionmultimigs$Delete, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Regionmultimigs$Delete, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Regionmultimigs$Delete, + callback: BodyResponseCallback + ): void; + delete(callback: BodyResponseCallback): void; + delete( + paramsOrCallback?: + | Params$Resource$Regionmultimigs$Delete + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): void | GaxiosPromise | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Regionmultimigs$Delete; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Regionmultimigs$Delete; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://compute.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/compute/alpha/projects/{project}/regions/{region}/multiMigs/{multiMig}' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'DELETE', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['project', 'region', 'multiMig'], + pathParams: ['multiMig', 'project', 'region'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Returns the specified MultiMIG resource. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + get( + params: Params$Resource$Regionmultimigs$Get, + options: StreamMethodOptions + ): GaxiosPromise; + get( + params?: Params$Resource$Regionmultimigs$Get, + options?: MethodOptions + ): GaxiosPromise; + get( + params: Params$Resource$Regionmultimigs$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Regionmultimigs$Get, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Regionmultimigs$Get, + callback: BodyResponseCallback + ): void; + get(callback: BodyResponseCallback): void; + get( + paramsOrCallback?: + | Params$Resource$Regionmultimigs$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): void | GaxiosPromise | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Regionmultimigs$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Regionmultimigs$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://compute.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/compute/alpha/projects/{project}/regions/{region}/multiMigs/{multiMig}' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['project', 'region', 'multiMig'], + pathParams: ['multiMig', 'project', 'region'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Creates a regional multiMIG in the specified project. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + insert( + params: Params$Resource$Regionmultimigs$Insert, + options: StreamMethodOptions + ): GaxiosPromise; + insert( + params?: Params$Resource$Regionmultimigs$Insert, + options?: MethodOptions + ): GaxiosPromise; + insert( + params: Params$Resource$Regionmultimigs$Insert, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + insert( + params: Params$Resource$Regionmultimigs$Insert, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + insert( + params: Params$Resource$Regionmultimigs$Insert, + callback: BodyResponseCallback + ): void; + insert(callback: BodyResponseCallback): void; + insert( + paramsOrCallback?: + | Params$Resource$Regionmultimigs$Insert + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): void | GaxiosPromise | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Regionmultimigs$Insert; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Regionmultimigs$Insert; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://compute.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/compute/alpha/projects/{project}/regions/{region}/multiMigs' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'POST', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['project', 'region'], + pathParams: ['project', 'region'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Retrieves a list of MultiMIGs in a project and region. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + list( + params: Params$Resource$Regionmultimigs$List, + options: StreamMethodOptions + ): GaxiosPromise; + list( + params?: Params$Resource$Regionmultimigs$List, + options?: MethodOptions + ): GaxiosPromise; + list( + params: Params$Resource$Regionmultimigs$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Regionmultimigs$List, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Regionmultimigs$List, + callback: BodyResponseCallback + ): void; + list(callback: BodyResponseCallback): void; + list( + paramsOrCallback?: + | Params$Resource$Regionmultimigs$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): void | GaxiosPromise | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Regionmultimigs$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Regionmultimigs$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://compute.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/compute/alpha/projects/{project}/regions/{region}/multiMigs' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['project', 'region'], + pathParams: ['project', 'region'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + } + + export interface Params$Resource$Regionmultimigs$Delete + extends StandardParameters { + /** + * Name of the multiMIG to delete. + */ + multiMig?: string; + /** + * Project ID for this request. + */ + project?: string; + /** + * Name of the region for this request. + */ + region?: string; + /** + * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + */ + requestId?: string; + } + export interface Params$Resource$Regionmultimigs$Get + extends StandardParameters { + /** + * Name of the MultiMig resource to return. + */ + multiMig?: string; + /** + * Project ID for this request. + */ + project?: string; + /** + * Name of the region for this request. + */ + region?: string; + } + export interface Params$Resource$Regionmultimigs$Insert + extends StandardParameters { + /** + * Project ID for this request. + */ + project?: string; + /** + * Name of the region for this request. + */ + region?: string; + /** + * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + */ + requestId?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$MultiMig; + } + export interface Params$Resource$Regionmultimigs$List + extends StandardParameters { + /** + * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\>`, `<`, `<=`, `\>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + */ + filter?: string; + /** + * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + */ + maxResults?: number; + /** + * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + */ + orderBy?: string; + /** + * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + */ + pageToken?: string; + /** + * Project ID for this request. + */ + project?: string; + /** + * Name of the region for this request. + */ + region?: string; + /** + * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + */ + returnPartialSuccess?: boolean; + } + export class Resource$Regionnetworkendpointgroups { context: APIRequestContext; constructor(context: APIRequestContext) { @@ -111904,7 +112477,7 @@ export namespace compute_alpha { } /** - * Updates the specified storagePool with the data included in the request. The update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: size_tb and provisioned_iops. + * Updates the specified storagePool with the data included in the request. The update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: pool_provisioned_capacity_gb, pool_provisioned_iops and pool_provisioned_throughput. * * @param params - Parameters for request * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. diff --git a/src/apis/compute/beta.ts b/src/apis/compute/beta.ts index f2dd0f8b37..3b6366009f 100644 --- a/src/apis/compute/beta.ts +++ b/src/apis/compute/beta.ts @@ -7249,7 +7249,7 @@ export namespace compute_beta { */ labels?: {[key: string]: string} | null; /** - * The machine type to use for instances that are created from these properties. This field only accept machine types name. e.g. n2-standard-4 and does not accept machine type full or partial url. e.g. projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4 will throw INTERNAL_ERROR. + * The machine type to use for instances that are created from these properties. This field only accepts a machine type name, for example `n2-standard-4`. If you use the machine type full or partial URL, for example `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`, the request will result in an `INTERNAL_ERROR`. */ machineType?: string | null; /** @@ -13512,7 +13512,7 @@ export namespace compute_beta { */ nextHopHub?: string | null; /** - * The URL to a forwarding rule of type loadBalancingScheme=INTERNAL that should handle matching packets or the IP address of the forwarding Rule. For example, the following are all valid URLs: - 10.128.0.56 - https://www.googleapis.com/compute/v1/projects/project/regions/region /forwardingRules/forwardingRule - regions/region/forwardingRules/forwardingRule + * The URL to a forwarding rule of type loadBalancingScheme=INTERNAL that should handle matching packets or the IP address of the forwarding Rule. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/project/regions/region /forwardingRules/forwardingRule - regions/region/forwardingRules/forwardingRule If an IP address is provided, must specify an IPv4 address in dot-decimal notation or an IPv6 address in RFC 4291 format. For example, the following are all valid IP addresses: - 10.128.0.56 - 2001:db8::2d9:51:0:0 - 2001:db8:0:0:2d9:51:0:0 IPv6 addresses will be displayed using RFC 5952 compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address. */ nextHopIlb?: string | null; /** @@ -14085,7 +14085,7 @@ export namespace compute_beta { */ description?: string | null; /** - * CEL expression that specifies the match condition that egress traffic from a VM is evaluated against. If it evaluates to true, the corresponding `action` is enforced. The following examples are valid match expressions for public NAT: "inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, '2.2.0.0/16')" "destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'" The following example is a valid match expression for private NAT: "nexthop.hub == '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'" + * CEL expression that specifies the match condition that egress traffic from a VM is evaluated against. If it evaluates to true, the corresponding `action` is enforced. The following examples are valid match expressions for public NAT: `inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, '2.2.0.0/16')` `destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'` The following example is a valid match expression for private NAT: `nexthop.hub == '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'` */ match?: string | null; /** @@ -14223,11 +14223,11 @@ export namespace compute_beta { } export interface Schema$RouterStatus { /** - * Best routes for this router's network. + * A list of the best dynamic routes for this Cloud Router's Virtual Private Cloud (VPC) network in the same region as this Cloud Router. Lists all of the best routes per prefix that are programmed into this region's VPC data plane. When global dynamic routing mode is turned on in the VPC network, this list can include cross-region dynamic routes from Cloud Routers in other regions. */ bestRoutes?: Schema$Route[]; /** - * Best routes learned by this router. + * A list of the best BGP routes learned by this Cloud Router. It is possible that routes listed might not be programmed into the data plane, if the Google Cloud control plane finds a more optimal route for a prefix than a route learned by this Cloud Router. */ bestRoutesForRouter?: Schema$Route[]; bgpPeerStatus?: Schema$RouterStatusBgpPeerStatus[]; @@ -16461,7 +16461,7 @@ export namespace compute_beta { */ performanceProvisioningType?: string | null; /** - * Size, in GiB, of the storage pool. + * Size, in GiB, of the storage pool. For more information about the size limits, see https://cloud.google.com/compute/docs/disks/storage-pools. */ poolProvisionedCapacityGb?: string | null; /** @@ -16676,7 +16676,7 @@ export namespace compute_beta { */ poolUsedCapacityBytes?: string | null; /** - * Sum of all the disks' provisioned IOPS, minus some amount that is allowed per disk that is not counted towards pool's IOPS capacity. + * [Output Only] Sum of all the disks' provisioned IOPS, minus some amount that is allowed per disk that is not counted towards pool's IOPS capacity. For more information, see https://cloud.google.com/compute/docs/disks/storage-pools. */ poolUsedIops?: string | null; /** @@ -103389,7 +103389,7 @@ export namespace compute_beta { } /** - * Updates the specified storagePool with the data included in the request. The update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: size_tb and provisioned_iops. + * Updates the specified storagePool with the data included in the request. The update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: pool_provisioned_capacity_gb, pool_provisioned_iops and pool_provisioned_throughput. * * @param params - Parameters for request * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. diff --git a/src/apis/compute/v1.ts b/src/apis/compute/v1.ts index fe27594360..a5f20c9eab 100644 --- a/src/apis/compute/v1.ts +++ b/src/apis/compute/v1.ts @@ -2694,6 +2694,36 @@ export namespace compute_v1 { */ source?: string | null; } + /** + * Specifies the custom error response policy that must be applied when the backend service or backend bucket responds with an error. + */ + export interface Schema$CustomErrorResponsePolicy { + /** + * Specifies rules for returning error responses. In a given policy, if you specify rules for both a range of error codes as well as rules for specific error codes then rules with specific error codes have a higher priority. For example, assume that you configure a rule for 401 (Un-authorized) code, and another for all 4 series error codes (4XX). If the backend service returns a 401, then the rule for 401 will be applied. However if the backend service returns a 403, the rule for 4xx takes effect. + */ + errorResponseRules?: Schema$CustomErrorResponsePolicyCustomErrorResponseRule[]; + /** + * The full or partial URL to the BackendBucket resource that contains the custom error content. Examples are: - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket - compute/v1/projects/project/global/backendBuckets/myBackendBucket - global/backendBuckets/myBackendBucket If errorService is not specified at lower levels like pathMatcher, pathRule and routeRule, an errorService specified at a higher level in the UrlMap will be used. If UrlMap.defaultCustomErrorResponsePolicy contains one or more errorResponseRules[], it must specify errorService. If load balancer cannot reach the backendBucket, a simple Not Found Error will be returned, with the original response code (or overrideResponseCode if configured). errorService is not supported for internal or regional HTTP/HTTPS load balancers. + */ + errorService?: string | null; + } + /** + * Specifies the mapping between the response code that will be returned along with the custom error content and the response code returned by the backend service. + */ + export interface Schema$CustomErrorResponsePolicyCustomErrorResponseRule { + /** + * Valid values include: - A number between 400 and 599: For example 401 or 503, in which case the load balancer applies the policy if the error code exactly matches this value. - 5xx: Load Balancer will apply the policy if the backend service responds with any response code in the range of 500 to 599. - 4xx: Load Balancer will apply the policy if the backend service responds with any response code in the range of 400 to 499. Values must be unique within matchResponseCodes and across all errorResponseRules of CustomErrorResponsePolicy. + */ + matchResponseCodes?: string[] | null; + /** + * The HTTP status code returned with the response containing the custom error content. If overrideResponseCode is not supplied, the same response code returned by the original backend bucket or backend service is returned to the client. + */ + overrideResponseCode?: number | null; + /** + * The full path to a file within backendBucket . For example: /errors/defaultError.html path must start with a leading slash. path cannot have trailing slashes. If the file is not available in backendBucket or the load balancer cannot reach the BackendBucket, a simple Not Found Error is returned to the client. The value must be from 1 to 1024 characters + */ + path?: string | null; + } /** * Deprecation status for a public resource. */ @@ -4974,6 +5004,10 @@ export namespace compute_v1 { * The HttpRouteRule setting specifies how to match an HTTP request and the corresponding routing action that load balancing proxies perform. */ export interface Schema$HttpRouteRule { + /** + * customErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. If a policy for an error code is not configured for the RouteRule, a policy for the error code configured in pathMatcher.defaultCustomErrorResponsePolicy is applied. If one is not specified in pathMatcher.defaultCustomErrorResponsePolicy, the policy configured in UrlMap.defaultCustomErrorResponsePolicy takes effect. For example, consider a UrlMap with the following configuration: - UrlMap.defaultCustomErrorResponsePolicy are configured with policies for 5xx and 4xx errors - A RouteRule for /coming_soon/ is configured for the error code 404. If the request is for www.myotherdomain.com and a 404 is encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes effect. If a 404 response is encountered for the request www.example.com/current_events/, the pathMatcher's policy takes effect. If however, the request for www.example.com/coming_soon/ encounters a 404, the policy in RouteRule.customErrorResponsePolicy takes effect. If any of the requests in this example encounter a 500 error code, the policy at UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in conjunction with routeRules.routeAction.retryPolicy, retries take precedence. Only once all retries are exhausted, the customErrorResponsePolicy is applied. While attempting a retry, if load balancer is successful in reaching the service, the customErrorResponsePolicy is ignored and the response from the service is returned to the client. customErrorResponsePolicy is supported only for global external Application Load Balancers. + */ + customErrorResponsePolicy?: Schema$CustomErrorResponsePolicy; /** * The short description conveying the intent of this routeRule. The description can have a maximum length of 1024 characters. */ @@ -6588,7 +6622,7 @@ export namespace compute_v1 { */ labels?: {[key: string]: string} | null; /** - * The machine type to use for instances that are created from these properties. This field only accept machine types name. e.g. n2-standard-4 and does not accept machine type full or partial url. e.g. projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4 will throw INTERNAL_ERROR. + * The machine type to use for instances that are created from these properties. This field only accepts a machine type name, for example `n2-standard-4`. If you use the machine type full or partial URL, for example `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`, the request will result in an `INTERNAL_ERROR`. */ machineType?: string | null; /** @@ -10814,6 +10848,10 @@ export namespace compute_v1 { * A matcher for the path portion of the URL. The BackendService from the longest-matched rule will serve the URL. If no rule was matched, the default service is used. */ export interface Schema$PathMatcher { + /** + * defaultCustomErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. This policy takes effect at the PathMatcher level and applies only when no policy has been defined for the error code at lower levels like RouteRule and PathRule within this PathMatcher. If an error code does not have a policy defined in defaultCustomErrorResponsePolicy, then a policy defined for the error code in UrlMap.defaultCustomErrorResponsePolicy takes effect. For example, consider a UrlMap with the following configuration: - UrlMap.defaultCustomErrorResponsePolicy is configured with policies for 5xx and 4xx errors - A RouteRule for /coming_soon/ is configured for the error code 404. If the request is for www.myotherdomain.com and a 404 is encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes effect. If a 404 response is encountered for the request www.example.com/current_events/, the pathMatcher's policy takes effect. If however, the request for www.example.com/coming_soon/ encounters a 404, the policy in RouteRule.customErrorResponsePolicy takes effect. If any of the requests in this example encounter a 500 error code, the policy at UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in conjunction with pathMatcher.defaultRouteAction.retryPolicy, retries take precedence. Only once all retries are exhausted, the defaultCustomErrorResponsePolicy is applied. While attempting a retry, if load balancer is successful in reaching the service, the defaultCustomErrorResponsePolicy is ignored and the response from the service is returned to the client. defaultCustomErrorResponsePolicy is supported only for global external Application Load Balancers. + */ + defaultCustomErrorResponsePolicy?: Schema$CustomErrorResponsePolicy; /** * defaultRouteAction takes effect when none of the pathRules or routeRules match. The load balancer performs advanced routing actions, such as URL rewrites and header transformations, before forwarding the request to the selected backend. If defaultRouteAction specifies any weightedBackendServices, defaultService must not be set. Conversely if defaultService is set, defaultRouteAction cannot contain any weightedBackendServices. If defaultRouteAction is specified, don't set defaultUrlRedirect. If defaultRouteAction.weightedBackendServices is specified, don't set defaultService. URL maps for classic Application Load Balancers only support the urlRewrite action within a path matcher's defaultRouteAction. */ @@ -10851,6 +10889,10 @@ export namespace compute_v1 { * A path-matching rule for a URL. If matched, will use the specified BackendService to handle the traffic arriving at this URL. */ export interface Schema$PathRule { + /** + * customErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. If a policy for an error code is not configured for the PathRule, a policy for the error code configured in pathMatcher.defaultCustomErrorResponsePolicy is applied. If one is not specified in pathMatcher.defaultCustomErrorResponsePolicy, the policy configured in UrlMap.defaultCustomErrorResponsePolicy takes effect. For example, consider a UrlMap with the following configuration: - UrlMap.defaultCustomErrorResponsePolicy are configured with policies for 5xx and 4xx errors - A PathRule for /coming_soon/ is configured for the error code 404. If the request is for www.myotherdomain.com and a 404 is encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes effect. If a 404 response is encountered for the request www.example.com/current_events/, the pathMatcher's policy takes effect. If however, the request for www.example.com/coming_soon/ encounters a 404, the policy in PathRule.customErrorResponsePolicy takes effect. If any of the requests in this example encounter a 500 error code, the policy at UrlMap.defaultCustomErrorResponsePolicy takes effect. customErrorResponsePolicy is supported only for global external Application Load Balancers. + */ + customErrorResponsePolicy?: Schema$CustomErrorResponsePolicy; /** * The list of path patterns to match. Each must start with / and the only place a * is allowed is at the end following a /. The string fed to the path matcher does not include any text after the first ? or #, and those chars are not allowed here. */ @@ -12556,7 +12598,7 @@ export namespace compute_v1 { */ nextHopHub?: string | null; /** - * The URL to a forwarding rule of type loadBalancingScheme=INTERNAL that should handle matching packets or the IP address of the forwarding Rule. For example, the following are all valid URLs: - 10.128.0.56 - https://www.googleapis.com/compute/v1/projects/project/regions/region /forwardingRules/forwardingRule - regions/region/forwardingRules/forwardingRule + * The URL to a forwarding rule of type loadBalancingScheme=INTERNAL that should handle matching packets or the IP address of the forwarding Rule. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/project/regions/region /forwardingRules/forwardingRule - regions/region/forwardingRules/forwardingRule If an IP address is provided, must specify an IPv4 address in dot-decimal notation or an IPv6 address in RFC 4291 format. For example, the following are all valid IP addresses: - 10.128.0.56 - 2001:db8::2d9:51:0:0 - 2001:db8:0:0:2d9:51:0:0 IPv6 addresses will be displayed using RFC 5952 compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address. */ nextHopIlb?: string | null; /** @@ -13096,7 +13138,7 @@ export namespace compute_v1 { */ description?: string | null; /** - * CEL expression that specifies the match condition that egress traffic from a VM is evaluated against. If it evaluates to true, the corresponding `action` is enforced. The following examples are valid match expressions for public NAT: "inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, '2.2.0.0/16')" "destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'" The following example is a valid match expression for private NAT: "nexthop.hub == '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'" + * CEL expression that specifies the match condition that egress traffic from a VM is evaluated against. If it evaluates to true, the corresponding `action` is enforced. The following examples are valid match expressions for public NAT: `inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, '2.2.0.0/16')` `destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'` The following example is a valid match expression for private NAT: `nexthop.hub == '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'` */ match?: string | null; /** @@ -13161,11 +13203,11 @@ export namespace compute_v1 { } export interface Schema$RouterStatus { /** - * Best routes for this router's network. + * A list of the best dynamic routes for this Cloud Router's Virtual Private Cloud (VPC) network in the same region as this Cloud Router. Lists all of the best routes per prefix that are programmed into this region's VPC data plane. When global dynamic routing mode is turned on in the VPC network, this list can include cross-region dynamic routes from Cloud Routers in other regions. */ bestRoutes?: Schema$Route[]; /** - * Best routes learned by this router. + * A list of the best BGP routes learned by this Cloud Router. It is possible that routes listed might not be programmed into the data plane, if the Google Cloud control plane finds a more optimal route for a prefix than a route learned by this Cloud Router. */ bestRoutesForRouter?: Schema$Route[]; bgpPeerStatus?: Schema$RouterStatusBgpPeerStatus[]; @@ -13704,10 +13746,34 @@ export namespace compute_v1 { autoDeployExpirationSec?: number | null; autoDeployImpactedBaselineThreshold?: number | null; autoDeployLoadThreshold?: number | null; + detectionAbsoluteQps?: number | null; + detectionLoadThreshold?: number | null; + detectionRelativeToBaselineQps?: number | null; /** * The name must be 1-63 characters long, and comply with RFC1035. The name must be unique within the security policy. */ name?: string | null; + /** + * Configuration options for enabling Adaptive Protection to operate on specified granular traffic units. + */ + trafficGranularityConfigs?: Schema$SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig[]; + } + /** + * Configurations to specifc granular traffic units processed by Adaptive Protection. + */ + export interface Schema$SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig { + /** + * If enabled, traffic matching each unique value for the specified type constitutes a separate traffic unit. It can only be set to true if `value` is empty. + */ + enableEachUniqueValue?: boolean | null; + /** + * Type of this configuration. + */ + type?: string | null; + /** + * Requests that match this value constitute a granular traffic unit. + */ + value?: string | null; } export interface Schema$SecurityPolicyAdvancedOptionsConfig { /** @@ -15156,7 +15222,7 @@ export namespace compute_v1 { */ performanceProvisioningType?: string | null; /** - * Size, in GiB, of the storage pool. + * Size, in GiB, of the storage pool. For more information about the size limits, see https://cloud.google.com/compute/docs/disks/storage-pools. */ poolProvisionedCapacityGb?: string | null; /** @@ -15371,7 +15437,7 @@ export namespace compute_v1 { */ poolUsedCapacityBytes?: string | null; /** - * Sum of all the disks' provisioned IOPS, minus some amount that is allowed per disk that is not counted towards pool's IOPS capacity. + * [Output Only] Sum of all the disks' provisioned IOPS, minus some amount that is allowed per disk that is not counted towards pool's IOPS capacity. For more information, see https://cloud.google.com/compute/docs/disks/storage-pools. */ poolUsedIops?: string | null; /** @@ -16987,6 +17053,10 @@ export namespace compute_v1 { * [Output Only] Creation timestamp in RFC3339 text format. */ creationTimestamp?: string | null; + /** + * defaultCustomErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. This policy takes effect at the load balancer level and applies only when no policy has been defined for the error code at lower levels like PathMatcher, RouteRule and PathRule within this UrlMap. For example, consider a UrlMap with the following configuration: - defaultCustomErrorResponsePolicy containing policies for responding to 5xx and 4xx errors - A PathMatcher configured for *.example.com has defaultCustomErrorResponsePolicy for 4xx. If a request for http://www.example.com/ encounters a 404, the policy in pathMatcher.defaultCustomErrorResponsePolicy will be enforced. When the request for http://www.example.com/ encounters a 502, the policy in UrlMap.defaultCustomErrorResponsePolicy will be enforced. When a request that does not match any host in *.example.com such as http://www.myotherexample.com/, encounters a 404, UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in conjunction with defaultRouteAction.retryPolicy, retries take precedence. Only once all retries are exhausted, the defaultCustomErrorResponsePolicy is applied. While attempting a retry, if load balancer is successful in reaching the service, the defaultCustomErrorResponsePolicy is ignored and the response from the service is returned to the client. defaultCustomErrorResponsePolicy is supported only for global external Application Load Balancers. + */ + defaultCustomErrorResponsePolicy?: Schema$CustomErrorResponsePolicy; /** * defaultRouteAction takes effect when none of the hostRules match. The load balancer performs advanced routing actions, such as URL rewrites and header transformations, before forwarding the request to the selected backend. If defaultRouteAction specifies any weightedBackendServices, defaultService must not be set. Conversely if defaultService is set, defaultRouteAction cannot contain any weightedBackendServices. Only one of defaultRouteAction or defaultUrlRedirect must be set. URL maps for classic Application Load Balancers only support the urlRewrite action within defaultRouteAction. defaultRouteAction has no effect when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true. */ @@ -92869,7 +92939,7 @@ export namespace compute_v1 { } /** - * Updates the specified storagePool with the data included in the request. The update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: size_tb and provisioned_iops. + * Updates the specified storagePool with the data included in the request. The update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: pool_provisioned_capacity_gb, pool_provisioned_iops and pool_provisioned_throughput. * * @param params - Parameters for request * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. diff --git a/src/apis/dataflow/v1b3.ts b/src/apis/dataflow/v1b3.ts index dc60d123f4..499a0b3047 100644 --- a/src/apis/dataflow/v1b3.ts +++ b/src/apis/dataflow/v1b3.ts @@ -687,7 +687,7 @@ export namespace dataflow_v1b3 { */ dataSampling?: Schema$DataSamplingConfig; /** - * When true, enables the logging of the literal hot key to the user's Cloud Logging. + * Optional. When true, enables the logging of the literal hot key to the user's Cloud Logging. */ enableHotKeyLogging?: boolean | null; } @@ -829,11 +829,11 @@ export namespace dataflow_v1b3 { */ clusterManagerApiService?: string | null; /** - * The dataset for the current project where various workflow related tables are stored. The supported resource type is: Google BigQuery: bigquery.googleapis.com/{dataset\} + * Optional. The dataset for the current project where various workflow related tables are stored. The supported resource type is: Google BigQuery: bigquery.googleapis.com/{dataset\} */ dataset?: string | null; /** - * Any debugging options to be supplied to the job. + * Optional. Any debugging options to be supplied to the job. */ debugOptions?: Schema$DebugOptions; /** @@ -841,7 +841,7 @@ export namespace dataflow_v1b3 { */ experiments?: string[] | null; /** - * Which Flexible Resource Scheduling mode to run in. + * Optional. Which Flexible Resource Scheduling mode to run in. */ flexResourceSchedulingGoal?: string | null; /** @@ -853,11 +853,11 @@ export namespace dataflow_v1b3 { */ sdkPipelineOptions?: {[key: string]: any} | null; /** - * Identity to run virtual machines as. Defaults to the default account. + * Optional. Identity to run virtual machines as. Defaults to the default account. */ serviceAccountEmail?: string | null; /** - * If set, contains the Cloud KMS key identifier used to encrypt data at rest, AKA a Customer Managed Encryption Key (CMEK). Format: projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY + * Optional. If set, contains the Cloud KMS key identifier used to encrypt data at rest, AKA a Customer Managed Encryption Key (CMEK). Format: projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY */ serviceKmsKeyName?: string | null; /** @@ -893,11 +893,11 @@ export namespace dataflow_v1b3 { */ workerPools?: Schema$WorkerPool[]; /** - * The Compute Engine region (https://cloud.google.com/compute/docs/regions-zones/regions-zones) in which worker processing should occur, e.g. "us-west1". Mutually exclusive with worker_zone. If neither worker_region nor worker_zone is specified, default to the control plane's region. + * Optional. The Compute Engine region (https://cloud.google.com/compute/docs/regions-zones/regions-zones) in which worker processing should occur, e.g. "us-west1". Mutually exclusive with worker_zone. If neither worker_region nor worker_zone is specified, default to the control plane's region. */ workerRegion?: string | null; /** - * The Compute Engine zone (https://cloud.google.com/compute/docs/regions-zones/regions-zones) in which worker processing should occur, e.g. "us-west1-a". Mutually exclusive with worker_region. If neither worker_region nor worker_zone is specified, a zone in the control plane's region is chosen based on available capacity. + * Optional. The Compute Engine zone (https://cloud.google.com/compute/docs/regions-zones/regions-zones) in which worker processing should occur, e.g. "us-west1-a". Mutually exclusive with worker_region. If neither worker_region nor worker_zone is specified, a zone in the control plane's region is chosen based on available capacity. */ workerZone?: string | null; } @@ -1334,7 +1334,7 @@ export namespace dataflow_v1b3 { */ labels?: {[key: string]: string} | null; /** - * The [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that contains this job. + * Optional. The [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that contains this job. */ location?: string | null; /** @@ -1373,6 +1373,10 @@ export namespace dataflow_v1b3 { * Reserved for future use. This field is set only in responses from the server; it is ignored if it is set in any requests. */ satisfiesPzs?: boolean | null; + /** + * Output only. Resources used by the Dataflow Service to run the job. + */ + serviceResources?: Schema$ServiceResources; /** * This field may be mutated by the Cloud Dataflow service; callers cannot mutate it. */ @@ -1394,7 +1398,7 @@ export namespace dataflow_v1b3 { */ tempFiles?: string[] | null; /** - * The map of transform name prefixes of the job to be replaced to the corresponding name prefixes of the new job. + * Optional. The map of transform name prefixes of the job to be replaced to the corresponding name prefixes of the new job. */ transformNameMapping?: {[key: string]: string} | null; /** @@ -2660,6 +2664,15 @@ export namespace dataflow_v1b3 { */ tag?: string | null; } + /** + * Resources used by the Dataflow Service to run the job. + */ + export interface Schema$ServiceResources { + /** + * Output only. List of Cloud Zones being used by the Dataflow Service for this job. Example: us-central1-c + */ + zones?: string[] | null; + } /** * A task which consists of a shell command for the worker to execute. */ diff --git a/src/apis/dialogflow/v2.ts b/src/apis/dialogflow/v2.ts index 689fec9fed..ad09cae2cb 100644 --- a/src/apis/dialogflow/v2.ts +++ b/src/apis/dialogflow/v2.ts @@ -1602,11 +1602,11 @@ export namespace dialogflow_v2 { */ export interface Schema$GoogleCloudDialogflowCxV3beta1TestConfig { /** - * Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow. + * Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow. */ flow?: string | null; /** - * The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow. + * The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow. */ page?: string | null; /** @@ -3292,11 +3292,11 @@ export namespace dialogflow_v2 { */ export interface Schema$GoogleCloudDialogflowCxV3TestConfig { /** - * Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow. + * Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow. */ flow?: string | null; /** - * The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow. + * The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow. */ page?: string | null; /** @@ -8961,10 +8961,30 @@ export namespace dialogflow_v2 { * Configures speech transcription for ConversationProfile. */ export interface Schema$GoogleCloudDialogflowV2SpeechToTextConfig { + /** + * Defines the list of other language codes in addition to the one provided by the conversation profile that may be detected as the language code for the utterances over the conversation. See [Language Support](https://cloud.google.com/dialogflow/docs/reference/language) for a list of the currently supported language codes. + */ + alternativeLanguageCodes?: string[] | null; + /** + * Audio encoding of the audio content to process. + */ + audioEncoding?: string | null; + /** + * If `true`, Dialogflow returns SpeechWordInfo in StreamingRecognitionResult with information about the recognized speech words, e.g. start and end time offsets. If false or unspecified, Speech doesn't return any word-level information. + */ + enableWordInfo?: boolean | null; + /** + * The language of the supplied audio. Dialogflow does not do translations. See [Language Support](https://cloud.google.com/dialogflow/docs/reference/language) for a list of the currently supported language codes. Note that queries in the same session do not necessarily need to specify the same language. + */ + languageCode?: string | null; /** * Which Speech model to select. Select the model best suited to your domain to get best results. If a model is not explicitly specified, then Dialogflow auto-selects a model based on other parameters in the SpeechToTextConfig and Agent settings. If enhanced speech model is enabled for the agent and an enhanced version of the specified model for the language does not exist, then the speech is recognized using the standard version of the specified model. Refer to [Cloud Speech API documentation](https://cloud.google.com/speech-to-text/docs/basics#select-model) for more details. If you specify a model, the following models typically have the best performance: - phone_call (best for Agent Assist and telephony) - latest_short (best for Dialogflow non-telephony) - command_and_search Leave this field unspecified to use [Agent Speech settings](https://cloud.google.com/dialogflow/cx/docs/concept/agent#settings-speech) for model selection. */ model?: string | null; + /** + * Sample rate (in Hertz) of the audio content sent in the query. Refer to [Cloud Speech API documentation](https://cloud.google.com/speech-to-text/docs/basics) for more details. + */ + sampleRateHertz?: number | null; /** * The speech model used in speech to text. `SPEECH_MODEL_VARIANT_UNSPECIFIED`, `USE_BEST_AVAILABLE` will be treated as `USE_ENHANCED`. It can be overridden in AnalyzeContentRequest and StreamingAnalyzeContentRequest request. If enhanced model variant is specified and an enhanced version of the specified model for the language does not exist, then it would emit an error. */ diff --git a/src/apis/dialogflow/v2beta1.ts b/src/apis/dialogflow/v2beta1.ts index 2beff5da0d..eff800b5fc 100644 --- a/src/apis/dialogflow/v2beta1.ts +++ b/src/apis/dialogflow/v2beta1.ts @@ -1602,11 +1602,11 @@ export namespace dialogflow_v2beta1 { */ export interface Schema$GoogleCloudDialogflowCxV3beta1TestConfig { /** - * Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow. + * Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow. */ flow?: string | null; /** - * The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow. + * The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow. */ page?: string | null; /** @@ -3292,11 +3292,11 @@ export namespace dialogflow_v2beta1 { */ export interface Schema$GoogleCloudDialogflowCxV3TestConfig { /** - * Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow. + * Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow. */ flow?: string | null; /** - * The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow. + * The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow. */ page?: string | null; /** @@ -7464,10 +7464,30 @@ export namespace dialogflow_v2beta1 { * Configures speech transcription for ConversationProfile. */ export interface Schema$GoogleCloudDialogflowV2beta1SpeechToTextConfig { + /** + * Defines the list of other language codes in addition to the one provided by the conversation profile that may be detected as the language code for the utterances over the conversation. See [Language Support](https://cloud.google.com/dialogflow/docs/reference/language) for a list of the currently supported language codes. + */ + alternativeLanguageCodes?: string[] | null; + /** + * Audio encoding of the audio content to process. + */ + audioEncoding?: string | null; + /** + * If `true`, Dialogflow returns SpeechWordInfo in StreamingRecognitionResult with information about the recognized speech words, e.g. start and end time offsets. If false or unspecified, Speech doesn't return any word-level information. + */ + enableWordInfo?: boolean | null; + /** + * The language of the supplied audio. Dialogflow does not do translations. See [Language Support](https://cloud.google.com/dialogflow/docs/reference/language) for a list of the currently supported language codes. Note that queries in the same session do not necessarily need to specify the same language. + */ + languageCode?: string | null; /** * Which Speech model to select. Select the model best suited to your domain to get best results. If a model is not explicitly specified, then Dialogflow auto-selects a model based on other parameters in the SpeechToTextConfig and Agent settings. If enhanced speech model is enabled for the agent and an enhanced version of the specified model for the language does not exist, then the speech is recognized using the standard version of the specified model. Refer to [Cloud Speech API documentation](https://cloud.google.com/speech-to-text/docs/basics#select-model) for more details. If you specify a model, the following models typically have the best performance: - phone_call (best for Agent Assist and telephony) - latest_short (best for Dialogflow non-telephony) - command_and_search Leave this field unspecified to use [Agent Speech settings](https://cloud.google.com/dialogflow/cx/docs/concept/agent#settings-speech) for model selection. */ model?: string | null; + /** + * Sample rate (in Hertz) of the audio content sent in the query. Refer to [Cloud Speech API documentation](https://cloud.google.com/speech-to-text/docs/basics) for more details. + */ + sampleRateHertz?: number | null; /** * The speech model used in speech to text. `SPEECH_MODEL_VARIANT_UNSPECIFIED`, `USE_BEST_AVAILABLE` will be treated as `USE_ENHANCED`. It can be overridden in AnalyzeContentRequest and StreamingAnalyzeContentRequest request. If enhanced model variant is specified and an enhanced version of the specified model for the language does not exist, then it would emit an error. */ diff --git a/src/apis/dialogflow/v3.ts b/src/apis/dialogflow/v3.ts index 16ea0dfd70..dd767524e8 100644 --- a/src/apis/dialogflow/v3.ts +++ b/src/apis/dialogflow/v3.ts @@ -1813,11 +1813,11 @@ export namespace dialogflow_v3 { */ export interface Schema$GoogleCloudDialogflowCxV3beta1TestConfig { /** - * Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow. + * Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow. */ flow?: string | null; /** - * The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow. + * The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow. */ page?: string | null; /** @@ -5384,11 +5384,11 @@ export namespace dialogflow_v3 { */ export interface Schema$GoogleCloudDialogflowCxV3TestConfig { /** - * Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow. + * Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow. */ flow?: string | null; /** - * The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow. + * The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow. */ page?: string | null; /** diff --git a/src/apis/dialogflow/v3beta1.ts b/src/apis/dialogflow/v3beta1.ts index 95df81fe7a..ecc397c2b1 100644 --- a/src/apis/dialogflow/v3beta1.ts +++ b/src/apis/dialogflow/v3beta1.ts @@ -4324,11 +4324,11 @@ export namespace dialogflow_v3beta1 { */ export interface Schema$GoogleCloudDialogflowCxV3beta1TestConfig { /** - * Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow. + * Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow. */ flow?: string | null; /** - * The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow. + * The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow. */ page?: string | null; /** @@ -6474,11 +6474,11 @@ export namespace dialogflow_v3beta1 { */ export interface Schema$GoogleCloudDialogflowCxV3TestConfig { /** - * Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow. + * Flow name to start the test case with. Format: `projects//locations//agents//flows/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow. */ flow?: string | null; /** - * The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If both are set, `page` takes precedence over `flow`. If neither is set, the test case will start with start page on the default start flow. + * The page to start the test case with. Format: `projects//locations//agents//flows//pages/`. Only one of `flow` and `page` should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow. */ page?: string | null; /** diff --git a/src/apis/displayvideo/v3.ts b/src/apis/displayvideo/v3.ts index 3b5d831a79..79dedd4229 100644 --- a/src/apis/displayvideo/v3.ts +++ b/src/apis/displayvideo/v3.ts @@ -3457,6 +3457,10 @@ export namespace displayvideo_v3 { * YouTube Ad Groups to download by ID. All IDs must belong to the same Advertiser or Partner specified in CreateSdfDownloadTaskRequest. */ adGroupIds?: string[] | null; + /** + * Optional. YouTube Ad Groups QA to download by ID. All IDs must belong to the same Advertiser or Partner specified in CreateSdfDownloadTaskRequest. + */ + adGroupQaIds?: string[] | null; /** * Campaigns to download by ID. All IDs must belong to the same Advertiser or Partner specified in CreateSdfDownloadTaskRequest. */ @@ -3469,6 +3473,10 @@ export namespace displayvideo_v3 { * Line Items to download by ID. All IDs must belong to the same Advertiser or Partner specified in CreateSdfDownloadTaskRequest. */ lineItemIds?: string[] | null; + /** + * Optional. Line Items QA to download by ID. All IDs must belong to the same Advertiser or Partner specified in CreateSdfDownloadTaskRequest. + */ + lineItemQaIds?: string[] | null; /** * Media Products to download by ID. All IDs must belong to the same Advertiser or Partner specified in CreateSdfDownloadTaskRequest. */ diff --git a/src/apis/dlp/v2.ts b/src/apis/dlp/v2.ts index e785f2e5b6..0d17e084c9 100644 --- a/src/apis/dlp/v2.ts +++ b/src/apis/dlp/v2.ts @@ -1183,6 +1183,10 @@ export namespace dlp_v2 { * Column data profile column */ columnProfile?: Schema$GooglePrivacyDlpV2ColumnDataProfile; + /** + * File store data profile column. + */ + fileStoreProfile?: Schema$GooglePrivacyDlpV2FileStoreDataProfile; /** * Table data profile column */ @@ -1264,6 +1268,10 @@ export namespace dlp_v2 { * The event that caused the Pub/Sub message to be sent. */ event?: string | null; + /** + * If `DetailLevel` is `FILE_STORE_PROFILE` this will be fully populated. Otherwise, if `DetailLevel` is `RESOURCE_NAME`, then only `name` and `file_store_path` will be populated. + */ + fileStoreProfile?: Schema$GooglePrivacyDlpV2FileStoreDataProfile; /** * If `DetailLevel` is `TABLE_PROFILE` this will be fully populated. Otherwise, if `DetailLevel` is `RESOURCE_NAME`, then only `name` and `full_resource` will be populated. */ @@ -1862,6 +1870,10 @@ export namespace dlp_v2 { * Detailed error codes and messages. */ details?: Schema$GoogleRpcStatus; + /** + * Additional information about the error. + */ + extraInfo?: string | null; /** * The times the error occurred. List includes the oldest timestamp and the last 9 timestamps. */ @@ -1966,6 +1978,61 @@ export namespace dlp_v2 { */ primitiveTransformation?: Schema$GooglePrivacyDlpV2PrimitiveTransformation; } + /** + * The file cluster summary. + */ + export interface Schema$GooglePrivacyDlpV2FileClusterSummary { + /** + * The data risk level of this cluster. RISK_LOW if nothing has been scanned. + */ + dataRiskLevel?: Schema$GooglePrivacyDlpV2DataRiskLevel; + /** + * A list of Errors detected while scanning this cluster. The list is truncated to 10 per cluster. + */ + errors?: Schema$GooglePrivacyDlpV2Error[]; + /** + * The file cluster type. + */ + fileClusterType?: Schema$GooglePrivacyDlpV2FileClusterType; + /** + * A sample of file types scanned in this cluster. Empty if no files were scanned. + */ + fileExtensionsScanned?: Schema$GooglePrivacyDlpV2FileExtensionInfo[]; + /** + * A sample of file types seen in this cluster. Empty if no files were seen. + */ + fileExtensionsSeen?: Schema$GooglePrivacyDlpV2FileExtensionInfo[]; + /** + * InfoTypes detected in this cluster. + */ + fileStoreInfoTypeSummaries?: Schema$GooglePrivacyDlpV2FileStoreInfoTypeSummary[]; + /** + * True if no files exist in this cluster. If the bucket had more files than could be listed, this will be false even if no files for this cluster were seen and file_extensions_seen is empty. + */ + noFilesExist?: boolean | null; + /** + * The sensitivity score of this cluster. The score will be SENSITIVITY_LOW if nothing has been scanned. + */ + sensitivityScore?: Schema$GooglePrivacyDlpV2SensitivityScore; + } + /** + * Message used to identify file cluster type being profiled. + */ + export interface Schema$GooglePrivacyDlpV2FileClusterType { + /** + * Cluster type. + */ + cluster?: string | null; + } + /** + * Information regarding the discovered file extension. + */ + export interface Schema$GooglePrivacyDlpV2FileExtensionInfo { + /** + * The file extension if set. (aka .pdf, .jpg, .txt) + */ + fileExtension?: string | null; + } /** * Set of files to scan. */ @@ -1979,6 +2046,112 @@ export namespace dlp_v2 { */ url?: string | null; } + /** + * The profile for a file store. * Google Cloud Storage: maps 1:1 with a bucket. + */ + export interface Schema$GooglePrivacyDlpV2FileStoreDataProfile { + /** + * The snapshot of the configurations used to generate the profile. + */ + configSnapshot?: Schema$GooglePrivacyDlpV2DataProfileConfigSnapshot; + /** + * The time the file store was first created. + */ + createTime?: string | null; + /** + * The data risk level of this resource. + */ + dataRiskLevel?: Schema$GooglePrivacyDlpV2DataRiskLevel; + /** + * The resource type that was profiled. + */ + dataSourceType?: Schema$GooglePrivacyDlpV2DataSourceType; + /** + * For resources that have multiple storage locations, these are those regions. For Google Cloud Storage this is the list of regions chosen for dual-region storage. `file_store_location` will normally be the corresponding multi-region for the list of individual locations. The first region is always picked as the processing and storage location for the data profile. + */ + dataStorageLocations?: string[] | null; + /** + * FileClusterSummary per each cluster. + */ + fileClusterSummaries?: Schema$GooglePrivacyDlpV2FileClusterSummary[]; + /** + * InfoTypes detected in this file store. + */ + fileStoreInfoTypeSummaries?: Schema$GooglePrivacyDlpV2FileStoreInfoTypeSummary[]; + /** + * The file store does not have any files. + */ + fileStoreIsEmpty?: boolean | null; + /** + * The location of the file store. * Google Cloud Storage: https://cloud.google.com/storage/docs/locations#available-locations + */ + fileStoreLocation?: string | null; + /** + * The file store path. * Google Cloud Storage: `gs://{bucket\}` + */ + fileStorePath?: string | null; + /** + * The resource name of the resource profiled. https://cloud.google.com/apis/design/resource_names#full_resource_name + */ + fullResource?: string | null; + /** + * The time the file store was last modified. + */ + lastModifiedTime?: string | null; + /** + * The location type of the bucket (region, dual-region, multi-region, etc). If dual-region, expect data_storage_locations to be populated. + */ + locationType?: string | null; + /** + * The name of the profile. + */ + name?: string | null; + /** + * The last time the profile was generated. + */ + profileLastGenerated?: string | null; + /** + * Success or error status from the most recent profile generation attempt. May be empty if the profile is still being generated. + */ + profileStatus?: Schema$GooglePrivacyDlpV2ProfileStatus; + /** + * The resource name to the project data profile for this file store. + */ + projectDataProfile?: string | null; + /** + * The Google Cloud project ID that owns the resource. + */ + projectId?: string | null; + /** + * Attributes of the resource being profiled. Currently used attributes: - customer_managed_encryption: boolean true: the resource is encrypted with a customer-managed key. false: the resource is encrypted with a provider-managed key. + */ + resourceAttributes?: {[key: string]: Schema$GooglePrivacyDlpV2Value} | null; + /** + * The labels applied to the resource at the time the profile was generated. + */ + resourceLabels?: {[key: string]: string} | null; + /** + * How broadly a resource has been shared. + */ + resourceVisibility?: string | null; + /** + * The sensitivity score of this resource. + */ + sensitivityScore?: Schema$GooglePrivacyDlpV2SensitivityScore; + /** + * State of a profile. + */ + state?: string | null; + } + /** + * Information regarding the discovered InfoType. + */ + export interface Schema$GooglePrivacyDlpV2FileStoreInfoTypeSummary { + /** + * The InfoType seen. + */ + infoType?: Schema$GooglePrivacyDlpV2InfoType; + } /** * Represents a piece of potentially sensitive content. */ @@ -2943,6 +3116,19 @@ export namespace dlp_v2 { */ nextPageToken?: string | null; } + /** + * List of file store data profiles generated for a given organization or project. + */ + export interface Schema$GooglePrivacyDlpV2ListFileStoreDataProfilesResponse { + /** + * List of data profiles. + */ + fileStoreDataProfiles?: Schema$GooglePrivacyDlpV2FileStoreDataProfile[]; + /** + * The next page token. + */ + nextPageToken?: string | null; + } /** * Response to the ListInfoTypes request. */ @@ -3270,6 +3456,10 @@ export namespace dlp_v2 { * The data risk level of this project. */ dataRiskLevel?: Schema$GooglePrivacyDlpV2DataRiskLevel; + /** + * The number of file store data profiles generated for this project. + */ + fileStoreDataProfileCount?: string | null; /** * The resource name of the profile. */ @@ -3290,6 +3480,10 @@ export namespace dlp_v2 { * The sensitivity score of this project. */ sensitivityScore?: Schema$GooglePrivacyDlpV2SensitivityScore; + /** + * The number of table data profiles generated for this project. + */ + tableDataProfileCount?: string | null; } /** * Message for specifying a window around a finding to apply a detection rule. @@ -5957,6 +6151,7 @@ export namespace dlp_v2 { deidentifyTemplates: Resource$Organizations$Locations$Deidentifytemplates; discoveryConfigs: Resource$Organizations$Locations$Discoveryconfigs; dlpJobs: Resource$Organizations$Locations$Dlpjobs; + fileStoreDataProfiles: Resource$Organizations$Locations$Filestoredataprofiles; inspectTemplates: Resource$Organizations$Locations$Inspecttemplates; jobTriggers: Resource$Organizations$Locations$Jobtriggers; projectDataProfiles: Resource$Organizations$Locations$Projectdataprofiles; @@ -5974,6 +6169,10 @@ export namespace dlp_v2 { this.discoveryConfigs = new Resource$Organizations$Locations$Discoveryconfigs(this.context); this.dlpJobs = new Resource$Organizations$Locations$Dlpjobs(this.context); + this.fileStoreDataProfiles = + new Resource$Organizations$Locations$Filestoredataprofiles( + this.context + ); this.inspectTemplates = new Resource$Organizations$Locations$Inspecttemplates(this.context); this.jobTriggers = new Resource$Organizations$Locations$Jobtriggers( @@ -7978,72 +8177,68 @@ export namespace dlp_v2 { type?: string; } - export class Resource$Organizations$Locations$Inspecttemplates { + export class Resource$Organizations$Locations$Filestoredataprofiles { context: APIRequestContext; constructor(context: APIRequestContext) { this.context = context; } /** - * Creates an InspectTemplate for reusing frequently used configuration for inspecting content, images, and storage. See https://cloud.google.com/sensitive-data-protection/docs/creating-templates to learn more. + * Delete a FileStoreDataProfile. Will not prevent the profile from being regenerated if the resource is still included in a discovery configuration. * * @param params - Parameters for request * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. * @param callback - Optional callback that handles the response. * @returns A promise if used with async/await, or void if used with a callback. */ - create( - params: Params$Resource$Organizations$Locations$Inspecttemplates$Create, + delete( + params: Params$Resource$Organizations$Locations$Filestoredataprofiles$Delete, options: StreamMethodOptions ): GaxiosPromise; - create( - params?: Params$Resource$Organizations$Locations$Inspecttemplates$Create, + delete( + params?: Params$Resource$Organizations$Locations$Filestoredataprofiles$Delete, options?: MethodOptions - ): GaxiosPromise; - create( - params: Params$Resource$Organizations$Locations$Inspecttemplates$Create, + ): GaxiosPromise; + delete( + params: Params$Resource$Organizations$Locations$Filestoredataprofiles$Delete, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - create( - params: Params$Resource$Organizations$Locations$Inspecttemplates$Create, - options: - | MethodOptions - | BodyResponseCallback, - callback: BodyResponseCallback - ): void; - create( - params: Params$Resource$Organizations$Locations$Inspecttemplates$Create, - callback: BodyResponseCallback + delete( + params: Params$Resource$Organizations$Locations$Filestoredataprofiles$Delete, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback ): void; - create( - callback: BodyResponseCallback + delete( + params: Params$Resource$Organizations$Locations$Filestoredataprofiles$Delete, + callback: BodyResponseCallback ): void; - create( + delete(callback: BodyResponseCallback): void; + delete( paramsOrCallback?: - | Params$Resource$Organizations$Locations$Inspecttemplates$Create - | BodyResponseCallback + | Params$Resource$Organizations$Locations$Filestoredataprofiles$Delete + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback ): | void - | GaxiosPromise + | GaxiosPromise | GaxiosPromise { let params = (paramsOrCallback || - {}) as Params$Resource$Organizations$Locations$Inspecttemplates$Create; + {}) as Params$Resource$Organizations$Locations$Filestoredataprofiles$Delete; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; params = - {} as Params$Resource$Organizations$Locations$Inspecttemplates$Create; + {} as Params$Resource$Organizations$Locations$Filestoredataprofiles$Delete; options = {}; } @@ -8056,88 +8251,87 @@ export namespace dlp_v2 { const parameters = { options: Object.assign( { - url: (rootUrl + '/v2/{+parent}/inspectTemplates').replace( - /([^:]\/)\/+/g, - '$1' - ), - method: 'POST', + url: (rootUrl + '/v2/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'DELETE', apiVersion: '', }, options ), params, - requiredParams: ['parent'], - pathParams: ['parent'], + requiredParams: ['name'], + pathParams: ['name'], context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest( - parameters - ); + return createAPIRequest(parameters); } } /** - * Deletes an InspectTemplate. See https://cloud.google.com/sensitive-data-protection/docs/creating-templates to learn more. + * Gets a file store data profile. * * @param params - Parameters for request * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. * @param callback - Optional callback that handles the response. * @returns A promise if used with async/await, or void if used with a callback. */ - delete( - params: Params$Resource$Organizations$Locations$Inspecttemplates$Delete, + get( + params: Params$Resource$Organizations$Locations$Filestoredataprofiles$Get, options: StreamMethodOptions ): GaxiosPromise; - delete( - params?: Params$Resource$Organizations$Locations$Inspecttemplates$Delete, + get( + params?: Params$Resource$Organizations$Locations$Filestoredataprofiles$Get, options?: MethodOptions - ): GaxiosPromise; - delete( - params: Params$Resource$Organizations$Locations$Inspecttemplates$Delete, + ): GaxiosPromise; + get( + params: Params$Resource$Organizations$Locations$Filestoredataprofiles$Get, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - delete( - params: Params$Resource$Organizations$Locations$Inspecttemplates$Delete, - options: MethodOptions | BodyResponseCallback, - callback: BodyResponseCallback + get( + params: Params$Resource$Organizations$Locations$Filestoredataprofiles$Get, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback ): void; - delete( - params: Params$Resource$Organizations$Locations$Inspecttemplates$Delete, - callback: BodyResponseCallback + get( + params: Params$Resource$Organizations$Locations$Filestoredataprofiles$Get, + callback: BodyResponseCallback ): void; - delete(callback: BodyResponseCallback): void; - delete( + get( + callback: BodyResponseCallback + ): void; + get( paramsOrCallback?: - | Params$Resource$Organizations$Locations$Inspecttemplates$Delete - | BodyResponseCallback + | Params$Resource$Organizations$Locations$Filestoredataprofiles$Get + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback ): | void - | GaxiosPromise + | GaxiosPromise | GaxiosPromise { let params = (paramsOrCallback || - {}) as Params$Resource$Organizations$Locations$Inspecttemplates$Delete; + {}) as Params$Resource$Organizations$Locations$Filestoredataprofiles$Get; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; params = - {} as Params$Resource$Organizations$Locations$Inspecttemplates$Delete; + {} as Params$Resource$Organizations$Locations$Filestoredataprofiles$Get; options = {}; } @@ -8151,7 +8345,7 @@ export namespace dlp_v2 { options: Object.assign( { url: (rootUrl + '/v2/{+name}').replace(/([^:]\/)\/+/g, '$1'), - method: 'DELETE', + method: 'GET', apiVersion: '', }, options @@ -8162,75 +8356,77 @@ export namespace dlp_v2 { context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest(parameters); + return createAPIRequest( + parameters + ); } } /** - * Gets an InspectTemplate. See https://cloud.google.com/sensitive-data-protection/docs/creating-templates to learn more. + * Lists file store data profiles for an organization. * * @param params - Parameters for request * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. * @param callback - Optional callback that handles the response. * @returns A promise if used with async/await, or void if used with a callback. */ - get( - params: Params$Resource$Organizations$Locations$Inspecttemplates$Get, + list( + params: Params$Resource$Organizations$Locations$Filestoredataprofiles$List, options: StreamMethodOptions ): GaxiosPromise; - get( - params?: Params$Resource$Organizations$Locations$Inspecttemplates$Get, + list( + params?: Params$Resource$Organizations$Locations$Filestoredataprofiles$List, options?: MethodOptions - ): GaxiosPromise; - get( - params: Params$Resource$Organizations$Locations$Inspecttemplates$Get, + ): GaxiosPromise; + list( + params: Params$Resource$Organizations$Locations$Filestoredataprofiles$List, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - get( - params: Params$Resource$Organizations$Locations$Inspecttemplates$Get, + list( + params: Params$Resource$Organizations$Locations$Filestoredataprofiles$List, options: | MethodOptions - | BodyResponseCallback, - callback: BodyResponseCallback + | BodyResponseCallback, + callback: BodyResponseCallback ): void; - get( - params: Params$Resource$Organizations$Locations$Inspecttemplates$Get, - callback: BodyResponseCallback + list( + params: Params$Resource$Organizations$Locations$Filestoredataprofiles$List, + callback: BodyResponseCallback ): void; - get( - callback: BodyResponseCallback + list( + callback: BodyResponseCallback ): void; - get( + list( paramsOrCallback?: - | Params$Resource$Organizations$Locations$Inspecttemplates$Get - | BodyResponseCallback + | Params$Resource$Organizations$Locations$Filestoredataprofiles$List + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback ): | void - | GaxiosPromise + | GaxiosPromise | GaxiosPromise { let params = (paramsOrCallback || - {}) as Params$Resource$Organizations$Locations$Inspecttemplates$Get; + {}) as Params$Resource$Organizations$Locations$Filestoredataprofiles$List; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; params = - {} as Params$Resource$Organizations$Locations$Inspecttemplates$Get; + {} as Params$Resource$Organizations$Locations$Filestoredataprofiles$List; options = {}; } @@ -8243,89 +8439,137 @@ export namespace dlp_v2 { const parameters = { options: Object.assign( { - url: (rootUrl + '/v2/{+name}').replace(/([^:]\/)\/+/g, '$1'), + url: (rootUrl + '/v2/{+parent}/fileStoreDataProfiles').replace( + /([^:]\/)\/+/g, + '$1' + ), method: 'GET', apiVersion: '', }, options ), params, - requiredParams: ['name'], - pathParams: ['name'], + requiredParams: ['parent'], + pathParams: ['parent'], context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest( + return createAPIRequest( parameters ); } } + } + export interface Params$Resource$Organizations$Locations$Filestoredataprofiles$Delete + extends StandardParameters { /** - * Lists InspectTemplates. See https://cloud.google.com/sensitive-data-protection/docs/creating-templates to learn more. + * Required. Resource name of the file store data profile. + */ + name?: string; + } + export interface Params$Resource$Organizations$Locations$Filestoredataprofiles$Get + extends StandardParameters { + /** + * Required. Resource name, for example `organizations/12345/locations/us/fileStoreDataProfiles/53234423`. + */ + name?: string; + } + export interface Params$Resource$Organizations$Locations$Filestoredataprofiles$List + extends StandardParameters { + /** + * Optional. Allows filtering. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field\} {operator\} {value\}`. * Supported fields/values: - `project_id` - The Google Cloud project ID. - `file_store_path` - The path like "gs://bucket". - `sensitivity_level` - HIGH|MODERATE|LOW - `data_risk_level` - HIGH|MODERATE|LOW - `resource_visibility`: PUBLIC|RESTRICTED - `status_code` - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto * The operator must be `=` or `!=`. Examples: * `project_id = 12345 AND status_code = 1` * `project_id = 12345 AND sensitivity_level = HIGH` * `project_id = 12345 AND resource_visibility = PUBLIC` . * 'file_store_path = "gs://mybucket"` The length of this field should be no more than 500 characters. + */ + filter?: string; + /** + * Optional. Comma separated list of fields to order by, followed by `asc` or `desc` postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed. Examples: * `project_id asc` * `name` * `sensitivity_level desc` Supported fields are: - `project_id`: The Google Cloud project ID. - `sensitivity_level`: How sensitive the data in a table is, at most. - `data_risk_level`: How much risk is associated with this data. - `profile_last_generated`: When the profile was last updated in epoch seconds. - `last_modified`: The last time the resource was modified. - `resource_visibility`: Visibility restriction for this resource. - `name`: The name of the profile. - `create_time`: The time the file store was first created. + */ + orderBy?: string; + /** + * Optional. Size of the page. This value can be limited by the server. If zero, server returns a page of max size 100. + */ + pageSize?: number; + /** + * Optional. Page token to continue retrieval. + */ + pageToken?: string; + /** + * Required. Resource name of the organization or project, for example `organizations/433245324/locations/europe` or `projects/project-id/locations/asia`. + */ + parent?: string; + } + + export class Resource$Organizations$Locations$Inspecttemplates { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * Creates an InspectTemplate for reusing frequently used configuration for inspecting content, images, and storage. See https://cloud.google.com/sensitive-data-protection/docs/creating-templates to learn more. * * @param params - Parameters for request * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. * @param callback - Optional callback that handles the response. * @returns A promise if used with async/await, or void if used with a callback. */ - list( - params: Params$Resource$Organizations$Locations$Inspecttemplates$List, + create( + params: Params$Resource$Organizations$Locations$Inspecttemplates$Create, options: StreamMethodOptions ): GaxiosPromise; - list( - params?: Params$Resource$Organizations$Locations$Inspecttemplates$List, + create( + params?: Params$Resource$Organizations$Locations$Inspecttemplates$Create, options?: MethodOptions - ): GaxiosPromise; - list( - params: Params$Resource$Organizations$Locations$Inspecttemplates$List, + ): GaxiosPromise; + create( + params: Params$Resource$Organizations$Locations$Inspecttemplates$Create, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - list( - params: Params$Resource$Organizations$Locations$Inspecttemplates$List, + create( + params: Params$Resource$Organizations$Locations$Inspecttemplates$Create, options: | MethodOptions - | BodyResponseCallback, - callback: BodyResponseCallback + | BodyResponseCallback, + callback: BodyResponseCallback ): void; - list( - params: Params$Resource$Organizations$Locations$Inspecttemplates$List, - callback: BodyResponseCallback + create( + params: Params$Resource$Organizations$Locations$Inspecttemplates$Create, + callback: BodyResponseCallback ): void; - list( - callback: BodyResponseCallback + create( + callback: BodyResponseCallback ): void; - list( + create( paramsOrCallback?: - | Params$Resource$Organizations$Locations$Inspecttemplates$List - | BodyResponseCallback + | Params$Resource$Organizations$Locations$Inspecttemplates$Create + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback ): | void - | GaxiosPromise + | GaxiosPromise | GaxiosPromise { let params = (paramsOrCallback || - {}) as Params$Resource$Organizations$Locations$Inspecttemplates$List; + {}) as Params$Resource$Organizations$Locations$Inspecttemplates$Create; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; params = - {} as Params$Resource$Organizations$Locations$Inspecttemplates$List; + {} as Params$Resource$Organizations$Locations$Inspecttemplates$Create; options = {}; } @@ -8342,7 +8586,7 @@ export namespace dlp_v2 { /([^:]\/)\/+/g, '$1' ), - method: 'GET', + method: 'POST', apiVersion: '', }, options @@ -8353,55 +8597,144 @@ export namespace dlp_v2 { context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest( + return createAPIRequest( parameters ); } } /** - * Updates the InspectTemplate. See https://cloud.google.com/sensitive-data-protection/docs/creating-templates to learn more. + * Deletes an InspectTemplate. See https://cloud.google.com/sensitive-data-protection/docs/creating-templates to learn more. * * @param params - Parameters for request * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. * @param callback - Optional callback that handles the response. * @returns A promise if used with async/await, or void if used with a callback. */ - patch( - params: Params$Resource$Organizations$Locations$Inspecttemplates$Patch, + delete( + params: Params$Resource$Organizations$Locations$Inspecttemplates$Delete, options: StreamMethodOptions ): GaxiosPromise; - patch( - params?: Params$Resource$Organizations$Locations$Inspecttemplates$Patch, + delete( + params?: Params$Resource$Organizations$Locations$Inspecttemplates$Delete, + options?: MethodOptions + ): GaxiosPromise; + delete( + params: Params$Resource$Organizations$Locations$Inspecttemplates$Delete, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Organizations$Locations$Inspecttemplates$Delete, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Organizations$Locations$Inspecttemplates$Delete, + callback: BodyResponseCallback + ): void; + delete(callback: BodyResponseCallback): void; + delete( + paramsOrCallback?: + | Params$Resource$Organizations$Locations$Inspecttemplates$Delete + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | GaxiosPromise + | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Organizations$Locations$Inspecttemplates$Delete; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Organizations$Locations$Inspecttemplates$Delete; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://dlp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v2/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'DELETE', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Gets an InspectTemplate. See https://cloud.google.com/sensitive-data-protection/docs/creating-templates to learn more. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + get( + params: Params$Resource$Organizations$Locations$Inspecttemplates$Get, + options: StreamMethodOptions + ): GaxiosPromise; + get( + params?: Params$Resource$Organizations$Locations$Inspecttemplates$Get, options?: MethodOptions ): GaxiosPromise; - patch( - params: Params$Resource$Organizations$Locations$Inspecttemplates$Patch, + get( + params: Params$Resource$Organizations$Locations$Inspecttemplates$Get, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - patch( - params: Params$Resource$Organizations$Locations$Inspecttemplates$Patch, + get( + params: Params$Resource$Organizations$Locations$Inspecttemplates$Get, options: | MethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - patch( - params: Params$Resource$Organizations$Locations$Inspecttemplates$Patch, + get( + params: Params$Resource$Organizations$Locations$Inspecttemplates$Get, callback: BodyResponseCallback ): void; - patch( + get( callback: BodyResponseCallback ): void; - patch( + get( paramsOrCallback?: - | Params$Resource$Organizations$Locations$Inspecttemplates$Patch + | Params$Resource$Organizations$Locations$Inspecttemplates$Get | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: @@ -8417,13 +8750,13 @@ export namespace dlp_v2 { | GaxiosPromise | GaxiosPromise { let params = (paramsOrCallback || - {}) as Params$Resource$Organizations$Locations$Inspecttemplates$Patch; + {}) as Params$Resource$Organizations$Locations$Inspecttemplates$Get; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; params = - {} as Params$Resource$Organizations$Locations$Inspecttemplates$Patch; + {} as Params$Resource$Organizations$Locations$Inspecttemplates$Get; options = {}; } @@ -8437,7 +8770,7 @@ export namespace dlp_v2 { options: Object.assign( { url: (rootUrl + '/v2/{+name}').replace(/([^:]\/)\/+/g, '$1'), - method: 'PATCH', + method: 'GET', apiVersion: '', }, options @@ -8458,24 +8791,217 @@ export namespace dlp_v2 { ); } } - } - - export interface Params$Resource$Organizations$Locations$Inspecttemplates$Create - extends StandardParameters { - /** - * Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID + Organizations scope, location specified: `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no location specified (defaults to global): `organizations/`ORG_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3 - */ - parent?: string; /** - * Request body metadata + * Lists InspectTemplates. See https://cloud.google.com/sensitive-data-protection/docs/creating-templates to learn more. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. */ - requestBody?: Schema$GooglePrivacyDlpV2CreateInspectTemplateRequest; - } - export interface Params$Resource$Organizations$Locations$Inspecttemplates$Delete - extends StandardParameters { - /** - * Required. Resource name of the organization and inspectTemplate to be deleted, for example `organizations/433245324/inspectTemplates/432452342` or projects/project-id/inspectTemplates/432452342. + list( + params: Params$Resource$Organizations$Locations$Inspecttemplates$List, + options: StreamMethodOptions + ): GaxiosPromise; + list( + params?: Params$Resource$Organizations$Locations$Inspecttemplates$List, + options?: MethodOptions + ): GaxiosPromise; + list( + params: Params$Resource$Organizations$Locations$Inspecttemplates$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Organizations$Locations$Inspecttemplates$List, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Organizations$Locations$Inspecttemplates$List, + callback: BodyResponseCallback + ): void; + list( + callback: BodyResponseCallback + ): void; + list( + paramsOrCallback?: + | Params$Resource$Organizations$Locations$Inspecttemplates$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | GaxiosPromise + | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Organizations$Locations$Inspecttemplates$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Organizations$Locations$Inspecttemplates$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://dlp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v2/{+parent}/inspectTemplates').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['parent'], + pathParams: ['parent'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest( + parameters + ); + } + } + + /** + * Updates the InspectTemplate. See https://cloud.google.com/sensitive-data-protection/docs/creating-templates to learn more. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + patch( + params: Params$Resource$Organizations$Locations$Inspecttemplates$Patch, + options: StreamMethodOptions + ): GaxiosPromise; + patch( + params?: Params$Resource$Organizations$Locations$Inspecttemplates$Patch, + options?: MethodOptions + ): GaxiosPromise; + patch( + params: Params$Resource$Organizations$Locations$Inspecttemplates$Patch, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Organizations$Locations$Inspecttemplates$Patch, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Organizations$Locations$Inspecttemplates$Patch, + callback: BodyResponseCallback + ): void; + patch( + callback: BodyResponseCallback + ): void; + patch( + paramsOrCallback?: + | Params$Resource$Organizations$Locations$Inspecttemplates$Patch + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | GaxiosPromise + | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Organizations$Locations$Inspecttemplates$Patch; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Organizations$Locations$Inspecttemplates$Patch; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://dlp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v2/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'PATCH', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest( + parameters + ); + } + } + } + + export interface Params$Resource$Organizations$Locations$Inspecttemplates$Create + extends StandardParameters { + /** + * Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID + Organizations scope, location specified: `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no location specified (defaults to global): `organizations/`ORG_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3 + */ + parent?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$GooglePrivacyDlpV2CreateInspectTemplateRequest; + } + export interface Params$Resource$Organizations$Locations$Inspecttemplates$Delete + extends StandardParameters { + /** + * Required. Resource name of the organization and inspectTemplate to be deleted, for example `organizations/433245324/inspectTemplates/432452342` or projects/project-id/inspectTemplates/432452342. */ name?: string; } @@ -13469,6 +13995,7 @@ export namespace dlp_v2 { deidentifyTemplates: Resource$Projects$Locations$Deidentifytemplates; discoveryConfigs: Resource$Projects$Locations$Discoveryconfigs; dlpJobs: Resource$Projects$Locations$Dlpjobs; + fileStoreDataProfiles: Resource$Projects$Locations$Filestoredataprofiles; image: Resource$Projects$Locations$Image; inspectTemplates: Resource$Projects$Locations$Inspecttemplates; jobTriggers: Resource$Projects$Locations$Jobtriggers; @@ -13489,6 +14016,8 @@ export namespace dlp_v2 { this.context ); this.dlpJobs = new Resource$Projects$Locations$Dlpjobs(this.context); + this.fileStoreDataProfiles = + new Resource$Projects$Locations$Filestoredataprofiles(this.context); this.image = new Resource$Projects$Locations$Image(this.context); this.inspectTemplates = new Resource$Projects$Locations$Inspecttemplates( this.context @@ -16083,39 +16612,512 @@ export namespace dlp_v2 { } /** - * Finish a running hybrid DlpJob. Triggers the finalization steps and running of any enabled actions that have not yet run. + * Finish a running hybrid DlpJob. Triggers the finalization steps and running of any enabled actions that have not yet run. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + finish( + params: Params$Resource$Projects$Locations$Dlpjobs$Finish, + options: StreamMethodOptions + ): GaxiosPromise; + finish( + params?: Params$Resource$Projects$Locations$Dlpjobs$Finish, + options?: MethodOptions + ): GaxiosPromise; + finish( + params: Params$Resource$Projects$Locations$Dlpjobs$Finish, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + finish( + params: Params$Resource$Projects$Locations$Dlpjobs$Finish, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + finish( + params: Params$Resource$Projects$Locations$Dlpjobs$Finish, + callback: BodyResponseCallback + ): void; + finish(callback: BodyResponseCallback): void; + finish( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Dlpjobs$Finish + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | GaxiosPromise + | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Dlpjobs$Finish; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Dlpjobs$Finish; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://dlp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v2/{+name}:finish').replace(/([^:]\/)\/+/g, '$1'), + method: 'POST', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Gets the latest state of a long-running DlpJob. See https://cloud.google.com/sensitive-data-protection/docs/inspecting-storage and https://cloud.google.com/sensitive-data-protection/docs/compute-risk-analysis to learn more. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + get( + params: Params$Resource$Projects$Locations$Dlpjobs$Get, + options: StreamMethodOptions + ): GaxiosPromise; + get( + params?: Params$Resource$Projects$Locations$Dlpjobs$Get, + options?: MethodOptions + ): GaxiosPromise; + get( + params: Params$Resource$Projects$Locations$Dlpjobs$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Dlpjobs$Get, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Dlpjobs$Get, + callback: BodyResponseCallback + ): void; + get(callback: BodyResponseCallback): void; + get( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Dlpjobs$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | GaxiosPromise + | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Dlpjobs$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Dlpjobs$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://dlp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v2/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Inspect hybrid content and store findings to a job. To review the findings, inspect the job. Inspection will occur asynchronously. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + hybridInspect( + params: Params$Resource$Projects$Locations$Dlpjobs$Hybridinspect, + options: StreamMethodOptions + ): GaxiosPromise; + hybridInspect( + params?: Params$Resource$Projects$Locations$Dlpjobs$Hybridinspect, + options?: MethodOptions + ): GaxiosPromise; + hybridInspect( + params: Params$Resource$Projects$Locations$Dlpjobs$Hybridinspect, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + hybridInspect( + params: Params$Resource$Projects$Locations$Dlpjobs$Hybridinspect, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + hybridInspect( + params: Params$Resource$Projects$Locations$Dlpjobs$Hybridinspect, + callback: BodyResponseCallback + ): void; + hybridInspect( + callback: BodyResponseCallback + ): void; + hybridInspect( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Dlpjobs$Hybridinspect + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | GaxiosPromise + | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Dlpjobs$Hybridinspect; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Dlpjobs$Hybridinspect; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://dlp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v2/{+name}:hybridInspect').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'POST', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest( + parameters + ); + } + } + + /** + * Lists DlpJobs that match the specified filter in the request. See https://cloud.google.com/sensitive-data-protection/docs/inspecting-storage and https://cloud.google.com/sensitive-data-protection/docs/compute-risk-analysis to learn more. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + list( + params: Params$Resource$Projects$Locations$Dlpjobs$List, + options: StreamMethodOptions + ): GaxiosPromise; + list( + params?: Params$Resource$Projects$Locations$Dlpjobs$List, + options?: MethodOptions + ): GaxiosPromise; + list( + params: Params$Resource$Projects$Locations$Dlpjobs$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Dlpjobs$List, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Dlpjobs$List, + callback: BodyResponseCallback + ): void; + list( + callback: BodyResponseCallback + ): void; + list( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Dlpjobs$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | GaxiosPromise + | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Dlpjobs$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Dlpjobs$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://dlp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v2/{+parent}/dlpJobs').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['parent'], + pathParams: ['parent'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest( + parameters + ); + } + } + } + + export interface Params$Resource$Projects$Locations$Dlpjobs$Cancel + extends StandardParameters { + /** + * Required. The name of the DlpJob resource to be cancelled. + */ + name?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$GooglePrivacyDlpV2CancelDlpJobRequest; + } + export interface Params$Resource$Projects$Locations$Dlpjobs$Create + extends StandardParameters { + /** + * Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3 + */ + parent?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$GooglePrivacyDlpV2CreateDlpJobRequest; + } + export interface Params$Resource$Projects$Locations$Dlpjobs$Delete + extends StandardParameters { + /** + * Required. The name of the DlpJob resource to be deleted. + */ + name?: string; + } + export interface Params$Resource$Projects$Locations$Dlpjobs$Finish + extends StandardParameters { + /** + * Required. The name of the DlpJob resource to be finished. + */ + name?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$GooglePrivacyDlpV2FinishDlpJobRequest; + } + export interface Params$Resource$Projects$Locations$Dlpjobs$Get + extends StandardParameters { + /** + * Required. The name of the DlpJob resource. + */ + name?: string; + } + export interface Params$Resource$Projects$Locations$Dlpjobs$Hybridinspect + extends StandardParameters { + /** + * Required. Resource name of the job to execute a hybrid inspect on, for example `projects/dlp-test-project/dlpJob/53234423`. + */ + name?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$GooglePrivacyDlpV2HybridInspectDlpJobRequest; + } + export interface Params$Resource$Projects$Locations$Dlpjobs$List + extends StandardParameters { + /** + * Allows filtering. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field\} {operator\} {value\}`. * Supported fields/values for inspect jobs: - `state` - PENDING|RUNNING|CANCELED|FINISHED|FAILED - `inspected_storage` - DATASTORE|CLOUD_STORAGE|BIGQUERY - `trigger_name` - The name of the trigger that created the job. - 'end_time` - Corresponds to the time the job finished. - 'start_time` - Corresponds to the time the job finished. * Supported fields for risk analysis jobs: - `state` - RUNNING|CANCELED|FINISHED|FAILED - 'end_time` - Corresponds to the time the job finished. - 'start_time` - Corresponds to the time the job finished. * The operator must be `=` or `!=`. Examples: * inspected_storage = cloud_storage AND state = done * inspected_storage = cloud_storage OR inspected_storage = bigquery * inspected_storage = cloud_storage AND (state = done OR state = canceled) * end_time \> \"2017-12-12T00:00:00+00:00\" The length of this field should be no more than 500 characters. + */ + filter?: string; + /** + * Deprecated. This field has no effect. + */ + locationId?: string; + /** + * Comma separated list of fields to order by, followed by `asc` or `desc` postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Example: `name asc, end_time asc, create_time desc` Supported fields are: - `create_time`: corresponds to the time the job was created. - `end_time`: corresponds to the time the job ended. - `name`: corresponds to the job's name. - `state`: corresponds to `state` + */ + orderBy?: string; + /** + * The standard list page size. + */ + pageSize?: number; + /** + * The standard list page token. + */ + pageToken?: string; + /** + * Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3 + */ + parent?: string; + /** + * The type of job. Defaults to `DlpJobType.INSPECT` + */ + type?: string; + } + + export class Resource$Projects$Locations$Filestoredataprofiles { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * Delete a FileStoreDataProfile. Will not prevent the profile from being regenerated if the resource is still included in a discovery configuration. * * @param params - Parameters for request * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. * @param callback - Optional callback that handles the response. * @returns A promise if used with async/await, or void if used with a callback. */ - finish( - params: Params$Resource$Projects$Locations$Dlpjobs$Finish, + delete( + params: Params$Resource$Projects$Locations$Filestoredataprofiles$Delete, options: StreamMethodOptions ): GaxiosPromise; - finish( - params?: Params$Resource$Projects$Locations$Dlpjobs$Finish, + delete( + params?: Params$Resource$Projects$Locations$Filestoredataprofiles$Delete, options?: MethodOptions ): GaxiosPromise; - finish( - params: Params$Resource$Projects$Locations$Dlpjobs$Finish, + delete( + params: Params$Resource$Projects$Locations$Filestoredataprofiles$Delete, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - finish( - params: Params$Resource$Projects$Locations$Dlpjobs$Finish, + delete( + params: Params$Resource$Projects$Locations$Filestoredataprofiles$Delete, options: MethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - finish( - params: Params$Resource$Projects$Locations$Dlpjobs$Finish, + delete( + params: Params$Resource$Projects$Locations$Filestoredataprofiles$Delete, callback: BodyResponseCallback ): void; - finish(callback: BodyResponseCallback): void; - finish( + delete(callback: BodyResponseCallback): void; + delete( paramsOrCallback?: - | Params$Resource$Projects$Locations$Dlpjobs$Finish + | Params$Resource$Projects$Locations$Filestoredataprofiles$Delete | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: @@ -16131,12 +17133,13 @@ export namespace dlp_v2 { | GaxiosPromise | GaxiosPromise { let params = (paramsOrCallback || - {}) as Params$Resource$Projects$Locations$Dlpjobs$Finish; + {}) as Params$Resource$Projects$Locations$Filestoredataprofiles$Delete; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; - params = {} as Params$Resource$Projects$Locations$Dlpjobs$Finish; + params = + {} as Params$Resource$Projects$Locations$Filestoredataprofiles$Delete; options = {}; } @@ -16149,8 +17152,8 @@ export namespace dlp_v2 { const parameters = { options: Object.assign( { - url: (rootUrl + '/v2/{+name}:finish').replace(/([^:]\/)\/+/g, '$1'), - method: 'POST', + url: (rootUrl + '/v2/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'DELETE', apiVersion: '', }, options @@ -16171,7 +17174,7 @@ export namespace dlp_v2 { } /** - * Gets the latest state of a long-running DlpJob. See https://cloud.google.com/sensitive-data-protection/docs/inspecting-storage and https://cloud.google.com/sensitive-data-protection/docs/compute-risk-analysis to learn more. + * Gets a file store data profile. * * @param params - Parameters for request * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. @@ -16179,54 +17182,57 @@ export namespace dlp_v2 { * @returns A promise if used with async/await, or void if used with a callback. */ get( - params: Params$Resource$Projects$Locations$Dlpjobs$Get, + params: Params$Resource$Projects$Locations$Filestoredataprofiles$Get, options: StreamMethodOptions ): GaxiosPromise; get( - params?: Params$Resource$Projects$Locations$Dlpjobs$Get, + params?: Params$Resource$Projects$Locations$Filestoredataprofiles$Get, options?: MethodOptions - ): GaxiosPromise; + ): GaxiosPromise; get( - params: Params$Resource$Projects$Locations$Dlpjobs$Get, + params: Params$Resource$Projects$Locations$Filestoredataprofiles$Get, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; get( - params: Params$Resource$Projects$Locations$Dlpjobs$Get, + params: Params$Resource$Projects$Locations$Filestoredataprofiles$Get, options: | MethodOptions - | BodyResponseCallback, - callback: BodyResponseCallback + | BodyResponseCallback, + callback: BodyResponseCallback ): void; get( - params: Params$Resource$Projects$Locations$Dlpjobs$Get, - callback: BodyResponseCallback + params: Params$Resource$Projects$Locations$Filestoredataprofiles$Get, + callback: BodyResponseCallback + ): void; + get( + callback: BodyResponseCallback ): void; - get(callback: BodyResponseCallback): void; get( paramsOrCallback?: - | Params$Resource$Projects$Locations$Dlpjobs$Get - | BodyResponseCallback + | Params$Resource$Projects$Locations$Filestoredataprofiles$Get + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback ): | void - | GaxiosPromise + | GaxiosPromise | GaxiosPromise { let params = (paramsOrCallback || - {}) as Params$Resource$Projects$Locations$Dlpjobs$Get; + {}) as Params$Resource$Projects$Locations$Filestoredataprofiles$Get; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; - params = {} as Params$Resource$Projects$Locations$Dlpjobs$Get; + params = + {} as Params$Resource$Projects$Locations$Filestoredataprofiles$Get; options = {}; } @@ -16251,114 +17257,19 @@ export namespace dlp_v2 { context: this.context, }; if (callback) { - createAPIRequest( - parameters, - callback as BodyResponseCallback - ); - } else { - return createAPIRequest(parameters); - } - } - - /** - * Inspect hybrid content and store findings to a job. To review the findings, inspect the job. Inspection will occur asynchronously. - * - * @param params - Parameters for request - * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. - * @param callback - Optional callback that handles the response. - * @returns A promise if used with async/await, or void if used with a callback. - */ - hybridInspect( - params: Params$Resource$Projects$Locations$Dlpjobs$Hybridinspect, - options: StreamMethodOptions - ): GaxiosPromise; - hybridInspect( - params?: Params$Resource$Projects$Locations$Dlpjobs$Hybridinspect, - options?: MethodOptions - ): GaxiosPromise; - hybridInspect( - params: Params$Resource$Projects$Locations$Dlpjobs$Hybridinspect, - options: StreamMethodOptions | BodyResponseCallback, - callback: BodyResponseCallback - ): void; - hybridInspect( - params: Params$Resource$Projects$Locations$Dlpjobs$Hybridinspect, - options: - | MethodOptions - | BodyResponseCallback, - callback: BodyResponseCallback - ): void; - hybridInspect( - params: Params$Resource$Projects$Locations$Dlpjobs$Hybridinspect, - callback: BodyResponseCallback - ): void; - hybridInspect( - callback: BodyResponseCallback - ): void; - hybridInspect( - paramsOrCallback?: - | Params$Resource$Projects$Locations$Dlpjobs$Hybridinspect - | BodyResponseCallback - | BodyResponseCallback, - optionsOrCallback?: - | MethodOptions - | StreamMethodOptions - | BodyResponseCallback - | BodyResponseCallback, - callback?: - | BodyResponseCallback - | BodyResponseCallback - ): - | void - | GaxiosPromise - | GaxiosPromise { - let params = (paramsOrCallback || - {}) as Params$Resource$Projects$Locations$Dlpjobs$Hybridinspect; - let options = (optionsOrCallback || {}) as MethodOptions; - - if (typeof paramsOrCallback === 'function') { - callback = paramsOrCallback; - params = {} as Params$Resource$Projects$Locations$Dlpjobs$Hybridinspect; - options = {}; - } - - if (typeof optionsOrCallback === 'function') { - callback = optionsOrCallback; - options = {}; - } - - const rootUrl = options.rootUrl || 'https://dlp.googleapis.com/'; - const parameters = { - options: Object.assign( - { - url: (rootUrl + '/v2/{+name}:hybridInspect').replace( - /([^:]\/)\/+/g, - '$1' - ), - method: 'POST', - apiVersion: '', - }, - options - ), - params, - requiredParams: ['name'], - pathParams: ['name'], - context: this.context, - }; - if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest( + return createAPIRequest( parameters ); } } /** - * Lists DlpJobs that match the specified filter in the request. See https://cloud.google.com/sensitive-data-protection/docs/inspecting-storage and https://cloud.google.com/sensitive-data-protection/docs/compute-risk-analysis to learn more. + * Lists file store data profiles for an organization. * * @param params - Parameters for request * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. @@ -16366,56 +17277,57 @@ export namespace dlp_v2 { * @returns A promise if used with async/await, or void if used with a callback. */ list( - params: Params$Resource$Projects$Locations$Dlpjobs$List, + params: Params$Resource$Projects$Locations$Filestoredataprofiles$List, options: StreamMethodOptions ): GaxiosPromise; list( - params?: Params$Resource$Projects$Locations$Dlpjobs$List, + params?: Params$Resource$Projects$Locations$Filestoredataprofiles$List, options?: MethodOptions - ): GaxiosPromise; + ): GaxiosPromise; list( - params: Params$Resource$Projects$Locations$Dlpjobs$List, + params: Params$Resource$Projects$Locations$Filestoredataprofiles$List, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; list( - params: Params$Resource$Projects$Locations$Dlpjobs$List, + params: Params$Resource$Projects$Locations$Filestoredataprofiles$List, options: | MethodOptions - | BodyResponseCallback, - callback: BodyResponseCallback + | BodyResponseCallback, + callback: BodyResponseCallback ): void; list( - params: Params$Resource$Projects$Locations$Dlpjobs$List, - callback: BodyResponseCallback + params: Params$Resource$Projects$Locations$Filestoredataprofiles$List, + callback: BodyResponseCallback ): void; list( - callback: BodyResponseCallback + callback: BodyResponseCallback ): void; list( paramsOrCallback?: - | Params$Resource$Projects$Locations$Dlpjobs$List - | BodyResponseCallback + | Params$Resource$Projects$Locations$Filestoredataprofiles$List + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback ): | void - | GaxiosPromise + | GaxiosPromise | GaxiosPromise { let params = (paramsOrCallback || - {}) as Params$Resource$Projects$Locations$Dlpjobs$List; + {}) as Params$Resource$Projects$Locations$Filestoredataprofiles$List; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; - params = {} as Params$Resource$Projects$Locations$Dlpjobs$List; + params = + {} as Params$Resource$Projects$Locations$Filestoredataprofiles$List; options = {}; } @@ -16428,7 +17340,7 @@ export namespace dlp_v2 { const parameters = { options: Object.assign( { - url: (rootUrl + '/v2/{+parent}/dlpJobs').replace( + url: (rootUrl + '/v2/{+parent}/fileStoreDataProfiles').replace( /([^:]\/)\/+/g, '$1' ), @@ -16443,110 +17355,54 @@ export namespace dlp_v2 { context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest( + return createAPIRequest( parameters ); } } } - export interface Params$Resource$Projects$Locations$Dlpjobs$Cancel - extends StandardParameters { - /** - * Required. The name of the DlpJob resource to be cancelled. - */ - name?: string; - - /** - * Request body metadata - */ - requestBody?: Schema$GooglePrivacyDlpV2CancelDlpJobRequest; - } - export interface Params$Resource$Projects$Locations$Dlpjobs$Create - extends StandardParameters { - /** - * Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3 - */ - parent?: string; - - /** - * Request body metadata - */ - requestBody?: Schema$GooglePrivacyDlpV2CreateDlpJobRequest; - } - export interface Params$Resource$Projects$Locations$Dlpjobs$Delete - extends StandardParameters { - /** - * Required. The name of the DlpJob resource to be deleted. - */ - name?: string; - } - export interface Params$Resource$Projects$Locations$Dlpjobs$Finish - extends StandardParameters { - /** - * Required. The name of the DlpJob resource to be finished. - */ - name?: string; - - /** - * Request body metadata - */ - requestBody?: Schema$GooglePrivacyDlpV2FinishDlpJobRequest; - } - export interface Params$Resource$Projects$Locations$Dlpjobs$Get + export interface Params$Resource$Projects$Locations$Filestoredataprofiles$Delete extends StandardParameters { /** - * Required. The name of the DlpJob resource. + * Required. Resource name of the file store data profile. */ name?: string; } - export interface Params$Resource$Projects$Locations$Dlpjobs$Hybridinspect + export interface Params$Resource$Projects$Locations$Filestoredataprofiles$Get extends StandardParameters { /** - * Required. Resource name of the job to execute a hybrid inspect on, for example `projects/dlp-test-project/dlpJob/53234423`. + * Required. Resource name, for example `organizations/12345/locations/us/fileStoreDataProfiles/53234423`. */ name?: string; - - /** - * Request body metadata - */ - requestBody?: Schema$GooglePrivacyDlpV2HybridInspectDlpJobRequest; } - export interface Params$Resource$Projects$Locations$Dlpjobs$List + export interface Params$Resource$Projects$Locations$Filestoredataprofiles$List extends StandardParameters { /** - * Allows filtering. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field\} {operator\} {value\}`. * Supported fields/values for inspect jobs: - `state` - PENDING|RUNNING|CANCELED|FINISHED|FAILED - `inspected_storage` - DATASTORE|CLOUD_STORAGE|BIGQUERY - `trigger_name` - The name of the trigger that created the job. - 'end_time` - Corresponds to the time the job finished. - 'start_time` - Corresponds to the time the job finished. * Supported fields for risk analysis jobs: - `state` - RUNNING|CANCELED|FINISHED|FAILED - 'end_time` - Corresponds to the time the job finished. - 'start_time` - Corresponds to the time the job finished. * The operator must be `=` or `!=`. Examples: * inspected_storage = cloud_storage AND state = done * inspected_storage = cloud_storage OR inspected_storage = bigquery * inspected_storage = cloud_storage AND (state = done OR state = canceled) * end_time \> \"2017-12-12T00:00:00+00:00\" The length of this field should be no more than 500 characters. + * Optional. Allows filtering. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field\} {operator\} {value\}`. * Supported fields/values: - `project_id` - The Google Cloud project ID. - `file_store_path` - The path like "gs://bucket". - `sensitivity_level` - HIGH|MODERATE|LOW - `data_risk_level` - HIGH|MODERATE|LOW - `resource_visibility`: PUBLIC|RESTRICTED - `status_code` - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto * The operator must be `=` or `!=`. Examples: * `project_id = 12345 AND status_code = 1` * `project_id = 12345 AND sensitivity_level = HIGH` * `project_id = 12345 AND resource_visibility = PUBLIC` . * 'file_store_path = "gs://mybucket"` The length of this field should be no more than 500 characters. */ filter?: string; /** - * Deprecated. This field has no effect. - */ - locationId?: string; - /** - * Comma separated list of fields to order by, followed by `asc` or `desc` postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Example: `name asc, end_time asc, create_time desc` Supported fields are: - `create_time`: corresponds to the time the job was created. - `end_time`: corresponds to the time the job ended. - `name`: corresponds to the job's name. - `state`: corresponds to `state` + * Optional. Comma separated list of fields to order by, followed by `asc` or `desc` postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed. Examples: * `project_id asc` * `name` * `sensitivity_level desc` Supported fields are: - `project_id`: The Google Cloud project ID. - `sensitivity_level`: How sensitive the data in a table is, at most. - `data_risk_level`: How much risk is associated with this data. - `profile_last_generated`: When the profile was last updated in epoch seconds. - `last_modified`: The last time the resource was modified. - `resource_visibility`: Visibility restriction for this resource. - `name`: The name of the profile. - `create_time`: The time the file store was first created. */ orderBy?: string; /** - * The standard list page size. + * Optional. Size of the page. This value can be limited by the server. If zero, server returns a page of max size 100. */ pageSize?: number; /** - * The standard list page token. + * Optional. Page token to continue retrieval. */ pageToken?: string; /** - * Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3 + * Required. Resource name of the organization or project, for example `organizations/433245324/locations/europe` or `projects/project-id/locations/asia`. */ parent?: string; - /** - * The type of job. Defaults to `DlpJobType.INSPECT` - */ - type?: string; } export class Resource$Projects$Locations$Image { diff --git a/src/apis/firebaseappdistribution/v1alpha.ts b/src/apis/firebaseappdistribution/v1alpha.ts index e61ba3ff4e..126e6496e1 100644 --- a/src/apis/firebaseappdistribution/v1alpha.ts +++ b/src/apis/firebaseappdistribution/v1alpha.ts @@ -143,6 +143,32 @@ export namespace firebaseappdistribution_v1alpha { */ certificateHashSha256?: string | null; } + /** + * Instructions for AI driven test + */ + export interface Schema$GoogleFirebaseAppdistroV1alphaAiInstructions { + /** + * Optional. Describes the app to give the AI some context + */ + appDescription?: string | null; + /** + * Required. Steps to be accomplished by the AI + */ + steps?: Schema$GoogleFirebaseAppdistroV1alphaAiInstructionsStep[]; + } + /** + * A step to be accomplished by the AI + */ + export interface Schema$GoogleFirebaseAppdistroV1alphaAiInstructionsStep { + /** + * An assertion to be checked by the AI + */ + assertion?: string | null; + /** + * A goal to be accomplished by the AI + */ + goal?: string | null; + } export interface Schema$GoogleFirebaseAppdistroV1alphaApp { /** * App bundle test certificate generated for the app. @@ -400,6 +426,10 @@ export namespace firebaseappdistribution_v1alpha { * The results of running an automated test on a release. */ export interface Schema$GoogleFirebaseAppdistroV1alphaReleaseTest { + /** + * Optional. Input only. Instructions for AI driven test. Input only. + */ + aiInstructions?: Schema$GoogleFirebaseAppdistroV1alphaAiInstructions; /** * Output only. Timestamp when the test was run. */ @@ -421,6 +451,10 @@ export namespace firebaseappdistribution_v1alpha { * Configuration for Robo crawler */ export interface Schema$GoogleFirebaseAppdistroV1alphaRoboCrawler { + /** + * Optional. Instructions for AI driven test + */ + aiInstructions?: Schema$GoogleFirebaseAppdistroV1alphaAiInstructions; /** * Optional. Login credential for automated tests */ diff --git a/src/apis/gkehub/v1.ts b/src/apis/gkehub/v1.ts index db33c190e1..25baf1248a 100644 --- a/src/apis/gkehub/v1.ts +++ b/src/apis/gkehub/v1.ts @@ -1791,6 +1791,23 @@ export namespace gkehub_v1 { */ unreachable?: string[] | null; } + /** + * List of Membership RBACRoleBindings. + */ + export interface Schema$ListMembershipRBACRoleBindingsResponse { + /** + * A token to request the next page of resources from the `ListMembershipRBACRoleBindings` method. The value of an empty string means that there are no more resources to return. + */ + nextPageToken?: string | null; + /** + * The list of Membership RBACRoleBindings. + */ + rbacrolebindings?: Schema$RBACRoleBinding[]; + /** + * List of locations that could not be reached while fetching this list. + */ + unreachable?: string[] | null; + } /** * Response message for the `GkeHub.ListMemberships` method. */ @@ -4573,11 +4590,16 @@ export namespace gkehub_v1 { export class Resource$Projects$Locations$Memberships { context: APIRequestContext; bindings: Resource$Projects$Locations$Memberships$Bindings; + rbacrolebindings: Resource$Projects$Locations$Memberships$Rbacrolebindings; constructor(context: APIRequestContext) { this.context = context; this.bindings = new Resource$Projects$Locations$Memberships$Bindings( this.context ); + this.rbacrolebindings = + new Resource$Projects$Locations$Memberships$Rbacrolebindings( + this.context + ); } /** @@ -6062,6 +6084,127 @@ export namespace gkehub_v1 { requestBody?: Schema$MembershipBinding; } + export class Resource$Projects$Locations$Memberships$Rbacrolebindings { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * Lists all Membership RBACRoleBindings. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + list( + params: Params$Resource$Projects$Locations$Memberships$Rbacrolebindings$List, + options: StreamMethodOptions + ): GaxiosPromise; + list( + params?: Params$Resource$Projects$Locations$Memberships$Rbacrolebindings$List, + options?: MethodOptions + ): GaxiosPromise; + list( + params: Params$Resource$Projects$Locations$Memberships$Rbacrolebindings$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Memberships$Rbacrolebindings$List, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Memberships$Rbacrolebindings$List, + callback: BodyResponseCallback + ): void; + list( + callback: BodyResponseCallback + ): void; + list( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Memberships$Rbacrolebindings$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | GaxiosPromise + | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Memberships$Rbacrolebindings$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Memberships$Rbacrolebindings$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://gkehub.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+parent}/rbacrolebindings').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['parent'], + pathParams: ['parent'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest( + parameters + ); + } + } + } + + export interface Params$Resource$Projects$Locations$Memberships$Rbacrolebindings$List + extends StandardParameters { + /** + * Optional. When requesting a 'page' of resources, `page_size` specifies number of resources to return. If unspecified or set to 0, all resources will be returned. + */ + pageSize?: number; + /** + * Optional. Token returned by previous call to `ListMembershipRBACRoleBindings` which specifies the position in the list from where to continue listing the resources. + */ + pageToken?: string; + /** + * Required. The parent (project and location) where the Features will be listed. Specified in the format `projects/x/locations/x/memberships/x`. + */ + parent?: string; + } + export class Resource$Projects$Locations$Operations { context: APIRequestContext; constructor(context: APIRequestContext) { diff --git a/src/apis/healthcare/v1.ts b/src/apis/healthcare/v1.ts index 7da8a88553..18d264d676 100644 --- a/src/apis/healthcare/v1.ts +++ b/src/apis/healthcare/v1.ts @@ -1665,7 +1665,7 @@ export namespace healthcare_v1 { */ messageType?: string | null; /** - * Output only. Resource name of the Message, of the form `projects/{project_id\}/locations/{location_id\}/datasets/{dataset_id\}/hl7V2Stores/{hl7_v2_store_id\}/messages/{message_id\}`. Assigned by the server. + * Output only. Resource name of the Message, of the form `projects/{project_id\}/locations/{location_id\}/datasets/{dataset_id\}/hl7V2Stores/{hl7_v2_store_id\}/messages/{message_id\}`. */ name?: string | null; /** @@ -15893,7 +15893,7 @@ export namespace healthcare_v1 { export interface Params$Resource$Projects$Locations$Datasets$Hl7v2stores$Messages$Patch extends StandardParameters { /** - * Output only. Resource name of the Message, of the form `projects/{project_id\}/locations/{location_id\}/datasets/{dataset_id\}/hl7V2Stores/{hl7_v2_store_id\}/messages/{message_id\}`. Assigned by the server. + * Output only. Resource name of the Message, of the form `projects/{project_id\}/locations/{location_id\}/datasets/{dataset_id\}/hl7V2Stores/{hl7_v2_store_id\}/messages/{message_id\}`. */ name?: string; /** diff --git a/src/apis/healthcare/v1beta1.ts b/src/apis/healthcare/v1beta1.ts index 5876aa8b3d..c906008d7f 100644 --- a/src/apis/healthcare/v1beta1.ts +++ b/src/apis/healthcare/v1beta1.ts @@ -3090,7 +3090,7 @@ export namespace healthcare_v1beta1 { */ blobStorageInfo?: Schema$BlobStorageInfo; /** - * The resource whose storage info is returned. For example, to specify the resource path of a DICOM Instance: `projects/{projectID\}/locations/{locationID\}/datasets/{datasetID\}/dicomStores/{dicom_store_id\}/dicomWeb/studi/{study_uid\}/series/{series_uid\}/instances/{instance_uid\}` + * The resource whose storage info is returned. For example: `projects/{projectID\}/locations/{locationID\}/datasets/{datasetID\}/dicomStores/{dicomStoreID\}/dicomWeb/studies/{studyUID\}/series/{seriesUID\}/instances/{instanceUID\}` */ referencedResource?: string | null; /** @@ -12388,7 +12388,7 @@ export namespace healthcare_v1beta1 { export interface Params$Resource$Projects$Locations$Datasets$Dicomstores$Dicomweb$Studies$Series$Instances$Getstorageinfo extends StandardParameters { /** - * Required. The path of the resource for which the storage info is requested (for exaxmple for a DICOM Instance: `projects/{projectID\}/locations/{locationID\}/datasets/{datasetID\}/dicomStores/{dicomStoreId\}/dicomWeb/studies/{study_uid\}/series/{series_uid\}/instances/{instance_uid\}`) + * Required. The path of the instance to return storage info for, in the form: `projects/{projectID\}/locations/{locationID\}/datasets/{datasetID\}/dicomStores/{dicomStoreID\}/dicomWeb/studies/{studyUID\}/series/{seriesUID\}/instances/{instanceUID\}` */ resource?: string; } diff --git a/src/apis/logging/v2.ts b/src/apis/logging/v2.ts index 56af8d8925..d21ad773e6 100644 --- a/src/apis/logging/v2.ts +++ b/src/apis/logging/v2.ts @@ -498,11 +498,11 @@ export namespace logging_v2 { */ cacheValidatedWithOriginServer?: boolean | null; /** - * The request processing latency on the server, from the time the request was received until the response was sent. + * The request processing latency on the server, from the time the request was received until the response was sent. For WebSocket connections, this field refers to the entire time duration of the connection. */ latency?: string | null; /** - * Protocol used for the request. Examples: "HTTP/1.1", "HTTP/2", "websocket" + * Protocol used for the request. Examples: "HTTP/1.1", "HTTP/2" */ protocol?: string | null; /** @@ -5088,6 +5088,10 @@ export namespace logging_v2 { export interface Params$Resource$Billingaccounts$Locations$Recentqueries$List extends StandardParameters { + /** + * Optional. Specifies the type ("Logging" or "OpsAnalytics") of the recent queries to list. The only valid value for this field is one of the two allowable type function calls, which are the following: type("Logging") type("OpsAnalytics") + */ + filter?: string; /** * Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available. */ @@ -5283,6 +5287,92 @@ export namespace logging_v2 { } } + /** + * Returns all data associated with the requested query. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + get( + params: Params$Resource$Billingaccounts$Locations$Savedqueries$Get, + options: StreamMethodOptions + ): GaxiosPromise; + get( + params?: Params$Resource$Billingaccounts$Locations$Savedqueries$Get, + options?: MethodOptions + ): GaxiosPromise; + get( + params: Params$Resource$Billingaccounts$Locations$Savedqueries$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Billingaccounts$Locations$Savedqueries$Get, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Billingaccounts$Locations$Savedqueries$Get, + callback: BodyResponseCallback + ): void; + get(callback: BodyResponseCallback): void; + get( + paramsOrCallback?: + | Params$Resource$Billingaccounts$Locations$Savedqueries$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): void | GaxiosPromise | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Billingaccounts$Locations$Savedqueries$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Billingaccounts$Locations$Savedqueries$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://logging.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v2/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + /** * Lists the SavedQueries that were created by the user making the request. * @@ -5376,6 +5466,92 @@ export namespace logging_v2 { return createAPIRequest(parameters); } } + + /** + * Updates an existing SavedQuery. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + patch( + params: Params$Resource$Billingaccounts$Locations$Savedqueries$Patch, + options: StreamMethodOptions + ): GaxiosPromise; + patch( + params?: Params$Resource$Billingaccounts$Locations$Savedqueries$Patch, + options?: MethodOptions + ): GaxiosPromise; + patch( + params: Params$Resource$Billingaccounts$Locations$Savedqueries$Patch, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Billingaccounts$Locations$Savedqueries$Patch, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Billingaccounts$Locations$Savedqueries$Patch, + callback: BodyResponseCallback + ): void; + patch(callback: BodyResponseCallback): void; + patch( + paramsOrCallback?: + | Params$Resource$Billingaccounts$Locations$Savedqueries$Patch + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): void | GaxiosPromise | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Billingaccounts$Locations$Savedqueries$Patch; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Billingaccounts$Locations$Savedqueries$Patch; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://logging.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v2/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'PATCH', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } } export interface Params$Resource$Billingaccounts$Locations$Savedqueries$Create @@ -5401,6 +5577,13 @@ export namespace logging_v2 { */ name?: string; } + export interface Params$Resource$Billingaccounts$Locations$Savedqueries$Get + extends StandardParameters { + /** + * Required. The resource name of the saved query. "projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" For example: "projects/my-project/locations/global/savedQueries/my-saved-query" + */ + name?: string; + } export interface Params$Resource$Billingaccounts$Locations$Savedqueries$List extends StandardParameters { /** @@ -5416,6 +5599,22 @@ export namespace logging_v2 { */ parent?: string; } + export interface Params$Resource$Billingaccounts$Locations$Savedqueries$Patch + extends StandardParameters { + /** + * Output only. Resource name of the saved query.In the format: "projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" For a list of supported locations, see Supported Regions (https://cloud.google.com/logging/docs/region-support#bucket-regions)After the saved query is created, the location cannot be changed.If the user doesn't provide a QUERY_ID, the system will generate an alphanumeric ID. + */ + name?: string; + /** + * Required. A non-empty list of fields to change in the existing saved query. Fields are relative to the saved_query and new values for the fields are taken from the corresponding fields in the SavedQuery included in this request. Fields not mentioned in update_mask are not changed and are ignored in the request.To update all mutable fields, specify an update_mask of *.For example, to change the description and query filter text of a saved query, specify an update_mask of "description, query.filter". + */ + updateMask?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$SavedQuery; + } export class Resource$Billingaccounts$Logs { context: APIRequestContext; @@ -6150,7 +6349,7 @@ export namespace logging_v2 { export interface Params$Resource$Billingaccounts$Sinks$Create extends StandardParameters { /** - * Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated. + * Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated. */ customWriterIdentity?: string; /** @@ -6203,7 +6402,7 @@ export namespace logging_v2 { export interface Params$Resource$Billingaccounts$Sinks$Patch extends StandardParameters { /** - * Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated. + * Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated. */ customWriterIdentity?: string; /** @@ -6227,7 +6426,7 @@ export namespace logging_v2 { export interface Params$Resource$Billingaccounts$Sinks$Update extends StandardParameters { /** - * Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated. + * Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated. */ customWriterIdentity?: string; /** @@ -10722,6 +10921,10 @@ export namespace logging_v2 { export interface Params$Resource$Folders$Locations$Recentqueries$List extends StandardParameters { + /** + * Optional. Specifies the type ("Logging" or "OpsAnalytics") of the recent queries to list. The only valid value for this field is one of the two allowable type function calls, which are the following: type("Logging") type("OpsAnalytics") + */ + filter?: string; /** * Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available. */ @@ -10915,6 +11118,91 @@ export namespace logging_v2 { } } + /** + * Returns all data associated with the requested query. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + get( + params: Params$Resource$Folders$Locations$Savedqueries$Get, + options: StreamMethodOptions + ): GaxiosPromise; + get( + params?: Params$Resource$Folders$Locations$Savedqueries$Get, + options?: MethodOptions + ): GaxiosPromise; + get( + params: Params$Resource$Folders$Locations$Savedqueries$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Folders$Locations$Savedqueries$Get, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Folders$Locations$Savedqueries$Get, + callback: BodyResponseCallback + ): void; + get(callback: BodyResponseCallback): void; + get( + paramsOrCallback?: + | Params$Resource$Folders$Locations$Savedqueries$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): void | GaxiosPromise | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Folders$Locations$Savedqueries$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Folders$Locations$Savedqueries$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://logging.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v2/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + /** * Lists the SavedQueries that were created by the user making the request. * @@ -11007,12 +11295,97 @@ export namespace logging_v2 { return createAPIRequest(parameters); } } - } - export interface Params$Resource$Folders$Locations$Savedqueries$Create - extends StandardParameters { /** - * Required. The parent resource in which to create the saved query: "projects/[PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]" For example: "projects/my-project/locations/global" "organizations/123456789/locations/us-central1" + * Updates an existing SavedQuery. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + patch( + params: Params$Resource$Folders$Locations$Savedqueries$Patch, + options: StreamMethodOptions + ): GaxiosPromise; + patch( + params?: Params$Resource$Folders$Locations$Savedqueries$Patch, + options?: MethodOptions + ): GaxiosPromise; + patch( + params: Params$Resource$Folders$Locations$Savedqueries$Patch, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Folders$Locations$Savedqueries$Patch, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Folders$Locations$Savedqueries$Patch, + callback: BodyResponseCallback + ): void; + patch(callback: BodyResponseCallback): void; + patch( + paramsOrCallback?: + | Params$Resource$Folders$Locations$Savedqueries$Patch + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): void | GaxiosPromise | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Folders$Locations$Savedqueries$Patch; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Folders$Locations$Savedqueries$Patch; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://logging.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v2/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'PATCH', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + } + + export interface Params$Resource$Folders$Locations$Savedqueries$Create + extends StandardParameters { + /** + * Required. The parent resource in which to create the saved query: "projects/[PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]" For example: "projects/my-project/locations/global" "organizations/123456789/locations/us-central1" */ parent?: string; /** @@ -11032,6 +11405,13 @@ export namespace logging_v2 { */ name?: string; } + export interface Params$Resource$Folders$Locations$Savedqueries$Get + extends StandardParameters { + /** + * Required. The resource name of the saved query. "projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" For example: "projects/my-project/locations/global/savedQueries/my-saved-query" + */ + name?: string; + } export interface Params$Resource$Folders$Locations$Savedqueries$List extends StandardParameters { /** @@ -11047,6 +11427,22 @@ export namespace logging_v2 { */ parent?: string; } + export interface Params$Resource$Folders$Locations$Savedqueries$Patch + extends StandardParameters { + /** + * Output only. Resource name of the saved query.In the format: "projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" For a list of supported locations, see Supported Regions (https://cloud.google.com/logging/docs/region-support#bucket-regions)After the saved query is created, the location cannot be changed.If the user doesn't provide a QUERY_ID, the system will generate an alphanumeric ID. + */ + name?: string; + /** + * Required. A non-empty list of fields to change in the existing saved query. Fields are relative to the saved_query and new values for the fields are taken from the corresponding fields in the SavedQuery included in this request. Fields not mentioned in update_mask are not changed and are ignored in the request.To update all mutable fields, specify an update_mask of *.For example, to change the description and query filter text of a saved query, specify an update_mask of "description, query.filter". + */ + updateMask?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$SavedQuery; + } export class Resource$Folders$Logs { context: APIRequestContext; @@ -11781,7 +12177,7 @@ export namespace logging_v2 { export interface Params$Resource$Folders$Sinks$Create extends StandardParameters { /** - * Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated. + * Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated. */ customWriterIdentity?: string; /** @@ -11834,7 +12230,7 @@ export namespace logging_v2 { export interface Params$Resource$Folders$Sinks$Patch extends StandardParameters { /** - * Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated. + * Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated. */ customWriterIdentity?: string; /** @@ -11858,7 +12254,7 @@ export namespace logging_v2 { export interface Params$Resource$Folders$Sinks$Update extends StandardParameters { /** - * Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated. + * Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated. */ customWriterIdentity?: string; /** @@ -18465,6 +18861,10 @@ export namespace logging_v2 { export interface Params$Resource$Organizations$Locations$Recentqueries$List extends StandardParameters { + /** + * Optional. Specifies the type ("Logging" or "OpsAnalytics") of the recent queries to list. The only valid value for this field is one of the two allowable type function calls, which are the following: type("Logging") type("OpsAnalytics") + */ + filter?: string; /** * Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available. */ @@ -18660,6 +19060,91 @@ export namespace logging_v2 { } } + /** + * Returns all data associated with the requested query. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + get( + params: Params$Resource$Organizations$Locations$Savedqueries$Get, + options: StreamMethodOptions + ): GaxiosPromise; + get( + params?: Params$Resource$Organizations$Locations$Savedqueries$Get, + options?: MethodOptions + ): GaxiosPromise; + get( + params: Params$Resource$Organizations$Locations$Savedqueries$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Organizations$Locations$Savedqueries$Get, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Organizations$Locations$Savedqueries$Get, + callback: BodyResponseCallback + ): void; + get(callback: BodyResponseCallback): void; + get( + paramsOrCallback?: + | Params$Resource$Organizations$Locations$Savedqueries$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): void | GaxiosPromise | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Organizations$Locations$Savedqueries$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Organizations$Locations$Savedqueries$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://logging.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v2/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + /** * Lists the SavedQueries that were created by the user making the request. * @@ -18753,6 +19238,92 @@ export namespace logging_v2 { return createAPIRequest(parameters); } } + + /** + * Updates an existing SavedQuery. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + patch( + params: Params$Resource$Organizations$Locations$Savedqueries$Patch, + options: StreamMethodOptions + ): GaxiosPromise; + patch( + params?: Params$Resource$Organizations$Locations$Savedqueries$Patch, + options?: MethodOptions + ): GaxiosPromise; + patch( + params: Params$Resource$Organizations$Locations$Savedqueries$Patch, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Organizations$Locations$Savedqueries$Patch, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Organizations$Locations$Savedqueries$Patch, + callback: BodyResponseCallback + ): void; + patch(callback: BodyResponseCallback): void; + patch( + paramsOrCallback?: + | Params$Resource$Organizations$Locations$Savedqueries$Patch + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): void | GaxiosPromise | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Organizations$Locations$Savedqueries$Patch; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Organizations$Locations$Savedqueries$Patch; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://logging.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v2/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'PATCH', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } } export interface Params$Resource$Organizations$Locations$Savedqueries$Create @@ -18778,6 +19349,13 @@ export namespace logging_v2 { */ name?: string; } + export interface Params$Resource$Organizations$Locations$Savedqueries$Get + extends StandardParameters { + /** + * Required. The resource name of the saved query. "projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" For example: "projects/my-project/locations/global/savedQueries/my-saved-query" + */ + name?: string; + } export interface Params$Resource$Organizations$Locations$Savedqueries$List extends StandardParameters { /** @@ -18793,6 +19371,22 @@ export namespace logging_v2 { */ parent?: string; } + export interface Params$Resource$Organizations$Locations$Savedqueries$Patch + extends StandardParameters { + /** + * Output only. Resource name of the saved query.In the format: "projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" For a list of supported locations, see Supported Regions (https://cloud.google.com/logging/docs/region-support#bucket-regions)After the saved query is created, the location cannot be changed.If the user doesn't provide a QUERY_ID, the system will generate an alphanumeric ID. + */ + name?: string; + /** + * Required. A non-empty list of fields to change in the existing saved query. Fields are relative to the saved_query and new values for the fields are taken from the corresponding fields in the SavedQuery included in this request. Fields not mentioned in update_mask are not changed and are ignored in the request.To update all mutable fields, specify an update_mask of *.For example, to change the description and query filter text of a saved query, specify an update_mask of "description, query.filter". + */ + updateMask?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$SavedQuery; + } export class Resource$Organizations$Logs { context: APIRequestContext; @@ -19527,7 +20121,7 @@ export namespace logging_v2 { export interface Params$Resource$Organizations$Sinks$Create extends StandardParameters { /** - * Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated. + * Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated. */ customWriterIdentity?: string; /** @@ -19580,7 +20174,7 @@ export namespace logging_v2 { export interface Params$Resource$Organizations$Sinks$Patch extends StandardParameters { /** - * Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated. + * Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated. */ customWriterIdentity?: string; /** @@ -19604,7 +20198,7 @@ export namespace logging_v2 { export interface Params$Resource$Organizations$Sinks$Update extends StandardParameters { /** - * Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated. + * Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated. */ customWriterIdentity?: string; /** @@ -23121,6 +23715,10 @@ export namespace logging_v2 { export interface Params$Resource$Projects$Locations$Recentqueries$List extends StandardParameters { + /** + * Optional. Specifies the type ("Logging" or "OpsAnalytics") of the recent queries to list. The only valid value for this field is one of the two allowable type function calls, which are the following: type("Logging") type("OpsAnalytics") + */ + filter?: string; /** * Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available. */ @@ -23314,6 +23912,91 @@ export namespace logging_v2 { } } + /** + * Returns all data associated with the requested query. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + get( + params: Params$Resource$Projects$Locations$Savedqueries$Get, + options: StreamMethodOptions + ): GaxiosPromise; + get( + params?: Params$Resource$Projects$Locations$Savedqueries$Get, + options?: MethodOptions + ): GaxiosPromise; + get( + params: Params$Resource$Projects$Locations$Savedqueries$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Savedqueries$Get, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Savedqueries$Get, + callback: BodyResponseCallback + ): void; + get(callback: BodyResponseCallback): void; + get( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Savedqueries$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): void | GaxiosPromise | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Savedqueries$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Savedqueries$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://logging.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v2/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + /** * Lists the SavedQueries that were created by the user making the request. * @@ -23406,6 +24089,91 @@ export namespace logging_v2 { return createAPIRequest(parameters); } } + + /** + * Updates an existing SavedQuery. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + patch( + params: Params$Resource$Projects$Locations$Savedqueries$Patch, + options: StreamMethodOptions + ): GaxiosPromise; + patch( + params?: Params$Resource$Projects$Locations$Savedqueries$Patch, + options?: MethodOptions + ): GaxiosPromise; + patch( + params: Params$Resource$Projects$Locations$Savedqueries$Patch, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Projects$Locations$Savedqueries$Patch, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Projects$Locations$Savedqueries$Patch, + callback: BodyResponseCallback + ): void; + patch(callback: BodyResponseCallback): void; + patch( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Savedqueries$Patch + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): void | GaxiosPromise | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Savedqueries$Patch; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Savedqueries$Patch; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://logging.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v2/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'PATCH', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } } export interface Params$Resource$Projects$Locations$Savedqueries$Create @@ -23431,6 +24199,13 @@ export namespace logging_v2 { */ name?: string; } + export interface Params$Resource$Projects$Locations$Savedqueries$Get + extends StandardParameters { + /** + * Required. The resource name of the saved query. "projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" For example: "projects/my-project/locations/global/savedQueries/my-saved-query" + */ + name?: string; + } export interface Params$Resource$Projects$Locations$Savedqueries$List extends StandardParameters { /** @@ -23446,6 +24221,22 @@ export namespace logging_v2 { */ parent?: string; } + export interface Params$Resource$Projects$Locations$Savedqueries$Patch + extends StandardParameters { + /** + * Output only. Resource name of the saved query.In the format: "projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" For a list of supported locations, see Supported Regions (https://cloud.google.com/logging/docs/region-support#bucket-regions)After the saved query is created, the location cannot be changed.If the user doesn't provide a QUERY_ID, the system will generate an alphanumeric ID. + */ + name?: string; + /** + * Required. A non-empty list of fields to change in the existing saved query. Fields are relative to the saved_query and new values for the fields are taken from the corresponding fields in the SavedQuery included in this request. Fields not mentioned in update_mask are not changed and are ignored in the request.To update all mutable fields, specify an update_mask of *.For example, to change the description and query filter text of a saved query, specify an update_mask of "description, query.filter". + */ + updateMask?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$SavedQuery; + } export class Resource$Projects$Logs { context: APIRequestContext; @@ -24677,7 +25468,7 @@ export namespace logging_v2 { export interface Params$Resource$Projects$Sinks$Create extends StandardParameters { /** - * Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated. + * Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated. */ customWriterIdentity?: string; /** @@ -24730,7 +25521,7 @@ export namespace logging_v2 { export interface Params$Resource$Projects$Sinks$Patch extends StandardParameters { /** - * Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated. + * Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated. */ customWriterIdentity?: string; /** @@ -24754,7 +25545,7 @@ export namespace logging_v2 { export interface Params$Resource$Projects$Sinks$Update extends StandardParameters { /** - * Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated. + * Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated. */ customWriterIdentity?: string; /** @@ -25214,7 +26005,7 @@ export namespace logging_v2 { export interface Params$Resource$Sinks$Create extends StandardParameters { /** - * Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated. + * Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated. */ customWriterIdentity?: string; /** @@ -25263,7 +26054,7 @@ export namespace logging_v2 { } export interface Params$Resource$Sinks$Update extends StandardParameters { /** - * Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated. + * Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated. */ customWriterIdentity?: string; /** diff --git a/src/apis/meet/v2.ts b/src/apis/meet/v2.ts index 5866d719fd..cf765e1b28 100644 --- a/src/apis/meet/v2.ts +++ b/src/apis/meet/v2.ts @@ -680,7 +680,7 @@ export namespace meet_v2 { export interface Params$Resource$Conferencerecords$List extends StandardParameters { /** - * Optional. User specified filtering condition in [EBNF format](https://en.wikipedia.org/wiki/Extended_Backus%E2%80%93Naur_form). The following are the filterable fields: * `space.meeting_code` * `space.name` * `start_time` * `end_time` For example, `space.meeting_code = "abc-mnop-xyz"`. + * Optional. User specified filtering condition in [EBNF format](https://en.wikipedia.org/wiki/Extended_Backus%E2%80%93Naur_form). The following are the filterable fields: * `space.meeting_code` * `space.name` * `start_time` * `end_time` For example, consider the following filters: * `space.name = "spaces/NAME"` * `space.meeting_code = "abc-mnop-xyz"` * `start_time\>="2024-01-01T00:00:00.000Z" AND start_time<="2024-01-02T00:00:00.000Z"` * `end_time IS NULL` */ filter?: string; /** diff --git a/src/apis/pubsub/v1.ts b/src/apis/pubsub/v1.ts index c7c9ccf808..6096aca179 100644 --- a/src/apis/pubsub/v1.ts +++ b/src/apis/pubsub/v1.ts @@ -133,6 +133,19 @@ export namespace pubsub_v1 { */ ackIds?: string[] | null; } + /** + * Information about an associated Analytics Hub subscription (https://cloud.google.com/bigquery/docs/analytics-hub-manage-subscriptions). + */ + export interface Schema$AnalyticsHubSubscriptionInfo { + /** + * Optional. The name of the associated Analytics Hub listing resource. Pattern: "projects/{project\}/locations/{location\}/dataExchanges/{data_exchange\}/listings/{listing\}" + */ + listing?: string | null; + /** + * Optional. The name of the associated Analytics Hub subscription resource. Pattern: "projects/{project\}/locations/{location\}/subscriptions/{subscription\}" + */ + subscription?: string | null; + } /** * Configuration for writing message data in Avro format. Message payloads and metadata will be written to files as an Avro binary. */ @@ -747,6 +760,10 @@ export namespace pubsub_v1 { * Optional. The approximate amount of time (on a best-effort basis) Pub/Sub waits for the subscriber to acknowledge receipt before resending the message. In the interval after the message is delivered and before it is acknowledged, it is considered to be _outstanding_. During that time period, the message will not be redelivered (on a best-effort basis). For pull subscriptions, this value is used as the initial value for the ack deadline. To override this value for a given message, call `ModifyAckDeadline` with the corresponding `ack_id` if using non-streaming pull or send the `ack_id` in a `StreamingModifyAckDeadlineRequest` if using streaming pull. The minimum custom deadline you can specify is 10 seconds. The maximum custom deadline you can specify is 600 seconds (10 minutes). If this parameter is 0, a default value of 10 seconds is used. For push delivery, this value is also used to set the request timeout for the call to the push endpoint. If the subscriber never acknowledges the message, the Pub/Sub system will eventually redeliver the message. */ ackDeadlineSeconds?: number | null; + /** + * Output only. Information about the associated Analytics Hub subscription. Only set if the subscritpion is created by Analytics Hub. + */ + analyticsHubSubscriptionInfo?: Schema$AnalyticsHubSubscriptionInfo; /** * Optional. If delivery to BigQuery is used with this subscription, this field is used to configure it. */ diff --git a/src/apis/servicenetworking/v1.ts b/src/apis/servicenetworking/v1.ts index 3910c3c3a3..7bf0a864f5 100644 --- a/src/apis/servicenetworking/v1.ts +++ b/src/apis/servicenetworking/v1.ts @@ -813,7 +813,7 @@ export namespace servicenetworking_v1 { producerPrivateZone?: Schema$DnsZone; } /** - * `Documentation` provides the information for describing a service. Example: documentation: summary: \> The Google Calendar API gives access to most calendar features. pages: - name: Overview content: (== include google/foo/overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==) subpages: - name: Java content: (== include google/foo/tutorial_java.md ==) rules: - selector: google.calendar.Calendar.Get description: \> ... - selector: google.calendar.Calendar.Put description: \> ... Documentation is provided in markdown syntax. In addition to standard markdown features, definition lists, tables and fenced code blocks are supported. Section headers can be provided and are interpreted relative to the section nesting of the context where a documentation fragment is embedded. Documentation from the IDL is merged with documentation defined via the config at normalization time, where documentation provided by config rules overrides IDL provided. A number of constructs specific to the API platform are supported in documentation text. In order to reference a proto element, the following notation can be used: [fully.qualified.proto.name][] To override the display text used for the link, this can be used: [display text][fully.qualified.proto.name] Text can be excluded from doc using the following notation: (-- internal comment --) A few directives are available in documentation. Note that directives must appear on a single line to be properly identified. The `include` directive includes a markdown file from an external source: (== include path/to/file ==) The `resource_for` directive marks a message to be the resource of a collection in REST view. If it is not specified, tools attempt to infer the resource from the operations in a collection: (== resource_for v1.shelves.books ==) The directive `suppress_warning` does not directly affect documentation and is documented together with service config validation. + * `Documentation` provides the information for describing a service. Example: documentation: summary: \> The Google Calendar API gives access to most calendar features. pages: - name: Overview content: (== include google/foo/overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==) subpages: - name: Java content: (== include google/foo/tutorial_java.md ==) rules: - selector: google.calendar.Calendar.Get description: \> ... - selector: google.calendar.Calendar.Put description: \> ... code_snippet_rules: - selector: google.calendar.Calendar.Delete code_snippets: - includes: - github_include: region_tag: calendar_delete code_language: JAVA account: GoogleCloudPlatform project: java-docs-samples file: calendar/delete.java Documentation is provided in markdown syntax. In addition to standard markdown features, definition lists, tables and fenced code blocks are supported. Section headers can be provided and are interpreted relative to the section nesting of the context where a documentation fragment is embedded. Documentation from the IDL is merged with documentation defined via the config at normalization time, where documentation provided by config rules overrides IDL provided. A number of constructs specific to the API platform are supported in documentation text. In order to reference a proto element, the following notation can be used: [fully.qualified.proto.name][] To override the display text used for the link, this can be used: [display text][fully.qualified.proto.name] Text can be excluded from doc using the following notation: (-- internal comment --) A few directives are available in documentation. Note that directives must appear on a single line to be properly identified. The `include` directive includes a markdown file from an external source: (== include path/to/file ==) The `resource_for` directive marks a message to be the resource of a collection in REST view. If it is not specified, tools attempt to infer the resource from the operations in a collection: (== resource_for v1.shelves.books ==) The directive `suppress_warning` does not directly affect documentation and is documented together with service config validation. */ export interface Schema$Documentation { /** diff --git a/src/apis/servicenetworking/v1beta.ts b/src/apis/servicenetworking/v1beta.ts index 9444044102..b4767ebdac 100644 --- a/src/apis/servicenetworking/v1beta.ts +++ b/src/apis/servicenetworking/v1beta.ts @@ -678,7 +678,7 @@ export namespace servicenetworking_v1beta { name?: string | null; } /** - * `Documentation` provides the information for describing a service. Example: documentation: summary: \> The Google Calendar API gives access to most calendar features. pages: - name: Overview content: (== include google/foo/overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==) subpages: - name: Java content: (== include google/foo/tutorial_java.md ==) rules: - selector: google.calendar.Calendar.Get description: \> ... - selector: google.calendar.Calendar.Put description: \> ... Documentation is provided in markdown syntax. In addition to standard markdown features, definition lists, tables and fenced code blocks are supported. Section headers can be provided and are interpreted relative to the section nesting of the context where a documentation fragment is embedded. Documentation from the IDL is merged with documentation defined via the config at normalization time, where documentation provided by config rules overrides IDL provided. A number of constructs specific to the API platform are supported in documentation text. In order to reference a proto element, the following notation can be used: [fully.qualified.proto.name][] To override the display text used for the link, this can be used: [display text][fully.qualified.proto.name] Text can be excluded from doc using the following notation: (-- internal comment --) A few directives are available in documentation. Note that directives must appear on a single line to be properly identified. The `include` directive includes a markdown file from an external source: (== include path/to/file ==) The `resource_for` directive marks a message to be the resource of a collection in REST view. If it is not specified, tools attempt to infer the resource from the operations in a collection: (== resource_for v1.shelves.books ==) The directive `suppress_warning` does not directly affect documentation and is documented together with service config validation. + * `Documentation` provides the information for describing a service. Example: documentation: summary: \> The Google Calendar API gives access to most calendar features. pages: - name: Overview content: (== include google/foo/overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==) subpages: - name: Java content: (== include google/foo/tutorial_java.md ==) rules: - selector: google.calendar.Calendar.Get description: \> ... - selector: google.calendar.Calendar.Put description: \> ... code_snippet_rules: - selector: google.calendar.Calendar.Delete code_snippets: - includes: - github_include: region_tag: calendar_delete code_language: JAVA account: GoogleCloudPlatform project: java-docs-samples file: calendar/delete.java Documentation is provided in markdown syntax. In addition to standard markdown features, definition lists, tables and fenced code blocks are supported. Section headers can be provided and are interpreted relative to the section nesting of the context where a documentation fragment is embedded. Documentation from the IDL is merged with documentation defined via the config at normalization time, where documentation provided by config rules overrides IDL provided. A number of constructs specific to the API platform are supported in documentation text. In order to reference a proto element, the following notation can be used: [fully.qualified.proto.name][] To override the display text used for the link, this can be used: [display text][fully.qualified.proto.name] Text can be excluded from doc using the following notation: (-- internal comment --) A few directives are available in documentation. Note that directives must appear on a single line to be properly identified. The `include` directive includes a markdown file from an external source: (== include path/to/file ==) The `resource_for` directive marks a message to be the resource of a collection in REST view. If it is not specified, tools attempt to infer the resource from the operations in a collection: (== resource_for v1.shelves.books ==) The directive `suppress_warning` does not directly affect documentation and is documented together with service config validation. */ export interface Schema$Documentation { /** diff --git a/src/apis/sqladmin/v1.ts b/src/apis/sqladmin/v1.ts index eb99174933..a703e2eb92 100644 --- a/src/apis/sqladmin/v1.ts +++ b/src/apis/sqladmin/v1.ts @@ -916,6 +916,7 @@ export namespace sqladmin_v1 { sqlExportOptions?: { mysqlExportOptions?: {masterData?: number}; parallel?: boolean; + postgresExportOptions?: {clean?: boolean; ifExists?: boolean}; schemaOnly?: boolean; tables?: string[]; threads?: number; @@ -1105,7 +1106,11 @@ export namespace sqladmin_v1 { /** * Optional. Options for importing data from SQL statements. */ - sqlImportOptions?: {parallel?: boolean; threads?: number} | null; + sqlImportOptions?: { + parallel?: boolean; + postgresImportOptions?: {clean?: boolean; ifExists?: boolean}; + threads?: number; + } | null; /** * Path to the import file in Cloud Storage, in the form `gs://bucketName/fileName`. Compressed gzip files (.gz) are supported when `fileType` is `SQL`. The instance must have write permissions to the bucket and read access to the file. */ diff --git a/src/apis/sqladmin/v1beta4.ts b/src/apis/sqladmin/v1beta4.ts index 4bec6e3de5..907bf7464a 100644 --- a/src/apis/sqladmin/v1beta4.ts +++ b/src/apis/sqladmin/v1beta4.ts @@ -919,6 +919,7 @@ export namespace sqladmin_v1beta4 { sqlExportOptions?: { mysqlExportOptions?: {masterData?: number}; parallel?: boolean; + postgresExportOptions?: {clean?: boolean; ifExists?: boolean}; schemaOnly?: boolean; tables?: string[]; threads?: number; @@ -1108,7 +1109,11 @@ export namespace sqladmin_v1beta4 { /** * Optional. Options for importing data from SQL statements. */ - sqlImportOptions?: {parallel?: boolean; threads?: number} | null; + sqlImportOptions?: { + parallel?: boolean; + postgresImportOptions?: {clean?: boolean; ifExists?: boolean}; + threads?: number; + } | null; /** * Path to the import file in Cloud Storage, in the form `gs://bucketName/fileName`. Compressed gzip files (.gz) are supported when `fileType` is `SQL`. The instance must have write permissions to the bucket and read access to the file. */ diff --git a/src/apis/walletobjects/v1.ts b/src/apis/walletobjects/v1.ts index 2e846131ff..be9f6a99f1 100644 --- a/src/apis/walletobjects/v1.ts +++ b/src/apis/walletobjects/v1.ts @@ -3422,7 +3422,7 @@ export namespace walletobjects_v1 { */ header?: string | null; /** - * The ID associated with a text module. This field is here to enable ease of management of text modules. + * The ID associated with a text module. This field is here to enable ease of management of text modules and referencing them in template overrides. The ID should only include alphanumeric characters, '_', or '-'. It can not include dots, as dots are used to separate fields within FieldReference.fieldPaths in template overrides. */ id?: string | null; /** diff --git a/src/apis/workstations/v1beta.ts b/src/apis/workstations/v1beta.ts index 0ce7971ada..abc12a1cdc 100644 --- a/src/apis/workstations/v1beta.ts +++ b/src/apis/workstations/v1beta.ts @@ -478,6 +478,15 @@ export namespace workstations_v1beta { */ gceInstance?: Schema$GceInstance; } + /** + * Http options for the running workstations. + */ + export interface Schema$HttpOptions { + /** + * Optional. By default, the workstations service makes sure that all requests to the workstation are authenticated. CORS preflight requests do not include cookies or custom headers, and so are considered unauthenticated and blocked by the workstations service. Enabling this option allows these unauthenticated CORS preflight requests through to the workstation, where it becomes the responsibility of the destination server in the workstation to validate the request. + */ + allowedUnauthenticatedCorsPreflightRequests?: boolean | null; + } /** * The response message for Operations.ListOperations. */ @@ -826,6 +835,10 @@ export namespace workstations_v1beta { * Output only. Indicates whether this workstation is currently being updated to match its intended state. */ reconciling?: boolean | null; + /** + * Optional. The source workstation from which this workstations persistent directories were cloned on creation. + */ + sourceWorkstation?: string | null; /** * Output only. Time when this workstation was most recently successfully started, regardless of the workstation's initial state. */ @@ -976,6 +989,10 @@ export namespace workstations_v1beta { * Optional. Runtime host for the workstation. */ host?: Schema$Host; + /** + * Optional. Http options that customize the behavior of the workstation service's http proxy. + */ + httpOptions?: Schema$HttpOptions; /** * Optional. Number of seconds to wait before automatically stopping a workstation after it last received user traffic. A value of `"0s"` indicates that Cloud Workstations VMs created with this configuration should never time out due to idleness. Provide [duration](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#duration) terminated by `s` for seconds—for example, `"7200s"` (2 hours). The default is `"1200s"` (20 minutes). */