diff --git a/discovery/accesscontextmanager-v1.json b/discovery/accesscontextmanager-v1.json index 806a0c0b56..b425e18992 100644 --- a/discovery/accesscontextmanager-v1.json +++ b/discovery/accesscontextmanager-v1.json @@ -1235,7 +1235,7 @@ } } }, - "revision": "20230917", + "revision": "20231011", "rootUrl": "https://accesscontextmanager.googleapis.com/", "schemas": { "AccessContextManagerOperationMetadata": { @@ -1793,7 +1793,7 @@ "type": "object" }, "GcpUserAccessBindingOperationMetadata": { - "description": "Currently, a completed operation means nothing. In the future, this metadata and a completed operation may indicate that the binding has taken effect and is affecting access decisions for all users.", + "description": "Metadata of GCP Access Binding Long Running Operations.", "id": "GcpUserAccessBindingOperationMetadata", "properties": {}, "type": "object" diff --git a/discovery/aiplatform-v1.json b/discovery/aiplatform-v1.json index df82f9a4b2..d07ec72226 100644 --- a/discovery/aiplatform-v1.json +++ b/discovery/aiplatform-v1.json @@ -20,44 +20,44 @@ "documentationLink": "https://cloud.google.com/vertex-ai/", "endpoints": [ { - "location": "asia-east1", "description": "Locational Endpoint", + "location": "asia-east1", "endpointUrl": "https://asia-east1-aiplatform.googleapis.com/" }, { - "description": "Locational Endpoint", "location": "asia-east2", - "endpointUrl": "https://asia-east2-aiplatform.googleapis.com/" + "endpointUrl": "https://asia-east2-aiplatform.googleapis.com/", + "description": "Locational Endpoint" }, { "description": "Locational Endpoint", - "location": "asia-northeast1", - "endpointUrl": "https://asia-northeast1-aiplatform.googleapis.com/" + "endpointUrl": "https://asia-northeast1-aiplatform.googleapis.com/", + "location": "asia-northeast1" }, { + "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", + "endpointUrl": "https://asia-northeast3-aiplatform.googleapis.com/" }, { - "location": "asia-south1", "description": "Locational Endpoint", + "location": "asia-south1", "endpointUrl": "https://asia-south1-aiplatform.googleapis.com/" }, { + "location": "asia-southeast1", "description": "Locational Endpoint", - "endpointUrl": "https://asia-southeast1-aiplatform.googleapis.com/", - "location": "asia-southeast1" + "endpointUrl": "https://asia-southeast1-aiplatform.googleapis.com/" }, { + "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", @@ -65,118 +65,118 @@ "location": "australia-southeast1" }, { + "location": "australia-southeast2", "description": "Locational Endpoint", - "endpointUrl": "https://australia-southeast2-aiplatform.googleapis.com/", - "location": "australia-southeast2" + "endpointUrl": "https://australia-southeast2-aiplatform.googleapis.com/" }, { - "description": "Locational Endpoint", "endpointUrl": "https://europe-central2-aiplatform.googleapis.com/", - "location": "europe-central2" + "location": "europe-central2", + "description": "Locational Endpoint" }, { - "location": "europe-north1", + "description": "Locational Endpoint", "endpointUrl": "https://europe-north1-aiplatform.googleapis.com/", - "description": "Locational Endpoint" + "location": "europe-north1" }, { - "description": "Locational Endpoint", + "endpointUrl": "https://europe-southwest1-aiplatform.googleapis.com/", "location": "europe-southwest1", - "endpointUrl": "https://europe-southwest1-aiplatform.googleapis.com/" + "description": "Locational Endpoint" }, { "endpointUrl": "https://europe-west1-aiplatform.googleapis.com/", - "location": "europe-west1", - "description": "Locational Endpoint" + "description": "Locational Endpoint", + "location": "europe-west1" }, { + "endpointUrl": "https://europe-west2-aiplatform.googleapis.com/", "location": "europe-west2", - "description": "Locational Endpoint", - "endpointUrl": "https://europe-west2-aiplatform.googleapis.com/" + "description": "Locational Endpoint" }, { - "endpointUrl": "https://europe-west3-aiplatform.googleapis.com/", + "location": "europe-west3", "description": "Locational Endpoint", - "location": "europe-west3" + "endpointUrl": "https://europe-west3-aiplatform.googleapis.com/" }, { "location": "europe-west4", - "description": "Locational Endpoint", - "endpointUrl": "https://europe-west4-aiplatform.googleapis.com/" + "endpointUrl": "https://europe-west4-aiplatform.googleapis.com/", + "description": "Locational Endpoint" }, { + "description": "Locational Endpoint", "location": "europe-west6", - "endpointUrl": "https://europe-west6-aiplatform.googleapis.com/", - "description": "Locational Endpoint" + "endpointUrl": "https://europe-west6-aiplatform.googleapis.com/" }, { - "description": "Locational Endpoint", "endpointUrl": "https://europe-west8-aiplatform.googleapis.com/", - "location": "europe-west8" + "location": "europe-west8", + "description": "Locational Endpoint" }, { - "endpointUrl": "https://europe-west9-aiplatform.googleapis.com/", + "location": "europe-west9", "description": "Locational Endpoint", - "location": "europe-west9" + "endpointUrl": "https://europe-west9-aiplatform.googleapis.com/" }, { "location": "me-west1", - "endpointUrl": "https://me-west1-aiplatform.googleapis.com/", - "description": "Locational Endpoint" + "description": "Locational Endpoint", + "endpointUrl": "https://me-west1-aiplatform.googleapis.com/" }, { "description": "Locational Endpoint", - "location": "northamerica-northeast1", - "endpointUrl": "https://northamerica-northeast1-aiplatform.googleapis.com/" + "endpointUrl": "https://northamerica-northeast1-aiplatform.googleapis.com/", + "location": "northamerica-northeast1" }, { - "endpointUrl": "https://northamerica-northeast2-aiplatform.googleapis.com/", "description": "Locational Endpoint", - "location": "northamerica-northeast2" + "location": "northamerica-northeast2", + "endpointUrl": "https://northamerica-northeast2-aiplatform.googleapis.com/" }, { - "description": "Locational Endpoint", "location": "southamerica-east1", + "description": "Locational Endpoint", "endpointUrl": "https://southamerica-east1-aiplatform.googleapis.com/" }, { "endpointUrl": "https://southamerica-west1-aiplatform.googleapis.com/", - "description": "Locational Endpoint", - "location": "southamerica-west1" + "location": "southamerica-west1", + "description": "Locational Endpoint" }, { "description": "Locational Endpoint", - "endpointUrl": "https://us-central1-aiplatform.googleapis.com/", - "location": "us-central1" + "location": "us-central1", + "endpointUrl": "https://us-central1-aiplatform.googleapis.com/" }, { + "endpointUrl": "https://us-central2-aiplatform.googleapis.com/", "description": "Locational Endpoint", - "location": "us-central2", - "endpointUrl": "https://us-central2-aiplatform.googleapis.com/" + "location": "us-central2" }, { + "location": "us-east1", "description": "Locational Endpoint", - "endpointUrl": "https://us-east1-aiplatform.googleapis.com/", - "location": "us-east1" + "endpointUrl": "https://us-east1-aiplatform.googleapis.com/" }, { + "endpointUrl": "https://us-east4-aiplatform.googleapis.com/", "location": "us-east4", - "description": "Locational Endpoint", - "endpointUrl": "https://us-east4-aiplatform.googleapis.com/" + "description": "Locational Endpoint" }, { - "location": "us-south1", "description": "Locational Endpoint", - "endpointUrl": "https://us-south1-aiplatform.googleapis.com/" + "endpointUrl": "https://us-south1-aiplatform.googleapis.com/", + "location": "us-south1" }, { - "description": "Locational Endpoint", "location": "us-west1", - "endpointUrl": "https://us-west1-aiplatform.googleapis.com/" + "endpointUrl": "https://us-west1-aiplatform.googleapis.com/", + "description": "Locational Endpoint" }, { - "location": "us-west2", "endpointUrl": "https://us-west2-aiplatform.googleapis.com/", + "location": "us-west2", "description": "Locational Endpoint" }, { @@ -185,8 +185,8 @@ "location": "us-west3" }, { - "location": "us-west4", "description": "Locational Endpoint", + "location": "us-west4", "endpointUrl": "https://us-west4-aiplatform.googleapis.com/" } ], diff --git a/discovery/aiplatform-v1beta1.json b/discovery/aiplatform-v1beta1.json index 3c51a13112..420f7e1e79 100644 --- a/discovery/aiplatform-v1beta1.json +++ b/discovery/aiplatform-v1beta1.json @@ -20,64 +20,64 @@ "documentationLink": "https://cloud.google.com/vertex-ai/", "endpoints": [ { - "location": "asia-east1", + "endpointUrl": "https://asia-east1-aiplatform.googleapis.com/", "description": "Locational Endpoint", - "endpointUrl": "https://asia-east1-aiplatform.googleapis.com/" + "location": "asia-east1" }, { "endpointUrl": "https://asia-east2-aiplatform.googleapis.com/", - "description": "Locational Endpoint", - "location": "asia-east2" + "location": "asia-east2", + "description": "Locational Endpoint" }, { - "endpointUrl": "https://asia-northeast1-aiplatform.googleapis.com/", + "description": "Locational Endpoint", "location": "asia-northeast1", - "description": "Locational Endpoint" + "endpointUrl": "https://asia-northeast1-aiplatform.googleapis.com/" }, { "description": "Locational Endpoint", - "endpointUrl": "https://asia-northeast2-aiplatform.googleapis.com/", - "location": "asia-northeast2" + "location": "asia-northeast2", + "endpointUrl": "https://asia-northeast2-aiplatform.googleapis.com/" }, { + "endpointUrl": "https://asia-northeast3-aiplatform.googleapis.com/", "location": "asia-northeast3", - "description": "Locational Endpoint", - "endpointUrl": "https://asia-northeast3-aiplatform.googleapis.com/" + "description": "Locational Endpoint" }, { - "location": "asia-south1", "description": "Locational Endpoint", + "location": "asia-south1", "endpointUrl": "https://asia-south1-aiplatform.googleapis.com/" }, { - "description": "Locational Endpoint", "endpointUrl": "https://asia-southeast1-aiplatform.googleapis.com/", - "location": "asia-southeast1" + "location": "asia-southeast1", + "description": "Locational Endpoint" }, { - "endpointUrl": "https://asia-southeast2-aiplatform.googleapis.com/", "location": "asia-southeast2", + "endpointUrl": "https://asia-southeast2-aiplatform.googleapis.com/", "description": "Locational Endpoint" }, { + "location": "australia-southeast1", "endpointUrl": "https://australia-southeast1-aiplatform.googleapis.com/", - "description": "Locational Endpoint", - "location": "australia-southeast1" + "description": "Locational Endpoint" }, { - "description": "Locational Endpoint", "location": "australia-southeast2", + "description": "Locational Endpoint", "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", - "endpointUrl": "https://europe-north1-aiplatform.googleapis.com/", - "location": "europe-north1" + "location": "europe-north1", + "endpointUrl": "https://europe-north1-aiplatform.googleapis.com/" }, { "location": "europe-southwest1", @@ -85,109 +85,109 @@ "endpointUrl": "https://europe-southwest1-aiplatform.googleapis.com/" }, { - "location": "europe-west1", "description": "Locational Endpoint", + "location": "europe-west1", "endpointUrl": "https://europe-west1-aiplatform.googleapis.com/" }, { "description": "Locational Endpoint", - "endpointUrl": "https://europe-west2-aiplatform.googleapis.com/", - "location": "europe-west2" + "location": "europe-west2", + "endpointUrl": "https://europe-west2-aiplatform.googleapis.com/" }, { - "endpointUrl": "https://europe-west3-aiplatform.googleapis.com/", + "description": "Locational Endpoint", "location": "europe-west3", - "description": "Locational Endpoint" + "endpointUrl": "https://europe-west3-aiplatform.googleapis.com/" }, { "endpointUrl": "https://europe-west4-aiplatform.googleapis.com/", - "location": "europe-west4", - "description": "Locational Endpoint" + "description": "Locational Endpoint", + "location": "europe-west4" }, { - "location": "europe-west6", "endpointUrl": "https://europe-west6-aiplatform.googleapis.com/", - "description": "Locational Endpoint" + "description": "Locational Endpoint", + "location": "europe-west6" }, { - "endpointUrl": "https://europe-west8-aiplatform.googleapis.com/", + "description": "Locational Endpoint", "location": "europe-west8", - "description": "Locational Endpoint" + "endpointUrl": "https://europe-west8-aiplatform.googleapis.com/" }, { - "location": "europe-west9", "description": "Locational Endpoint", + "location": "europe-west9", "endpointUrl": "https://europe-west9-aiplatform.googleapis.com/" }, { - "description": "Locational Endpoint", "endpointUrl": "https://me-west1-aiplatform.googleapis.com/", + "description": "Locational Endpoint", "location": "me-west1" }, { - "endpointUrl": "https://northamerica-northeast1-aiplatform.googleapis.com/", "location": "northamerica-northeast1", - "description": "Locational Endpoint" + "description": "Locational Endpoint", + "endpointUrl": "https://northamerica-northeast1-aiplatform.googleapis.com/" }, { "endpointUrl": "https://northamerica-northeast2-aiplatform.googleapis.com/", - "location": "northamerica-northeast2", - "description": "Locational Endpoint" + "description": "Locational Endpoint", + "location": "northamerica-northeast2" }, { "endpointUrl": "https://southamerica-east1-aiplatform.googleapis.com/", - "location": "southamerica-east1", - "description": "Locational Endpoint" + "description": "Locational Endpoint", + "location": "southamerica-east1" }, { + "endpointUrl": "https://southamerica-west1-aiplatform.googleapis.com/", "description": "Locational Endpoint", - "location": "southamerica-west1", - "endpointUrl": "https://southamerica-west1-aiplatform.googleapis.com/" + "location": "southamerica-west1" }, { - "endpointUrl": "https://us-central1-aiplatform.googleapis.com/", + "location": "us-central1", "description": "Locational Endpoint", - "location": "us-central1" + "endpointUrl": "https://us-central1-aiplatform.googleapis.com/" }, { - "location": "us-central2", "endpointUrl": "https://us-central2-aiplatform.googleapis.com/", + "location": "us-central2", "description": "Locational Endpoint" }, { - "description": "Locational Endpoint", "endpointUrl": "https://us-east1-aiplatform.googleapis.com/", - "location": "us-east1" + "location": "us-east1", + "description": "Locational Endpoint" }, { - "location": "us-east4", "endpointUrl": "https://us-east4-aiplatform.googleapis.com/", - "description": "Locational Endpoint" + "description": "Locational Endpoint", + "location": "us-east4" }, { - "location": "us-south1", + "description": "Locational Endpoint", "endpointUrl": "https://us-south1-aiplatform.googleapis.com/", - "description": "Locational Endpoint" + "location": "us-south1" }, { - "description": "Locational Endpoint", "endpointUrl": "https://us-west1-aiplatform.googleapis.com/", - "location": "us-west1" + "location": "us-west1", + "description": "Locational Endpoint" }, { + "description": "Locational Endpoint", "endpointUrl": "https://us-west2-aiplatform.googleapis.com/", - "location": "us-west2", - "description": "Locational Endpoint" + "location": "us-west2" }, { - "location": "us-west3", "description": "Locational Endpoint", + "location": "us-west3", "endpointUrl": "https://us-west3-aiplatform.googleapis.com/" }, { + "description": "Locational Endpoint", "location": "us-west4", - "endpointUrl": "https://us-west4-aiplatform.googleapis.com/", - "description": "Locational Endpoint" + "endpointUrl": "https://us-west4-aiplatform.googleapis.com/" } ], "fullyEncodeReservedExpansion": true, diff --git a/discovery/alloydb-v1.json b/discovery/alloydb-v1.json index 454a454429..cf38dfd786 100644 --- a/discovery/alloydb-v1.json +++ b/discovery/alloydb-v1.json @@ -1489,7 +1489,7 @@ } } }, - "revision": "20231006", + "revision": "20230918", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { "AutomatedBackupPolicy": { @@ -2369,7 +2369,7 @@ }, "readPoolConfig": { "$ref": "ReadPoolConfig", - "description": "Read pool instance configuration. This is required if the value of instanceType is READ_POOL." + "description": "Read pool specific config." }, "reconciling": { "description": "Output only. Reconciling (https://google.aip.dev/128#reconciliation). Set to true if the current state of Instance does not match the user's intended state, and the service is actively updating the resource to reconcile them. This can happen due to user-triggered updates or system actions like failover or maintenance.", @@ -2622,7 +2622,7 @@ "id": "NetworkConfig", "properties": { "allocatedIpRange": { - "description": "Optional. Name of the allocated IP range for the private IP AlloyDB cluster, for example: \"google-managed-services-default\". If set, the instance IPs for this cluster will be created in the allocated range. The range name must comply with RFC 1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. Field name is intended to be consistent with Cloud SQL.", + "description": "Optional. Name of the allocated IP range for the private IP AlloyDB cluster, for example: \"google-managed-services-default\". If set, the instance IPs for this cluster will be created in the allocated range. The range name must comply with RFC 1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. Field name is intended to be consistent with CloudSQL.", "type": "string" }, "network": { @@ -3129,7 +3129,7 @@ "type": "string" }, "eventTime": { - "description": "Required. The last time at which the event described by this signal took place", + "description": "The last time at which the event described by this signal took place", "format": "google-datetime", "type": "string" }, @@ -3138,7 +3138,7 @@ "type": "string" }, "name": { - "description": "Required. The name of the signal, ex: PUBLIC_SQL_INSTANCE, SQL_LOG_ERROR_VERBOSITY etc.", + "description": "The name of the signal, ex: PUBLIC_SQL_INSTANCE, SQL_LOG_ERROR_VERBOSITY etc.", "type": "string" }, "provider": { @@ -3168,11 +3168,11 @@ "type": "string" }, "resourceName": { - "description": "Required. Database resource name associated with the signal. Resource name to follow CAIS resource_name format as noted here go/condor-common-datamodel", + "description": "Database resource name associated with the signal. Resource name to follow CAIS resource_name format as noted here go/condor-common-datamodel", "type": "string" }, "signalClass": { - "description": "Required. The class of the signal, such as if it's a THREAT or VULNERABILITY.", + "description": "The class of the signal, such as if it's a THREAT or VULNERABILITY.", "enum": [ "CLASS_UNSPECIFIED", "THREAT", @@ -3192,109 +3192,7 @@ "type": "string" }, "signalId": { - "description": "Required. Unique identifier for the signal. This is an unique id which would be mainatined by partner to identify a signal.", - "type": "string" - }, - "signalType": { - "description": "Required. Type of signal, for example, `AVAILABLE_IN_MULTIPLE_ZONES`, `LOGGING_MOST_ERRORS`, etc.", - "enum": [ - "SIGNAL_TYPE_UNSPECIFIED", - "SIGNAL_TYPE_NOT_AVAILABLE_IN_MULTIPLE_ZONES", - "SIGNAL_TYPE_NOT_AVAILABLE_IN_MULTIPLE_REGIONS", - "SIGNAL_TYPE_NO_PROMOTABLE_REPLICA", - "SIGNAL_TYPE_NO_AUTOMATED_BACKUP_POLICY", - "SIGNAL_TYPE_SHORT_BACKUP_RETENTION", - "SIGNAL_TYPE_LAST_BACKUP_FAILED", - "SIGNAL_TYPE_LAST_BACKUP_OLD", - "SIGNAL_TYPE_VIOLATES_CIS_GCP_FOUNDATION_2_0", - "SIGNAL_TYPE_VIOLATES_CIS_GCP_FOUNDATION_1_3", - "SIGNAL_TYPE_VIOLATES_CIS_GCP_FOUNDATION_1_2", - "SIGNAL_TYPE_VIOLATES_CIS_GCP_FOUNDATION_1_1", - "SIGNAL_TYPE_VIOLATES_CIS_GCP_FOUNDATION_1_0", - "SIGNAL_TYPE_VIOLATES_NIST_800_53", - "SIGNAL_TYPE_VIOLATES_ISO_27001", - "SIGNAL_TYPE_VIOLATES_PCI_DSS_V3_2_1", - "SIGNAL_TYPE_LOGS_NOT_OPTIMIZED_FOR_TROUBLESHOOTING", - "SIGNAL_TYPE_QUERY_DURATIONS_NOT_LOGGED", - "SIGNAL_TYPE_VERBOSE_ERROR_LOGGING", - "SIGNAL_TYPE_QUERY_LOCK_WAITS_NOT_LOGGED", - "SIGNAL_TYPE_LOGGING_MOST_ERRORS", - "SIGNAL_TYPE_LOGGING_ONLY_CRITICAL_ERRORS", - "SIGNAL_TYPE_MINIMAL_ERROR_LOGGING", - "SIGNAL_TYPE_QUERY_STATISTICS_LOGGED", - "SIGNAL_TYPE_EXCESSIVE_LOGGING_OF_CLIENT_HOSTNAME", - "SIGNAL_TYPE_EXCESSIVE_LOGGING_OF_PARSER_STATISTICS", - "SIGNAL_TYPE_EXCESSIVE_LOGGING_OF_PLANNER_STATISTICS", - "SIGNAL_TYPE_NOT_LOGGING_ONLY_DDL_STATEMENTS", - "SIGNAL_TYPE_LOGGING_QUERY_STATISTICS", - "SIGNAL_TYPE_NOT_LOGGING_TEMPORARY_FILES", - "SIGNAL_TYPE_CONNECTION_MAX_NOT_CONFIGURED", - "SIGNAL_TYPE_USER_OPTIONS_CONFIGURED", - "SIGNAL_TYPE_EXPOSED_TO_PUBLIC_ACCESS", - "SIGNAL_TYPE_UNENCRYPTED_CONNECTIONS", - "SIGNAL_TYPE_NO_ROOT_PASSWORD", - "SIGNAL_TYPE_WEAK_ROOT_PASSWORD", - "SIGNAL_TYPE_ENCRYPTION_KEY_NOT_CUSTOMER_MANAGED", - "SIGNAL_TYPE_SERVER_AUTHENTICATION_NOT_REQUIRED", - "SIGNAL_TYPE_EXPOSED_BY_OWNERSHIP_CHAINING", - "SIGNAL_TYPE_EXPOSED_TO_EXTERNAL_SCRIPTS", - "SIGNAL_TYPE_EXPOSED_TO_LOCAL_DATA_LOADS", - "SIGNAL_TYPE_CONNECTION_ATTEMPTS_NOT_LOGGED", - "SIGNAL_TYPE_DISCONNECTIONS_NOT_LOGGED", - "SIGNAL_TYPE_LOGGING_EXCESSIVE_STATEMENT_INFO", - "SIGNAL_TYPE_EXPOSED_TO_REMOTE_ACCESS", - "SIGNAL_TYPE_DATABASE_NAMES_EXPOSED", - "SIGNAL_TYPE_SENSITIVE_TRACE_INFO_NOT_MASKED" - ], - "enumDescriptions": [ - "Unspecified.", - "Represents if the resource is available in multiple zones or not.", - "Represents if a resource is available in multiple regions.", - "Represents if a resource has a promotable replica.", - "Represents if a resource has an automated backup policy.", - "Represents if a resources has a short backup retention period.", - "Represents if the last backup of a resource failed.", - "Represents if the last backup of a resource is older than some threshold value.", - "Represents if a resource violates CIS GCP Foundation 2.0.", - "Represents if a resource violates CIS GCP Foundation 1.3.", - "Represents if a resource violates CIS GCP Foundation 1.2.", - "Represents if a resource violates CIS GCP Foundation 1.1.", - "Represents if a resource violates CIS GCP Foundation 1.0.", - "Represents if a resource violates NIST 800-53.", - "Represents if a resource violates ISO-27001.", - "Represents if a resource violates PCI-DSS v3.2.1.", - "LINT.IfChange(scc_signals) Represents if log_checkpoints database flag for a Cloud SQL for PostgreSQL instance is not set to on.", - "Represents if the log_duration database flag for a Cloud SQL for PostgreSQL instance is not set to on.", - "Represents if the log_error_verbosity database flag for a Cloud SQL for PostgreSQL instance is not set to default or stricter (default or terse).", - "Represents if the log_lock_waits database flag for a Cloud SQL for PostgreSQL instance is not set to on.", - "Represents if the log_min_error_statement database flag for a Cloud SQL for PostgreSQL instance is not set appropriately.", - "Represents if the log_min_error_statement database flag for a Cloud SQL for PostgreSQL instance does not have an appropriate severity level.", - "Represents if the log_min_messages database flag for a Cloud SQL for PostgreSQL instance is not set to warning or another recommended value.", - "Represents if the databaseFlags property of instance metadata for the log_executor_status field is set to on.", - "Represents if the log_hostname database flag for a Cloud SQL for PostgreSQL instance is not set to off.", - "Represents if the log_parser_stats database flag for a Cloud SQL for PostgreSQL instance is not set to off.", - "Represents if the log_planner_stats database flag for a Cloud SQL for PostgreSQL instance is not set to off.", - "Represents if the log_statement database flag for a Cloud SQL for PostgreSQL instance is not set to DDL (all data definition statements).", - "Represents if the log_statement_stats database flag for a Cloud SQL for PostgreSQL instance is not set to off.", - "Represents if the log_temp_files database flag for a Cloud SQL for PostgreSQL instance is not set to \"0\". (NOTE: 0 = ON)", - "Represents if the user connections database flag for a Cloud SQL for SQL Server instance is configured.", - "Represents if the user options database flag for Cloud SQL SQL Server instance is configured or not.", - "Represents if a resource is exposed to public access.", - "Represents if a resources requires all incoming connections to use SSL or not.", - "Represents if a Cloud SQL database has a password configured for the root account or not.", - "Represents if a Cloud SQL database has a weak password configured for the root account.", - "Represents if a SQL database instance is not encrypted with customer-managed encryption keys (CMEK).", - "Represents if The contained database authentication database flag for a Cloud SQL for SQL Server instance is not set to off.", - "Represents if the cross_db_ownership_chaining database flag for a Cloud SQL for SQL Server instance is not set to off.", - "Represents if he external scripts enabled database flag for a Cloud SQL for SQL Server instance is not set to off.", - "Represents if the local_infile database flag for a Cloud SQL for MySQL instance is not set to off.", - "Represents if the log_connections database flag for a Cloud SQL for PostgreSQL instance is not set to on.", - "Represents if the log_disconnections database flag for a Cloud SQL for PostgreSQL instance is not set to on.", - "Represents if the log_min_duration_statement database flag for a Cloud SQL for PostgreSQL instance is not set to -1.", - "Represents if the remote access database flag for a Cloud SQL for SQL Server instance is not set to off.", - "Represents if the skip_show_database database flag for a Cloud SQL for MySQL instance is not set to on.", - "Represents if the 3625 (trace flag) database flag for a Cloud SQL for SQL Server instance is not set to on. LINT.ThenChange(//depot/google3/storage/databasecenter/ingestion/borgjob/message_adapter/health_signal_feed/health_signal_mapping.h)" - ], + "description": "Unique identifier for the signal. This is an unique id which would be mainatined by partner to identify a signal.", "type": "string" }, "state": { @@ -3434,14 +3332,12 @@ "enum": [ "INSTANCE_TYPE_UNSPECIFIED", "PRIMARY", - "SECONDARY", "READ_REPLICA", "OTHER" ], "enumDescriptions": [ "", "A regular primary database instance.", - "A cluster or an instance acting as a secondary.", "An instance acting as a read-replica.", "For rest of the other categories." ], diff --git a/discovery/androidpublisher-v3.json b/discovery/androidpublisher-v3.json index fe47be5327..f28df53386 100644 --- a/discovery/androidpublisher-v3.json +++ b/discovery/androidpublisher-v3.json @@ -3171,7 +3171,7 @@ "orders": { "methods": { "refund": { - "description": "Refunds a user's subscription or in-app purchase order. Orders older than 1 year cannot be refunded.", + "description": "Refunds a user's subscription or in-app purchase order. Orders older than 3 years cannot be refunded.", "flatPath": "androidpublisher/v3/applications/{packageName}/orders/{orderId}:refund", "httpMethod": "POST", "id": "androidpublisher.orders.refund", @@ -4047,7 +4047,7 @@ } } }, - "revision": "20231010", + "revision": "20231012", "rootUrl": "https://androidpublisher.googleapis.com/", "schemas": { "Abi": { @@ -6395,7 +6395,7 @@ "id": "RegionalPriceMigrationConfig", "properties": { "oldestAllowedPriceVersionTime": { - "description": "Required. The cutoff time for historical prices that subscribers can remain paying. Subscribers who are on a price that was created before this cutoff time will be migrated to the currently-offered price. These subscribers will receive a notification that they will be paying a different price. Subscribers who do not agree to the new price will have their subscription ended at the next renewal.", + "description": "Required. The cutoff time for historical prices that subscribers can remain paying. Subscribers on prices which were available at this cutoff time or later will stay on their existing price. Subscribers on older prices will be migrated to the currently-offered price. The migrated subscribers will receive a notification that they will be paying a different price. Subscribers who do not agree to the new price will have their subscription ended at the next renewal.", "format": "google-datetime", "type": "string" }, diff --git a/discovery/bigqueryreservation-v1.json b/discovery/bigqueryreservation-v1.json index 4516d73a72..d351dd1444 100644 --- a/discovery/bigqueryreservation-v1.json +++ b/discovery/bigqueryreservation-v1.json @@ -20,9 +20,9 @@ "documentationLink": "https://cloud.google.com/bigquery/", "endpoints": [ { - "endpointUrl": "https://bigqueryreservation.me-central2.rep.googleapis.com/", "location": "me-central2", - "description": "Regional Endpoint" + "description": "Regional Endpoint", + "endpointUrl": "https://bigqueryreservation.me-central2.rep.googleapis.com/" } ], "fullyEncodeReservedExpansion": true, @@ -831,7 +831,7 @@ } } }, - "revision": "20231007", + "revision": "20230928", "rootUrl": "https://bigqueryreservation.googleapis.com/", "schemas": { "Assignment": { diff --git a/discovery/chromepolicy-v1.json b/discovery/chromepolicy-v1.json index 9c82cf30a0..119c2e5985 100644 --- a/discovery/chromepolicy-v1.json +++ b/discovery/chromepolicy-v1.json @@ -557,7 +557,7 @@ } } }, - "revision": "20231009", + "revision": "20231011", "rootUrl": "https://chromepolicy.googleapis.com/", "schemas": { "GoogleChromePolicyVersionsV1AdditionalTargetKeyName": { @@ -1605,13 +1605,13 @@ "label": { "enum": [ "LABEL_OPTIONAL", - "LABEL_REQUIRED", - "LABEL_REPEATED" + "LABEL_REPEATED", + "LABEL_REQUIRED" ], "enumDescriptions": [ "0 is reserved for errors", "", - "" + "The required label is only allowed in proto2. In proto3 and Editions it's explicitly prohibited. In Editions, the `field_presence` feature can be used to get this behavior." ], "type": "string" }, @@ -1663,7 +1663,7 @@ "", "", "", - "Tag-delimited aggregate. Group type is deprecated and not supported in proto3. However, Proto3 implementations should still be able to parse the group wire format and treat group fields as unknown fields.", + "Tag-delimited aggregate. Group type is deprecated and not supported after proto2. However, Proto3 implementations should still be able to parse the group wire format and treat group fields as unknown fields. In Editions, the group wire format can be enabled via the `message_encoding` feature.", "Length-delimited aggregate.", "New in version 2.", "", diff --git a/discovery/compute-alpha.json b/discovery/compute-alpha.json index be67714eda..86899f0cb1 100644 --- a/discovery/compute-alpha.json +++ b/discovery/compute-alpha.json @@ -36044,6 +36044,71 @@ }, "snapshots": { "methods": { + "aggregatedList": { + "description": "Retrieves an aggregated list of all of the snapshots in your project across all regions and global scope.", + "flatPath": "projects/{project}/aggregated/snapshots", + "httpMethod": "GET", + "id": "compute.snapshots.aggregatedList", + "parameterOrder": [ + "project" + ], + "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" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "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" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/snapshots", + "response": { + "$ref": "SnapshotAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, "delete": { "description": "Deletes the specified Snapshot resource. Keep in mind that deleting a single snapshot might not necessarily delete all the data on that snapshot. If any data on the snapshot that is marked for deletion is needed for subsequent snapshots, the data will be moved to the next corresponding snapshot. For more information, see Deleting snapshots.", "flatPath": "projects/{project}/global/snapshots/{snapshot}", @@ -43424,7 +43489,7 @@ } } }, - "revision": "20230923", + "revision": "20231003", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -58471,6 +58536,13 @@ }, "description": "Named instance selections configuring properties that the group will use when creating new VMs.", "type": "object" + }, + "instanceSelections": { + "additionalProperties": { + "$ref": "InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection" + }, + "description": "Named instance selections configuring properties that the group will use when creating new VMs.", + "type": "object" } }, "type": "object" @@ -58735,6 +58807,10 @@ "$ref": "QueuingPolicy", "description": "When set, defines queing parameters for the requested deferred capacity. When unset, the request starts provisioning immediately, or fails if immediate provisioning is not possible." }, + "requestedRunDuration": { + "$ref": "Duration", + "description": "Requested run duration for instances that will be created by this request. If specified, the instance termination action will be performed at the end of the run duration." + }, "resizeBy": { "description": "The number of instances to be created by this resize request. The group's target size will be increased by this number.", "format": "int32", @@ -66442,7 +66518,7 @@ "description": "[Output Only] Information about the last attempt to create or delete the instance." }, "name": { - "description": "[Output Only] The name of the instance. The name will always exist even if the instance has not yet been created.", + "description": "[Output Only] The name of the instance. The name always exists even if the instance has not yet been created.", "type": "string" }, "preservedStateFromConfig": { @@ -67272,6 +67348,10 @@ "subnetwork": { "description": "The subnetwork used to assign the IP to the producer instance network interface.", "type": "string" + }, + "subnetworkCidrRange": { + "description": "[Output Only] The CIDR range of the subnet from which the IPv4 internal IP was allocated from.", + "type": "string" } }, "type": "object" @@ -74250,6 +74330,18 @@ "description": "A public advertised prefix represents an aggregated IP prefix or netblock which customers bring to cloud. The IP prefix is a single unit of route advertisement and is announced globally to the internet.", "id": "PublicAdvertisedPrefix", "properties": { + "byoipApiVersion": { + "description": "[Output Only] The version of BYOIP API.", + "enum": [ + "V1", + "V2" + ], + "enumDescriptions": [ + "This public advertised prefix can be used to create both regional and global public delegated prefixes. It usually takes 4 weeks to create or delete a public delegated prefix. The BGP status cannot be changed.", + "This public advertised prefix can only be used to create regional public delegated prefixes. Public delegated prefix creation and deletion takes minutes and the BGP status can be modified." + ], + "type": "string" + }, "creationTimestamp": { "description": "[Output Only] Creation timestamp in RFC3339 text format.", "type": "string" @@ -74540,6 +74632,18 @@ "format": "int32", "type": "integer" }, + "byoipApiVersion": { + "description": "[Output Only] The version of BYOIP API.", + "enum": [ + "V1", + "V2" + ], + "enumDescriptions": [ + "This public delegated prefix usually takes 4 weeks to delete, and the BGP status cannot be changed. Announce and Withdraw APIs can not be used on this prefix.", + "This public delegated prefix takes minutes to delete. Announce and Withdraw APIs can be used on this prefix to change the BGP status." + ], + "type": "string" + }, "creationTimestamp": { "description": "[Output Only] Creation timestamp in RFC3339 text format.", "type": "string" @@ -85228,6 +85332,168 @@ }, "type": "object" }, + "SnapshotAggregatedList": { + "id": "SnapshotAggregatedList", + "properties": { + "etag": { + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "SnapshotsScopedList", + "description": "[Output Only] Name of the scope containing this set of snapshots." + }, + "description": "A list of SnapshotsScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#snapshotAggregatedList", + "description": "[Output Only] Type of resource. Always compute#snapshotAggregatedList for aggregated lists of snapshots.", + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "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": "[Output Only] 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" + }, "SnapshotList": { "description": "Contains a list of Snapshot resources.", "id": "SnapshotList", @@ -85430,6 +85696,140 @@ }, "type": "object" }, + "SnapshotsScopedList": { + "id": "SnapshotsScopedList", + "properties": { + "snapshots": { + "description": "[Output Only] A list of snapshots contained in this scope.", + "items": { + "$ref": "Snapshot" + }, + "type": "array" + }, + "warning": { + "description": "[Output Only] Informational warning which replaces the list of snapshots when the list is empty.", + "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" + }, "SourceDiskEncryptionKey": { "id": "SourceDiskEncryptionKey", "properties": { diff --git a/discovery/compute-beta.json b/discovery/compute-beta.json index 7ecd7f4fe1..fd303ea67c 100644 --- a/discovery/compute-beta.json +++ b/discovery/compute-beta.json @@ -40049,7 +40049,7 @@ } } }, - "revision": "20230923", + "revision": "20231003", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -61400,7 +61400,7 @@ "description": "[Output Only] Information about the last attempt to create or delete the instance." }, "name": { - "description": "[Output Only] The name of the instance. The name will always exist even if the instance has not yet been created.", + "description": "[Output Only] The name of the instance. The name always exists even if the instance has not yet been created.", "type": "string" }, "preservedStateFromConfig": { @@ -62069,6 +62069,10 @@ "description": "The IPv4 address assigned to the producer instance network interface. This value will be a range in case of Serverless.", "type": "string" }, + "ipv6Address": { + "description": "The IPv6 address assigned to the producer instance network interface. This is only assigned when the stack types of both the instance network interface and the consumer subnet are IPv4_IPv6.", + "type": "string" + }, "projectIdOrNum": { "description": "The project id or number of the interface to which the IP was assigned.", "type": "string" @@ -62103,6 +62107,10 @@ "subnetwork": { "description": "The subnetwork used to assign the IP to the producer instance network interface.", "type": "string" + }, + "subnetworkCidrRange": { + "description": "[Output Only] The CIDR range of the subnet from which the IPv4 internal IP was allocated from.", + "type": "string" } }, "type": "object" diff --git a/discovery/compute-v1.json b/discovery/compute-v1.json index 5859e9b5c6..f1600a3cf0 100644 --- a/discovery/compute-v1.json +++ b/discovery/compute-v1.json @@ -13668,6 +13668,56 @@ "https://www.googleapis.com/auth/compute.readonly" ] }, + "patch": { + "description": "Patches the specified NetworkAttachment resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules.", + "flatPath": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", + "httpMethod": "PATCH", + "id": "compute.networkAttachments.patch", + "parameterOrder": [ + "project", + "region", + "networkAttachment" + ], + "parameters": { + "networkAttachment": { + "description": "Name of the NetworkAttachment resource to patch.", + "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" + }, + "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). end_interface: MixerMutationRequestBuilder", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", + "request": { + "$ref": "NetworkAttachment" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, "setIamPolicy": { "description": "Sets the access control policy on the specified resource. Replaces any existing policy.", "flatPath": "projects/{project}/regions/{region}/networkAttachments/{resource}/setIamPolicy", @@ -34780,7 +34830,7 @@ } } }, - "revision": "20230923", + "revision": "20231003", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -53746,6 +53796,10 @@ "$ref": "ManagedInstanceLastAttempt", "description": "[Output Only] Information about the last attempt to create or delete the instance." }, + "name": { + "description": "[Output Only] The name of the instance. The name always exists even if the instance has not yet been created.", + "type": "string" + }, "preservedStateFromConfig": { "$ref": "PreservedState", "description": "[Output Only] Preserved state applied from per-instance config for this instance." @@ -54392,6 +54446,10 @@ "description": "The IPv4 address assigned to the producer instance network interface. This value will be a range in case of Serverless.", "type": "string" }, + "ipv6Address": { + "description": "The IPv6 address assigned to the producer instance network interface. This is only assigned when the stack types of both the instance network interface and the consumer subnet are IPv4_IPv6.", + "type": "string" + }, "projectIdOrNum": { "description": "The project id or number of the interface to which the IP was assigned.", "type": "string" @@ -54426,6 +54484,10 @@ "subnetwork": { "description": "The subnetwork used to assign the IP to the producer instance network interface.", "type": "string" + }, + "subnetworkCidrRange": { + "description": "[Output Only] The CIDR range of the subnet from which the IPv4 internal IP was allocated from.", + "type": "string" } }, "type": "object" diff --git a/discovery/containeranalysis-v1.json b/discovery/containeranalysis-v1.json index b530807ff1..1f601418d9 100644 --- a/discovery/containeranalysis-v1.json +++ b/discovery/containeranalysis-v1.json @@ -755,7 +755,7 @@ } } }, - "revision": "20230929", + "revision": "20230922", "rootUrl": "https://containeranalysis.googleapis.com/", "schemas": { "AliasContext": { @@ -5492,6 +5492,10 @@ }, "type": "array" }, + "extraDetails": { + "description": "Occurrence-specific extra details about the vulnerability.", + "type": "string" + }, "severity": { "description": "The note provider assigned severity of this vulnerability.", "enum": [ @@ -5578,10 +5582,6 @@ ], "type": "string" }, - "extraDetails": { - "description": "Occurrence-specific extra details about the vulnerability.", - "type": "string" - }, "fixAvailable": { "description": "Output only. Whether at least one of the affected packages has a fix available.", "type": "boolean" diff --git a/discovery/containeranalysis-v1alpha1.json b/discovery/containeranalysis-v1alpha1.json index 368e07f355..76fb045108 100644 --- a/discovery/containeranalysis-v1alpha1.json +++ b/discovery/containeranalysis-v1alpha1.json @@ -1233,7 +1233,7 @@ } } }, - "revision": "20230929", + "revision": "20230922", "rootUrl": "https://containeranalysis.googleapis.com/", "schemas": { "AnalysisCompleted": { @@ -6670,10 +6670,6 @@ ], "type": "string" }, - "extraDetails": { - "description": "Occurrence-specific extra details about the vulnerability.", - "type": "string" - }, "packageIssue": { "description": "The set of affected locations and their fixes (if available) within the associated resource.", "items": { diff --git a/discovery/content-v2.1.json b/discovery/content-v2.1.json index 460061efa0..9db8ec1e0c 100644 --- a/discovery/content-v2.1.json +++ b/discovery/content-v2.1.json @@ -5523,7 +5523,7 @@ ], "parameters": { "countryCode": { - "description": "[CLDR country code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) (e.g. \"US\"), used as a filter on repricing rules.", + "description": "[CLDR country code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) (for example, \"US\"), used as a filter on repricing rules.", "location": "query", "type": "string" }, @@ -5599,7 +5599,7 @@ "repricingreports": { "methods": { "list": { - "description": "Lists the metrics report for a given Repricing rule.", + "description": "*Deprecated*: New merchants can't start using this service. Lists the metrics report for a given Repricing rule.", "flatPath": "{merchantId}/repricingrules/{ruleId}/repricingreports", "httpMethod": "GET", "id": "content.repricingrules.repricingreports.list", @@ -6488,7 +6488,7 @@ } } }, - "revision": "20231009", + "revision": "20231011", "rootUrl": "https://shoppingcontent.googleapis.com/", "schemas": { "Account": { @@ -16578,7 +16578,7 @@ "type": "object" }, "RepricingRule": { - "description": "Represents a repricing rule. A repricing rule is used by shopping serving to adjust transactable offer prices if conditions are met.", + "description": "*Deprecated*: New merchants can't start using this resource. Represents a repricing rule. A repricing rule is used by shopping serving to adjust transactable offer prices if conditions are met.", "id": "RepricingRule", "properties": { "cogsBasedRule": { @@ -16586,7 +16586,7 @@ "description": "The rule definition for TYPE_COGS_BASED. Required when the rule type is TYPE_COGS_BASED." }, "countryCode": { - "description": "Required. Immutable. [CLDR country code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) (e.g. \"US\").", + "description": "Required. Immutable. [CLDR country code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) (for example, \"US\").", "type": "string" }, "effectiveTimePeriod": { @@ -16659,7 +16659,7 @@ "type": "integer" }, "priceDelta": { - "description": "The price delta against the COGS. E.g. 2 means $2 more of the COGS.", + "description": "The price delta against the COGS. For example, 2 means $2 more of the COGS.", "type": "string" } }, @@ -16739,7 +16739,7 @@ "id": "RepricingRuleEligibleOfferMatcherStringMatcher", "properties": { "strAttributes": { - "description": "String attributes, as long as such attribute of an offer is one of the string attribute values, the offer is considered as passing the matcher. The string matcher checks an offer for inclusivity in the string attributes, not equality. Only literal string matching is supported, no regex.", + "description": "String attributes, as long as such attribute of an offer is one of the string attribute values, the offer is considered as passing the matcher. The string matcher checks an offer for inclusivity in the string attributes, not equality. Only literal string matching is supported, no regular expressions.", "items": { "type": "string" }, @@ -17784,7 +17784,7 @@ "type": "array" }, "shipmentType": { - "description": "Type of locations this service ships orders to. Acceptable values are: - \"`delivery`\" - \"`pickup`\" - \"`local_delivery`\" ", + "description": "Type of locations this service ships orders to. Acceptable values are: - \"`delivery`\" - \"`pickup`\" - \"`local_delivery`\" - \"`collection_point`\" ", "type": "string" }, "storeConfig": { diff --git a/discovery/dataproc-v1.json b/discovery/dataproc-v1.json index 85f013de8a..c21969026c 100644 --- a/discovery/dataproc-v1.json +++ b/discovery/dataproc-v1.json @@ -17,9 +17,9 @@ "documentationLink": "https://cloud.google.com/dataproc/", "endpoints": [ { + "description": "Regional Endpoint", "location": "me-central2", - "endpointUrl": "https://dataproc.me-central2.rep.googleapis.com/", - "description": "Regional Endpoint" + "endpointUrl": "https://dataproc.me-central2.rep.googleapis.com/" } ], "fullyEncodeReservedExpansion": true, diff --git a/discovery/displayvideo-v3.json b/discovery/displayvideo-v3.json index 6a2dfb9c51..e94c95f762 100644 --- a/discovery/displayvideo-v3.json +++ b/discovery/displayvideo-v3.json @@ -9127,7 +9127,7 @@ } } }, - "revision": "20231009", + "revision": "20231012", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActiveViewVideoViewabilityMetricConfig": { @@ -10139,7 +10139,7 @@ "AD_POSITION", "OPERATING_SYSTEM_ID", "MOBILE_MODEL_ID", - "EXCHANGE_ID", + "EXCHANGE", "ENVIRONMENT", "COUNTRY_ID", "CITY_ID", @@ -10153,7 +10153,7 @@ "Ad position. Value is stored in the onScreenPositionValue field of the comparison value.", "The operating system identifier. Value is stored in the int64Value field of the comparison value.", "The mobile model identifier. Value is stored in the int64Value field of the comparison value.", - "The exchange identifier. Value is stored in the int64Value field of the comparison value.", + "Exchange. Value is stored in the exchangeValue field of the comparison value.", "Serving environment. Value is stored in the environmentValue field of the comparison value.", "The country or region identifier. Value is stored in the int64Value field of the comparison value.", "The city identifier. Value is stored in the int64Value field of the comparison value.", diff --git a/discovery/dlp-v2.json b/discovery/dlp-v2.json index 9d61821caf..3257602d47 100644 --- a/discovery/dlp-v2.json +++ b/discovery/dlp-v2.json @@ -3412,7 +3412,7 @@ } } }, - "revision": "20231001", + "revision": "20231008", "rootUrl": "https://dlp.googleapis.com/", "schemas": { "GooglePrivacyDlpV2Action": { @@ -3580,7 +3580,7 @@ "id": "GooglePrivacyDlpV2BigQueryOptions", "properties": { "excludedFields": { - "description": "References to fields excluded from scanning. This allows you to skip inspection of entire columns which you know have no findings. When inspecting a table, we recommend that you inspect all columns. Otherwise, findings might be impacted because hints from excluded columns will not be used.", + "description": "References to fields excluded from scanning. This allows you to skip inspection of entire columns which you know have no findings. When inspecting a table, we recommend that you inspect all columns. Otherwise, findings might be affected because hints from excluded columns will not be used.", "items": { "$ref": "GooglePrivacyDlpV2FieldId" }, @@ -3594,7 +3594,7 @@ "type": "array" }, "includedFields": { - "description": "Limit scanning only to these fields. When inspecting a table, we recommend that you inspect all columns. Otherwise, findings might be impacted because hints from excluded columns will not be used.", + "description": "Limit scanning only to these fields. When inspecting a table, we recommend that you inspect all columns. Otherwise, findings might be affected because hints from excluded columns will not be used.", "items": { "$ref": "GooglePrivacyDlpV2FieldId" }, @@ -5283,7 +5283,7 @@ "description": "Detailed error codes and messages." }, "timestamps": { - "description": "The times the error occurred. List includes the oldest timestamp, and the last 9 ones.", + "description": "The times the error occurred. List includes the oldest timestamp and the last 9 timestamps.", "items": { "format": "google-datetime", "type": "string" @@ -6008,7 +6008,7 @@ "type": "object" }, "GooglePrivacyDlpV2InfoTypeLikelihood": { - "description": "Configuration to control custom minimum likelihoods per infotype. Used when certain infotypes need to return with higher or lower precision than the baseline, i.e. when wanting PERSON_NAME to return all possible names without lowering the precision of other infotypes.", + "description": "Configuration for setting a minimum likelihood per infotype. Used to customize the minimum likelihood level for specific infotypes in the request. For example, use this if you want to lower the precision for PERSON_NAME without lowering the precision for the other infotypes in the request.", "id": "GooglePrivacyDlpV2InfoTypeLikelihood", "properties": { "infoType": { @@ -6016,7 +6016,7 @@ "description": "Type of information the likelihood threshold applies to. Only one likelihood per info_type should be provided. If InfoTypeLikelihood does not have an info_type, the configuration fails." }, "minLikelihood": { - "description": "Only returns findings equal or above this threshold. This field is required or else the configuration fails.", + "description": "Only returns findings equal to or above this threshold. This field is required or else the configuration fails.", "enum": [ "LIKELIHOOD_UNSPECIFIED", "VERY_UNLIKELY", @@ -6167,7 +6167,7 @@ "description": "Configuration to control the number of findings returned. This is not used for data profiling. When redacting sensitive data from images, finding limits don't apply. They can cause unexpected or inconsistent results, where only some data is redacted. Don't include finding limits in RedactImage requests. Otherwise, Cloud DLP returns an error. When set within an InspectJobConfig, the specified maximum values aren't hard limits. If an inspection job reaches these limits, the job ends gradually, not abruptly. Therefore, the actual number of findings that Cloud DLP returns can be multiple times higher than these maximum values." }, "minLikelihood": { - "description": "Only returns findings equal or above this threshold. The default is POSSIBLE. See https://cloud.google.com/dlp/docs/likelihood to learn more.", + "description": "Only returns findings equal to or above this threshold. The default is POSSIBLE. In general, the highest likelihood setting yields the fewest findings in results and the lowest chance of a false positive. For more information, see [Match likelihood](https://cloud.google.com/dlp/docs/likelihood).", "enum": [ "LIKELIHOOD_UNSPECIFIED", "VERY_UNLIKELY", @@ -6187,7 +6187,7 @@ "type": "string" }, "minLikelihoodPerInfoType": { - "description": "Per infotype likelihoods. For each infotype, a user can specify a minimum likelihood, and only return that infotype if it is above that threshold. If an infotype is not included, it uses the InspectConfig min_likelihood.", + "description": "Minimum likelihood per infotype. For each infotype, a user can specify a minimum likelihood. The system only returns a finding if its likelihood is above this threshold. If this field is not set, the system uses the InspectConfig min_likelihood.", "items": { "$ref": "GooglePrivacyDlpV2InfoTypeLikelihood" }, diff --git a/discovery/gkeonprem-v1.json b/discovery/gkeonprem-v1.json index f603f58507..79dd7a4c28 100644 --- a/discovery/gkeonprem-v1.json +++ b/discovery/gkeonprem-v1.json @@ -2996,7 +2996,7 @@ } } }, - "revision": "20231004", + "revision": "20230925", "rootUrl": "https://gkeonprem.googleapis.com/", "schemas": { "Authorization": { @@ -3029,7 +3029,7 @@ "type": "object" }, "BareMetalAdminCluster": { - "description": "Resource that represents a bare metal admin cluster. LINT.IfChange", + "description": "## Resource that represents a bare metal admin cluster.", "id": "BareMetalAdminCluster", "properties": { "annotations": { @@ -3532,7 +3532,7 @@ "type": "object" }, "BareMetalCluster": { - "description": "Resource that represents a bare metal user cluster. LINT.IfChange", + "description": "Resource that represents a bare metal user cluster.", "id": "BareMetalCluster", "properties": { "adminClusterMembership": { @@ -5503,10 +5503,6 @@ "$ref": "VmwarePlatformConfig", "description": "The VMware platform configuration." }, - "preparedSecrets": { - "$ref": "VmwareAdminPreparedSecretsConfig", - "description": "The VMware admin cluster prepared secrets configuration." - }, "reconciling": { "description": "Output only. If set, there are currently changes in flight to the VMware admin cluster.", "readOnly": true, @@ -5716,17 +5712,6 @@ }, "type": "object" }, - "VmwareAdminPreparedSecretsConfig": { - "description": "VmwareAdminPreparedSecretsConfig represents configuration for admin cluster prepared secrets.", - "id": "VmwareAdminPreparedSecretsConfig", - "properties": { - "enabled": { - "description": "Whether prepared secrets is enabled.", - "type": "boolean" - } - }, - "type": "object" - }, "VmwareAdminSeesawConfig": { "description": "VmwareSeesawConfig represents configuration parameters for an already existing Seesaw load balancer. IMPORTANT: Please note that the Anthos On-Prem API will not generate or update Seesaw configurations it can only bind a pre-existing configuration to a new user cluster. IMPORTANT: When attempting to create a user cluster with a pre-existing Seesaw load balancer you will need to follow some preparation steps before calling the 'CreateVmwareCluster' API method. First you will need to create the user cluster's namespace via kubectl. The namespace will need to use the following naming convention : -gke-onprem-mgmt or -gke-onprem-mgmt depending on whether you used the 'VmwareCluster.local_name' to disambiguate collisions; for more context see the documentation of 'VmwareCluster.local_name'. Once the namespace is created you will need to create a secret resource via kubectl. This secret will contain copies of your Seesaw credentials. The Secret must be called 'user-cluster-creds' and contain Seesaw's SSH and Cert credentials. The credentials must be keyed with the following names: 'seesaw-ssh-private-key', 'seesaw-ssh-public-key', 'seesaw-ssh-ca-key', 'seesaw-ssh-ca-cert'.", "id": "VmwareAdminSeesawConfig", diff --git a/discovery/pubsub-v1.json b/discovery/pubsub-v1.json index f53009f018..cc164d3f42 100644 --- a/discovery/pubsub-v1.json +++ b/discovery/pubsub-v1.json @@ -20,8 +20,8 @@ "documentationLink": "https://cloud.google.com/pubsub/docs", "endpoints": [ { - "location": "me-central2", "endpointUrl": "https://pubsub.me-central2.rep.googleapis.com/", + "location": "me-central2", "description": "Regional Endpoint" } ], @@ -1573,7 +1573,7 @@ } } }, - "revision": "20230928", + "revision": "20231003", "rootUrl": "https://pubsub.googleapis.com/", "schemas": { "AcknowledgeRequest": { diff --git a/discovery/pubsub-v1beta1a.json b/discovery/pubsub-v1beta1a.json index e6a2c02bba..b6774f009c 100644 --- a/discovery/pubsub-v1beta1a.json +++ b/discovery/pubsub-v1beta1a.json @@ -20,8 +20,8 @@ "documentationLink": "https://cloud.google.com/pubsub/docs", "endpoints": [ { - "location": "me-central2", "endpointUrl": "https://pubsub.me-central2.rep.googleapis.com/", + "location": "me-central2", "description": "Regional Endpoint" } ], @@ -464,7 +464,7 @@ } } }, - "revision": "20230928", + "revision": "20231003", "rootUrl": "https://pubsub.googleapis.com/", "schemas": { "AcknowledgeRequest": { diff --git a/discovery/pubsub-v1beta2.json b/discovery/pubsub-v1beta2.json index c011f53288..dc42dc9df7 100644 --- a/discovery/pubsub-v1beta2.json +++ b/discovery/pubsub-v1beta2.json @@ -20,9 +20,9 @@ "documentationLink": "https://cloud.google.com/pubsub/docs", "endpoints": [ { - "description": "Regional Endpoint", + "endpointUrl": "https://pubsub.me-central2.rep.googleapis.com/", "location": "me-central2", - "endpointUrl": "https://pubsub.me-central2.rep.googleapis.com/" + "description": "Regional Endpoint" } ], "icons": { @@ -731,7 +731,7 @@ } } }, - "revision": "20230928", + "revision": "20231003", "rootUrl": "https://pubsub.googleapis.com/", "schemas": { "AcknowledgeRequest": { diff --git a/discovery/recaptchaenterprise-v1.json b/discovery/recaptchaenterprise-v1.json index f119bb6fc2..97ecf8fcef 100644 --- a/discovery/recaptchaenterprise-v1.json +++ b/discovery/recaptchaenterprise-v1.json @@ -119,7 +119,7 @@ ], "parameters": { "name": { - "description": "Required. The resource name of the Assessment, in the format \"projects/{project}/assessments/{assessment}\".", + "description": "Required. The resource name of the Assessment, in the format `projects/{project}/assessments/{assessment}`.", "location": "path", "pattern": "^projects/[^/]+/assessments/[^/]+$", "required": true, @@ -147,7 +147,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the project in which the assessment will be created, in the format \"projects/{project}\".", + "description": "Required. The name of the project in which the assessment will be created, in the format `projects/{project}`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -179,7 +179,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the project this policy will apply to, in the format \"projects/{project}\".", + "description": "Required. The name of the project this policy will apply to, in the format `projects/{project}`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -207,7 +207,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the policy to be deleted, in the format \"projects/{project}/firewallpolicies/{firewallpolicy}\".", + "description": "Required. The name of the policy to be deleted, in the format `projects/{project}/firewallpolicies/{firewallpolicy}`.", "location": "path", "pattern": "^projects/[^/]+/firewallpolicies/[^/]+$", "required": true, @@ -232,7 +232,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the requested policy, in the format \"projects/{project}/firewallpolicies/{firewallpolicy}\".", + "description": "Required. The name of the requested policy, in the format `projects/{project}/firewallpolicies/{firewallpolicy}`.", "location": "path", "pattern": "^projects/[^/]+/firewallpolicies/[^/]+$", "required": true, @@ -268,7 +268,7 @@ "type": "string" }, "parent": { - "description": "Required. The name of the project to list the policies for, in the format \"projects/{project}\".", + "description": "Required. The name of the project to list the policies for, in the format `projects/{project}`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -293,7 +293,7 @@ ], "parameters": { "name": { - "description": "The resource name for the FirewallPolicy in the format \"projects/{project}/firewallpolicies/{firewallpolicy}\".", + "description": "The resource name for the FirewallPolicy in the format `projects/{project}/firewallpolicies/{firewallpolicy}`.", "location": "path", "pattern": "^projects/[^/]+/firewallpolicies/[^/]+$", "required": true, @@ -331,7 +331,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the project in which the key will be created, in the format \"projects/{project}\".", + "description": "Required. The name of the project in which the key will be created, in the format `projects/{project}`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -359,7 +359,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the key to be deleted, in the format \"projects/{project}/keys/{key}\".", + "description": "Required. The name of the key to be deleted, in the format `projects/{project}/keys/{key}`.", "location": "path", "pattern": "^projects/[^/]+/keys/[^/]+$", "required": true, @@ -384,7 +384,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the requested key, in the format \"projects/{project}/keys/{key}\".", + "description": "Required. The name of the requested key, in the format `projects/{project}/keys/{key}`.", "location": "path", "pattern": "^projects/[^/]+/keys/[^/]+$", "required": true, @@ -409,7 +409,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the requested metrics, in the format \"projects/{project}/keys/{key}/metrics\".", + "description": "Required. The name of the requested metrics, in the format `projects/{project}/keys/{key}/metrics`.", "location": "path", "pattern": "^projects/[^/]+/keys/[^/]+/metrics$", "required": true, @@ -445,7 +445,7 @@ "type": "string" }, "parent": { - "description": "Required. The name of the project that contains the keys that will be listed, in the format \"projects/{project}\".", + "description": "Required. The name of the project that contains the keys that will be listed, in the format `projects/{project}`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -470,7 +470,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the key to be migrated, in the format \"projects/{project}/keys/{key}\".", + "description": "Required. The name of the key to be migrated, in the format `projects/{project}/keys/{key}`.", "location": "path", "pattern": "^projects/[^/]+/keys/[^/]+$", "required": true, @@ -498,7 +498,7 @@ ], "parameters": { "name": { - "description": "The resource name for the Key in the format \"projects/{project}/keys/{key}\".", + "description": "The resource name for the Key in the format `projects/{project}/keys/{key}`.", "location": "path", "pattern": "^projects/[^/]+/keys/[^/]+$", "required": true, @@ -532,7 +532,7 @@ ], "parameters": { "key": { - "description": "Required. The public key name linked to the requested secret key in the format \"projects/{project}/keys/{key}\".", + "description": "Required. The public key name linked to the requested secret key in the format `projects/{project}/keys/{key}`.", "location": "path", "pattern": "^projects/[^/]+/keys/[^/]+$", "required": true, @@ -561,7 +561,7 @@ ], "parameters": { "project": { - "description": "Required. The name of the project to search related account group memberships from. Specify the project name in the following format: \"projects/{project}\".", + "description": "Required. The name of the project to search related account group memberships from. Specify the project name in the following format: `projects/{project}`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -604,7 +604,7 @@ "type": "string" }, "parent": { - "description": "Required. The name of the project to list related account groups from, in the format \"projects/{project}\".", + "description": "Required. The name of the project to list related account groups from, in the format `projects/{project}`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -666,7 +666,7 @@ } } }, - "revision": "20230917", + "revision": "20231008", "rootUrl": "https://recaptchaenterprise.googleapis.com/", "schemas": { "GoogleCloudRecaptchaenterpriseV1AccountDefenderAssessment": { @@ -674,7 +674,7 @@ "id": "GoogleCloudRecaptchaenterpriseV1AccountDefenderAssessment", "properties": { "labels": { - "description": "Labels for this request.", + "description": "Output only. Labels for this request.", "items": { "enum": [ "ACCOUNT_DEFENDER_LABEL_UNSPECIFIED", @@ -692,6 +692,7 @@ ], "type": "string" }, + "readOnly": true, "type": "array" } }, @@ -702,14 +703,14 @@ "id": "GoogleCloudRecaptchaenterpriseV1AccountVerificationInfo", "properties": { "endpoints": { - "description": "Endpoints that can be used for identity verification.", + "description": "Optional. Endpoints that can be used for identity verification.", "items": { "$ref": "GoogleCloudRecaptchaenterpriseV1EndpointVerificationInfo" }, "type": "array" }, "languageCode": { - "description": "Language code preference for the verification message, set as a IETF BCP 47 language code.", + "description": "Optional. Language code preference for the verification message, set as a IETF BCP 47 language code.", "type": "string" }, "latestVerificationResult": { @@ -754,18 +755,18 @@ "id": "GoogleCloudRecaptchaenterpriseV1AndroidKeySettings", "properties": { "allowAllPackageNames": { - "description": "If set to true, allowed_package_names are not enforced.", + "description": "Optional. If set to true, allowed_package_names are not enforced.", "type": "boolean" }, "allowedPackageNames": { - "description": "Android package names of apps allowed to use the key. Example: 'com.companyname.appname'", + "description": "Optional. Android package names of apps allowed to use the key. Example: 'com.companyname.appname'", "items": { "type": "string" }, "type": "array" }, "supportNonGoogleAppStoreDistribution": { - "description": "Set to true for keys that are used in an Android application that is available for download in app stores in addition to the Google Play Store.", + "description": "Optional. Set to true for keys that are used in an Android application that is available for download in app stores in addition to the Google Play Store.", "type": "boolean" } }, @@ -884,23 +885,26 @@ "properties": { "accountDefenderAssessment": { "$ref": "GoogleCloudRecaptchaenterpriseV1AccountDefenderAssessment", - "description": "Assessment returned by account defender when a hashed_account_id is provided." + "description": "Output only. Assessment returned by account defender when a hashed_account_id is provided.", + "readOnly": true }, "accountVerification": { "$ref": "GoogleCloudRecaptchaenterpriseV1AccountVerificationInfo", - "description": "Account verification information for identity verification. The assessment event must include a token and site key to use this feature." + "description": "Optional. Account verification information for identity verification. The assessment event must include a token and site key to use this feature." }, "event": { "$ref": "GoogleCloudRecaptchaenterpriseV1Event", - "description": "The event being assessed." + "description": "Optional. The event being assessed." }, "firewallPolicyAssessment": { "$ref": "GoogleCloudRecaptchaenterpriseV1FirewallPolicyAssessment", - "description": "Assessment returned when firewall policies belonging to the project are evaluated using the field firewall_policy_evaluation." + "description": "Output only. Assessment returned when firewall policies belonging to the project are evaluated using the field firewall_policy_evaluation.", + "readOnly": true }, "fraudPreventionAssessment": { "$ref": "GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessment", - "description": "Assessment returned by Fraud Prevention when TransactionData is provided." + "description": "Output only. Assessment returned by Fraud Prevention when TransactionData is provided.", + "readOnly": true }, "fraudSignals": { "$ref": "GoogleCloudRecaptchaenterpriseV1FraudSignals", @@ -908,13 +912,13 @@ "readOnly": true }, "name": { - "description": "Output only. The resource name for the Assessment in the format \"projects/{project}/assessments/{assessment}\".", + "description": "Output only. The resource name for the Assessment in the format `projects/{project}/assessments/{assessment}`.", "readOnly": true, "type": "string" }, "privatePasswordLeakVerification": { "$ref": "GoogleCloudRecaptchaenterpriseV1PrivatePasswordLeakVerification", - "description": "The private password leak verification field contains the parameters that are used to to check for leaks privately without sharing user credentials." + "description": "Optional. The private password leak verification field contains the parameters that are used to to check for leaks privately without sharing user credentials." }, "riskAnalysis": { "$ref": "GoogleCloudRecaptchaenterpriseV1RiskAnalysis", @@ -1011,7 +1015,7 @@ "type": "array" }, "ja3": { - "description": "Optional. Optional JA3 fingerprint for SSL clients.", + "description": "Optional. JA3 fingerprint for SSL clients.", "type": "string" }, "requestedUri": { @@ -1095,11 +1099,11 @@ "id": "GoogleCloudRecaptchaenterpriseV1FirewallActionSetHeaderAction", "properties": { "key": { - "description": "The header key to set in the request to the backend server.", + "description": "Optional. The header key to set in the request to the backend server.", "type": "string" }, "value": { - "description": "The header value to set in the request to the backend server.", + "description": "Optional. The header value to set in the request to the backend server.", "type": "string" } }, @@ -1110,7 +1114,7 @@ "id": "GoogleCloudRecaptchaenterpriseV1FirewallActionSubstituteAction", "properties": { "path": { - "description": "The address to redirect to. The target is a relative path in the current host. Example: \"/blog/404.html\".", + "description": "Optional. The address to redirect to. The target is a relative path in the current host. Example: \"/blog/404.html\".", "type": "string" } }, @@ -1121,26 +1125,26 @@ "id": "GoogleCloudRecaptchaenterpriseV1FirewallPolicy", "properties": { "actions": { - "description": "The actions that the caller should take regarding user access. There should be at most one terminal action. A terminal action is any action that forces a response, such as AllowAction, BlockAction or SubstituteAction. Zero or more non-terminal actions such as SetHeader might be specified. A single policy can contain up to 16 actions.", + "description": "Optional. The actions that the caller should take regarding user access. There should be at most one terminal action. A terminal action is any action that forces a response, such as `AllowAction`, `BlockAction` or `SubstituteAction`. Zero or more non-terminal actions such as `SetHeader` might be specified. A single policy can contain up to 16 actions.", "items": { "$ref": "GoogleCloudRecaptchaenterpriseV1FirewallAction" }, "type": "array" }, "condition": { - "description": "A CEL (Common Expression Language) conditional expression that specifies if this policy applies to an incoming user request. If this condition evaluates to true and the requested path matched the path pattern, the associated actions should be executed by the caller. The condition string is checked for CEL syntax correctness on creation. For more information, see the [CEL spec](https://github.com/google/cel-spec) and its [language definition](https://github.com/google/cel-spec/blob/master/doc/langdef.md). A condition has a max length of 500 characters.", + "description": "Optional. A CEL (Common Expression Language) conditional expression that specifies if this policy applies to an incoming user request. If this condition evaluates to true and the requested path matched the path pattern, the associated actions should be executed by the caller. The condition string is checked for CEL syntax correctness on creation. For more information, see the [CEL spec](https://github.com/google/cel-spec) and its [language definition](https://github.com/google/cel-spec/blob/master/doc/langdef.md). A condition has a max length of 500 characters.", "type": "string" }, "description": { - "description": "A description of what this policy aims to achieve, for convenience purposes. The description can at most include 256 UTF-8 characters.", + "description": "Optional. A description of what this policy aims to achieve, for convenience purposes. The description can at most include 256 UTF-8 characters.", "type": "string" }, "name": { - "description": "The resource name for the FirewallPolicy in the format \"projects/{project}/firewallpolicies/{firewallpolicy}\".", + "description": "The resource name for the FirewallPolicy in the format `projects/{project}/firewallpolicies/{firewallpolicy}`.", "type": "string" }, "path": { - "description": "The path for which this policy applies, specified as a glob pattern. For more information on glob, see the [manual page](https://man7.org/linux/man-pages/man7/glob.7.html). A path has a max length of 200 characters.", + "description": "Optional. The path for which this policy applies, specified as a glob pattern. For more information on glob, see the [manual page](https://man7.org/linux/man-pages/man7/glob.7.html). A path has a max length of 200 characters.", "type": "string" } }, @@ -1152,7 +1156,8 @@ "properties": { "error": { "$ref": "GoogleRpcStatus", - "description": "If the processing of a policy config fails, an error will be populated and the firewall_policy will be left empty." + "description": "Output only. If the processing of a policy config fails, an error will be populated and the firewall_policy will be left empty.", + "readOnly": true }, "firewallPolicy": { "$ref": "GoogleCloudRecaptchaenterpriseV1FirewallPolicy", @@ -1168,19 +1173,23 @@ "properties": { "behavioralTrustVerdict": { "$ref": "GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessmentBehavioralTrustVerdict", - "description": "Assessment of this transaction for behavioral trust." + "description": "Output only. Assessment of this transaction for behavioral trust.", + "readOnly": true }, "cardTestingVerdict": { "$ref": "GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessmentCardTestingVerdict", - "description": "Assessment of this transaction for risk of being part of a card testing attack." + "description": "Output only. Assessment of this transaction for risk of being part of a card testing attack.", + "readOnly": true }, "stolenInstrumentVerdict": { "$ref": "GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessmentStolenInstrumentVerdict", - "description": "Assessment of this transaction for risk of a stolen instrument." + "description": "Output only. Assessment of this transaction for risk of a stolen instrument.", + "readOnly": true }, "transactionRisk": { - "description": "Probability of this transaction being fraudulent. Summarizes the combined risk of attack vectors below. Values are from 0.0 (lowest) to 1.0 (highest).", + "description": "Output only. Probability of this transaction being fraudulent. Summarizes the combined risk of attack vectors below. Values are from 0.0 (lowest) to 1.0 (highest).", "format": "float", + "readOnly": true, "type": "number" } }, @@ -1191,8 +1200,9 @@ "id": "GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessmentBehavioralTrustVerdict", "properties": { "trust": { - "description": "Probability of this transaction attempt being executed in a behaviorally trustworthy way. Values are from 0.0 (lowest) to 1.0 (highest).", + "description": "Output only. Probability of this transaction attempt being executed in a behaviorally trustworthy way. Values are from 0.0 (lowest) to 1.0 (highest).", "format": "float", + "readOnly": true, "type": "number" } }, @@ -1203,8 +1213,9 @@ "id": "GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessmentCardTestingVerdict", "properties": { "risk": { - "description": "Probability of this transaction attempt being part of a card testing attack. Values are from 0.0 (lowest) to 1.0 (highest).", + "description": "Output only. Probability of this transaction attempt being part of a card testing attack. Values are from 0.0 (lowest) to 1.0 (highest).", "format": "float", + "readOnly": true, "type": "number" } }, @@ -1215,8 +1226,9 @@ "id": "GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessmentStolenInstrumentVerdict", "properties": { "risk": { - "description": "Probability of this transaction being executed with a stolen instrument. Values are from 0.0 (lowest) to 1.0 (highest).", + "description": "Output only. Probability of this transaction being executed with a stolen instrument. Values are from 0.0 (lowest) to 1.0 (highest).", "format": "float", + "readOnly": true, "type": "number" } }, @@ -1290,11 +1302,11 @@ "id": "GoogleCloudRecaptchaenterpriseV1IOSKeySettings", "properties": { "allowAllBundleIds": { - "description": "If set to true, allowed_bundle_ids are not enforced.", + "description": "Optional. If set to true, allowed_bundle_ids are not enforced.", "type": "boolean" }, "allowedBundleIds": { - "description": "iOS bundle ids of apps allowed to use the key. Example: 'com.companyname.productname.appname'", + "description": "Optional. iOS bundle ids of apps allowed to use the key. Example: 'com.companyname.productname.appname'", "items": { "type": "string" }, @@ -1302,7 +1314,7 @@ }, "appleDeveloperId": { "$ref": "GoogleCloudRecaptchaenterpriseV1AppleDeveloperId", - "description": "Apple Developer account details for the app that is protected by the reCAPTCHA Key. reCAPTCHA Enterprise leverages platform-specific checks like Apple App Attest and Apple DeviceCheck to protect your app from abuse. Providing these fields allows reCAPTCHA Enterprise to get a better assessment of the integrity of your app." + "description": "Optional. Apple Developer account details for the app that is protected by the reCAPTCHA Key. reCAPTCHA Enterprise leverages platform-specific checks like Apple App Attest and Apple DeviceCheck to protect your app from abuse. Providing these fields allows reCAPTCHA Enterprise to get a better assessment of the integrity of your app." } }, "type": "object" @@ -1322,7 +1334,7 @@ "type": "string" }, "displayName": { - "description": "Human-readable display name of this key. Modifiable by user.", + "description": "Required. Human-readable display name of this key. Modifiable by user.", "type": "string" }, "iosSettings": { @@ -1333,20 +1345,20 @@ "additionalProperties": { "type": "string" }, - "description": "See Creating and managing labels.", + "description": "Optional. See [Creating and managing labels] (https://cloud.google.com/recaptcha-enterprise/docs/labels).", "type": "object" }, "name": { - "description": "The resource name for the Key in the format \"projects/{project}/keys/{key}\".", + "description": "The resource name for the Key in the format `projects/{project}/keys/{key}`.", "type": "string" }, "testingOptions": { "$ref": "GoogleCloudRecaptchaenterpriseV1TestingOptions", - "description": "Options for user acceptance testing." + "description": "Optional. Options for user acceptance testing." }, "wafSettings": { "$ref": "GoogleCloudRecaptchaenterpriseV1WafSettings", - "description": "Settings for WAF" + "description": "Optional. Settings for WAF" }, "webSettings": { "$ref": "GoogleCloudRecaptchaenterpriseV1WebKeySettings", @@ -1439,7 +1451,7 @@ "type": "array" }, "name": { - "description": "Output only. The name of the metrics, in the format \"projects/{project}/keys/{key}/metrics\".", + "description": "Output only. The name of the metrics, in the format `projects/{project}/keys/{key}/metrics`.", "readOnly": true, "type": "string" }, @@ -1488,7 +1500,7 @@ "type": "string" }, "lookupHashPrefix": { - "description": "Optional. Exactly 26-bit prefix of the SHA-256 hash of the canonicalized username. It is used to look up password leaks associated with that hash prefix.", + "description": "Required. Exactly 26-bit prefix of the SHA-256 hash of the canonicalized username. It is used to look up password leaks associated with that hash prefix.", "format": "byte", "type": "string" }, @@ -1544,14 +1556,15 @@ "id": "GoogleCloudRecaptchaenterpriseV1RiskAnalysis", "properties": { "extendedVerdictReasons": { - "description": "Extended verdict reasons to be used for experimentation only. The set of possible reasons is subject to change.", + "description": "Output only. Extended verdict reasons to be used for experimentation only. The set of possible reasons is subject to change.", "items": { "type": "string" }, + "readOnly": true, "type": "array" }, "reasons": { - "description": "Reasons contributing to the risk analysis verdict.", + "description": "Output only. Reasons contributing to the risk analysis verdict.", "items": { "enum": [ "CLASSIFICATION_REASON_UNSPECIFIED", @@ -1575,11 +1588,13 @@ ], "type": "string" }, + "readOnly": true, "type": "array" }, "score": { - "description": "Legitimate event score from 0.0 to 1.0. (1.0 means very likely legitimate traffic while 0.0 means very likely non-legitimate traffic).", + "description": "Output only. Legitimate event score from 0.0 to 1.0. (1.0 means very likely legitimate traffic while 0.0 means very likely non-legitimate traffic).", "format": "float", + "readOnly": true, "type": "number" } }, @@ -1662,7 +1677,7 @@ "id": "GoogleCloudRecaptchaenterpriseV1TestingOptions", "properties": { "testingChallenge": { - "description": "For challenge-based keys only (CHECKBOX, INVISIBLE), all challenge requests for this site will return nocaptcha if NOCAPTCHA, or an unsolvable challenge if CHALLENGE.", + "description": "Optional. For challenge-based keys only (CHECKBOX, INVISIBLE), all challenge requests for this site will return nocaptcha if NOCAPTCHA, or an unsolvable challenge if CHALLENGE.", "enum": [ "TESTING_CHALLENGE_UNSPECIFIED", "NOCAPTCHA", @@ -1676,7 +1691,7 @@ "type": "string" }, "testingScore": { - "description": "All assessments for this Key will return this score. Must be between 0 (likely not legitimate) and 1 (likely legitimate) inclusive.", + "description": "Optional. All assessments for this Key will return this score. Must be between 0 (likely not legitimate) and 1 (likely legitimate) inclusive.", "format": "float", "type": "number" } @@ -1688,24 +1703,28 @@ "id": "GoogleCloudRecaptchaenterpriseV1TokenProperties", "properties": { "action": { - "description": "Action name provided at token generation.", + "description": "Output only. Action name provided at token generation.", + "readOnly": true, "type": "string" }, "androidPackageName": { - "description": "The name of the Android package with which the token was generated (Android keys only).", + "description": "Output only. The name of the Android package with which the token was generated (Android keys only).", + "readOnly": true, "type": "string" }, "createTime": { - "description": "The timestamp corresponding to the generation of the token.", + "description": "Output only. The timestamp corresponding to the generation of the token.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "hostname": { - "description": "The hostname of the page on which the token was generated (Web keys only).", + "description": "Output only. The hostname of the page on which the token was generated (Web keys only).", + "readOnly": true, "type": "string" }, "invalidReason": { - "description": "Reason associated with the response when valid = false.", + "description": "Output only. Reason associated with the response when valid = false.", "enum": [ "INVALID_REASON_UNSPECIFIED", "UNKNOWN_INVALID_REASON", @@ -1724,67 +1743,70 @@ "The user verification token was not present.", "A retriable error (such as network failure) occurred on the browser. Could easily be simulated by an attacker." ], + "readOnly": true, "type": "string" }, "iosBundleId": { - "description": "The ID of the iOS bundle with which the token was generated (iOS keys only).", + "description": "Output only. The ID of the iOS bundle with which the token was generated (iOS keys only).", + "readOnly": true, "type": "string" }, "valid": { - "description": "Whether the provided user response token is valid. When valid = false, the reason could be specified in invalid_reason or it could also be due to a user failing to solve a challenge or a sitekey mismatch (i.e the sitekey used to generate the token was different than the one specified in the assessment).", + "description": "Output only. Whether the provided user response token is valid. When valid = false, the reason could be specified in invalid_reason or it could also be due to a user failing to solve a challenge or a sitekey mismatch (i.e the sitekey used to generate the token was different than the one specified in the assessment).", + "readOnly": true, "type": "boolean" } }, "type": "object" }, "GoogleCloudRecaptchaenterpriseV1TransactionData": { - "description": "Transaction data associated with a payment protected by reCAPTCHA Enterprise. All fields are optional.", + "description": "Transaction data associated with a payment protected by reCAPTCHA Enterprise.", "id": "GoogleCloudRecaptchaenterpriseV1TransactionData", "properties": { "billingAddress": { "$ref": "GoogleCloudRecaptchaenterpriseV1TransactionDataAddress", - "description": "Address associated with the payment method when applicable." + "description": "Optional. Address associated with the payment method when applicable." }, "cardBin": { - "description": "The Bank Identification Number - generally the first 6 or 8 digits of the card.", + "description": "Optional. The Bank Identification Number - generally the first 6 or 8 digits of the card.", "type": "string" }, "cardLastFour": { - "description": "The last four digits of the card.", + "description": "Optional. The last four digits of the card.", "type": "string" }, "currencyCode": { - "description": "The currency code in ISO-4217 format.", + "description": "Optional. The currency code in ISO-4217 format.", "type": "string" }, "gatewayInfo": { "$ref": "GoogleCloudRecaptchaenterpriseV1TransactionDataGatewayInfo", - "description": "Information about the payment gateway's response to the transaction." + "description": "Optional. Information about the payment gateway's response to the transaction." }, "items": { - "description": "Items purchased in this transaction.", + "description": "Optional. Items purchased in this transaction.", "items": { "$ref": "GoogleCloudRecaptchaenterpriseV1TransactionDataItem" }, "type": "array" }, "merchants": { - "description": "Information about the user or users fulfilling the transaction.", + "description": "Optional. Information about the user or users fulfilling the transaction.", "items": { "$ref": "GoogleCloudRecaptchaenterpriseV1TransactionDataUser" }, "type": "array" }, "paymentMethod": { - "description": "The payment method for the transaction. The allowed values are: * credit-card * debit-card * gift-card * processor-{name} (If a third-party is used, for example, processor-paypal) * custom-{name} (If an alternative method is used, for example, custom-crypto)", + "description": "Optional. The payment method for the transaction. The allowed values are: * credit-card * debit-card * gift-card * processor-{name} (If a third-party is used, for example, processor-paypal) * custom-{name} (If an alternative method is used, for example, custom-crypto)", "type": "string" }, "shippingAddress": { "$ref": "GoogleCloudRecaptchaenterpriseV1TransactionDataAddress", - "description": "Destination address if this transaction involves shipping a physical item." + "description": "Optional. Destination address if this transaction involves shipping a physical item." }, "shippingValue": { - "description": "The value of shipping in the specified currency. 0 for free or no shipping.", + "description": "Optional. The value of shipping in the specified currency. 0 for free or no shipping.", "format": "double", "type": "number" }, @@ -1794,10 +1816,10 @@ }, "user": { "$ref": "GoogleCloudRecaptchaenterpriseV1TransactionDataUser", - "description": "Information about the user paying/initiating the transaction." + "description": "Optional. Information about the user paying/initiating the transaction." }, "value": { - "description": "The decimal value of the transaction in the specified currency.", + "description": "Optional. The decimal value of the transaction in the specified currency.", "format": "double", "type": "number" } @@ -1809,30 +1831,30 @@ "id": "GoogleCloudRecaptchaenterpriseV1TransactionDataAddress", "properties": { "address": { - "description": "The first lines of the address. The first line generally contains the street name and number, and further lines may include information such as an apartment number.", + "description": "Optional. The first lines of the address. The first line generally contains the street name and number, and further lines may include information such as an apartment number.", "items": { "type": "string" }, "type": "array" }, "administrativeArea": { - "description": "The state, province, or otherwise administrative area of the address.", + "description": "Optional. The state, province, or otherwise administrative area of the address.", "type": "string" }, "locality": { - "description": "The town/city of the address.", + "description": "Optional. The town/city of the address.", "type": "string" }, "postalCode": { - "description": "The postal or ZIP code of the address.", + "description": "Optional. The postal or ZIP code of the address.", "type": "string" }, "recipient": { - "description": "The recipient name, potentially including information such as \"care of\".", + "description": "Optional. The recipient name, potentially including information such as \"care of\".", "type": "string" }, "regionCode": { - "description": "The CLDR country/region of the address.", + "description": "Optional. The CLDR country/region of the address.", "type": "string" } }, @@ -1843,19 +1865,19 @@ "id": "GoogleCloudRecaptchaenterpriseV1TransactionDataGatewayInfo", "properties": { "avsResponseCode": { - "description": "AVS response code from the gateway (available only when reCAPTCHA Enterprise is called after authorization).", + "description": "Optional. AVS response code from the gateway (available only when reCAPTCHA Enterprise is called after authorization).", "type": "string" }, "cvvResponseCode": { - "description": "CVV response code from the gateway (available only when reCAPTCHA Enterprise is called after authorization).", + "description": "Optional. CVV response code from the gateway (available only when reCAPTCHA Enterprise is called after authorization).", "type": "string" }, "gatewayResponseCode": { - "description": "Gateway response code describing the state of the transaction.", + "description": "Optional. Gateway response code describing the state of the transaction.", "type": "string" }, "name": { - "description": "Name of the gateway service (for example, stripe, square, paypal).", + "description": "Optional. Name of the gateway service (for example, stripe, square, paypal).", "type": "string" } }, @@ -1866,20 +1888,20 @@ "id": "GoogleCloudRecaptchaenterpriseV1TransactionDataItem", "properties": { "merchantAccountId": { - "description": "When a merchant is specified, its corresponding account_id. Necessary to populate marketplace-style transactions.", + "description": "Optional. When a merchant is specified, its corresponding account_id. Necessary to populate marketplace-style transactions.", "type": "string" }, "name": { - "description": "The full name of the item.", + "description": "Optional. The full name of the item.", "type": "string" }, "quantity": { - "description": "The quantity of this item that is being purchased.", + "description": "Optional. The quantity of this item that is being purchased.", "format": "int64", "type": "string" }, "value": { - "description": "The value per item that the user is paying, in the transaction currency, after discounts.", + "description": "Optional. The value per item that the user is paying, in the transaction currency, after discounts.", "format": "double", "type": "number" } @@ -1891,28 +1913,28 @@ "id": "GoogleCloudRecaptchaenterpriseV1TransactionDataUser", "properties": { "accountId": { - "description": "Unique account identifier for this user. If using account defender, this should match the hashed_account_id field. Otherwise, a unique and persistent identifier for this account.", + "description": "Optional. Unique account identifier for this user. If using account defender, this should match the hashed_account_id field. Otherwise, a unique and persistent identifier for this account.", "type": "string" }, "creationMs": { - "description": "The epoch milliseconds of the user's account creation.", + "description": "Optional. The epoch milliseconds of the user's account creation.", "format": "int64", "type": "string" }, "email": { - "description": "The email address of the user.", + "description": "Optional. The email address of the user.", "type": "string" }, "emailVerified": { - "description": "Whether the email has been verified to be accessible by the user (OTP or similar).", + "description": "Optional. Whether the email has been verified to be accessible by the user (OTP or similar).", "type": "boolean" }, "phoneNumber": { - "description": "The phone number of the user, with country code.", + "description": "Optional. The phone number of the user, with country code.", "type": "string" }, "phoneVerified": { - "description": "Whether the phone number has been verified to be accessible by the user (OTP or similar).", + "description": "Optional. Whether the phone number has been verified to be accessible by the user (OTP or similar).", "type": "boolean" } }, @@ -2029,22 +2051,22 @@ "id": "GoogleCloudRecaptchaenterpriseV1WebKeySettings", "properties": { "allowAllDomains": { - "description": "If set to true, it means allowed_domains will not be enforced.", + "description": "Optional. If set to true, it means allowed_domains will not be enforced.", "type": "boolean" }, "allowAmpTraffic": { - "description": "If set to true, the key can be used on AMP (Accelerated Mobile Pages) websites. This is supported only for the SCORE integration type.", + "description": "Optional. If set to true, the key can be used on AMP (Accelerated Mobile Pages) websites. This is supported only for the SCORE integration type.", "type": "boolean" }, "allowedDomains": { - "description": "Domains or subdomains of websites allowed to use the key. All subdomains of an allowed domain are automatically allowed. A valid domain requires a host and must not include any path, port, query or fragment. Examples: 'example.com' or 'subdomain.example.com'", + "description": "Optional. Domains or subdomains of websites allowed to use the key. All subdomains of an allowed domain are automatically allowed. A valid domain requires a host and must not include any path, port, query or fragment. Examples: 'example.com' or 'subdomain.example.com'", "items": { "type": "string" }, "type": "array" }, "challengeSecurityPreference": { - "description": "Settings for the frequency and difficulty at which this key triggers captcha challenges. This should only be specified for IntegrationTypes CHECKBOX and INVISIBLE.", + "description": "Optional. Settings for the frequency and difficulty at which this key triggers captcha challenges. This should only be specified for IntegrationTypes CHECKBOX and INVISIBLE.", "enum": [ "CHALLENGE_SECURITY_PREFERENCE_UNSPECIFIED", "USABILITY", diff --git a/discovery/run-v2.json b/discovery/run-v2.json index 0d5e30850e..f23c5f30c5 100644 --- a/discovery/run-v2.json +++ b/discovery/run-v2.json @@ -1115,7 +1115,7 @@ } } }, - "revision": "20231001", + "revision": "20231008", "rootUrl": "https://run.googleapis.com/", "schemas": { "GoogleCloudRunV2BinaryAuthorization": { @@ -2286,6 +2286,11 @@ "$ref": "GoogleCloudRunV2RevisionScaling", "description": "Scaling settings for this revision." }, + "scalingStatus": { + "$ref": "GoogleCloudRunV2RevisionScalingStatus", + "description": "Output only. The current effective scaling settings for the revision.", + "readOnly": true + }, "service": { "description": "Output only. The name of the parent service.", "readOnly": true, @@ -2346,6 +2351,18 @@ }, "type": "object" }, + "GoogleCloudRunV2RevisionScalingStatus": { + "description": "Effective settings for the current revision", + "id": "GoogleCloudRunV2RevisionScalingStatus", + "properties": { + "desiredMinInstanceCount": { + "description": "The current number of min instances provisioned for this revision.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, "GoogleCloudRunV2RevisionTemplate": { "description": "RevisionTemplate describes the data a revision should have when created from a template.", "id": "GoogleCloudRunV2RevisionTemplate", diff --git a/discovery/sqladmin-v1.json b/discovery/sqladmin-v1.json index 9479122b10..f88b2c61c2 100644 --- a/discovery/sqladmin-v1.json +++ b/discovery/sqladmin-v1.json @@ -1023,6 +1023,11 @@ "instance" ], "parameters": { + "failover": { + "description": "Set to true if the promote operation should attempt to re-add the original primary as a replica when it comes back online. Otherwise, if this value is false or not set, the original primary will be a standalone instance.", + "location": "query", + "type": "boolean" + }, "instance": { "description": "Cloud SQL read replica instance name.", "location": "path", @@ -1278,6 +1283,44 @@ "https://www.googleapis.com/auth/sqlservice.admin" ] }, + "switchover": { + "description": "Switches over from the primary instance to the replica instance.", + "flatPath": "v1/projects/{project}/instances/{instance}/switchover", + "httpMethod": "POST", + "id": "sql.instances.switchover", + "parameterOrder": [ + "project", + "instance" + ], + "parameters": { + "dbTimeout": { + "description": "Optional. (MySQL only) Cloud SQL instance operations timeout, which is a sum of all database operations. Default value is 10 minutes and can be modified to a maximum value of 24 hours.", + "format": "google-duration", + "location": "query", + "type": "string" + }, + "instance": { + "description": "Cloud SQL read replica instance name.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "ID of the project that contains the replica.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "v1/projects/{project}/instances/{instance}/switchover", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/sqlservice.admin" + ] + }, "truncateLog": { "description": "Truncate MySQL general and slow query log tables MySQL only.", "flatPath": "v1/projects/{project}/instances/{instance}/truncateLog", @@ -2122,7 +2165,7 @@ } } }, - "revision": "20230913", + "revision": "20231011", "rootUrl": "https://sqladmin.googleapis.com/", "schemas": { "AclEntry": { @@ -3025,7 +3068,8 @@ "description": "This field represents the report generated by the proactive database wellness job for OutOfDisk issues. * Writers: * the proactive database wellness job for OOD. * Readers: * the proactive database wellness job" }, "primaryDnsName": { - "description": "Output only. The dns name of the primary instance in a replication group.", + "deprecated": true, + "description": "Output only. DEPRECATED: please use write_endpoint instead.", "readOnly": true, "type": "string" }, @@ -3139,6 +3183,11 @@ "type": "string" }, "type": "array" + }, + "writeEndpoint": { + "description": "Output only. The dns name of the primary instance in a replication group.", + "readOnly": true, + "type": "string" } }, "type": "object" @@ -4052,14 +4101,30 @@ "description": "PSC settings for this instance." }, "requireSsl": { - "description": "Whether SSL connections over IP are enforced or not.", + "description": "LINT.IfChange(require_ssl_deprecate) Whether SSL/TLS connections over IP are enforced or not. If set to false, allow both non-SSL/non-TLS and SSL/TLS connections. For SSL/TLS connections, the client certificate will not be verified. If set to true, only allow connections encrypted with SSL/TLS and with valid client certificates. If you want to enforce SSL/TLS without enforcing the requirement for valid client certificates, use the `ssl_mode` flag instead of the legacy `require_ssl` flag. LINT.ThenChange(//depot/google3/java/com/google/storage/speckle/boss/admin/actions/InstanceUpdateAction.java:update_api_temp_fix)", "type": "boolean" + }, + "sslMode": { + "description": "Specify how SSL/TLS will be enforced in database connections. This flag is only supported for PostgreSQL. Use the legacy `require_ssl` flag for enforcing SSL/TLS in MySQL and SQL Server. But, for PostgreSQL, it is recommended to use the `ssl_mode` flag instead of the legacy `require_ssl` flag. To avoid the conflict between those flags in PostgreSQL, only the following value pairs are valid: ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED, require_ssl=false; ssl_mode=ENCRYPTED_ONLY, require_ssl=false; ssl_mode=TRUSTED_CLIENT_CERTIFICATE_REQUIRED, require_ssl=true; Note that the value of `ssl_mode` gets priority over the value of the legacy `require_ssl`. For example, for the pair `ssl_mode=ENCRYPTED_ONLY, require_ssl=false`, the `ssl_mode=ENCRYPTED_ONLY` means \"only accepts SSL connection\", while the `require_ssl=false` means \"both non-SSL and SSL connections are allowed\". The database will respect `ssl_mode` in this case and only accept SSL connections.", + "enum": [ + "SSL_MODE_UNSPECIFIED", + "ALLOW_UNENCRYPTED_AND_ENCRYPTED", + "ENCRYPTED_ONLY", + "TRUSTED_CLIENT_CERTIFICATE_REQUIRED" + ], + "enumDescriptions": [ + "SSL mode is unknown.", + "Allow non-SSL/non-TLS and SSL/TLS connections. For SSL/TLS connections, the client certificate will not be verified. When this value is used, legacy `require_ssl` flag must be false or unset to avoid the conflict between values of two flags.", + "Only allow connections encrypted with SSL/TLS. When this value is used, legacy `require_ssl` flag must be false or unset to avoid the conflict between values of two flags.", + "Only allow connections encrypted with SSL/TLS and with valid client certificates. When this value is used, legacy `require_ssl` flag must be true or unset to avoid the conflict between values of two flags." + ], + "type": "string" } }, "type": "object" }, "IpMapping": { - "description": "Database instance IP Mapping.", + "description": "Database instance IP mapping", "id": "IpMapping", "properties": { "ipAddress": { @@ -4604,6 +4669,10 @@ ], "type": "string" }, + "disallowCompromisedCredentials": { + "description": "Disallow credentials that have been previously compromised by a public data breach.", + "type": "boolean" + }, "disallowUsernameSubstring": { "description": "Disallow username as a part of the password.", "type": "boolean" @@ -4647,7 +4716,7 @@ "id": "PscConfig", "properties": { "allowedConsumerProjects": { - "description": "List of consumer projects that are allow-listed for PSC connections to this instance. This instance can be connected to with PSC from any network in these projects. Each consumer project in this list may be represented by a project number (numeric) or by a project id (alphanumeric).", + "description": "Optional. The list of consumer projects that are allow-listed for PSC connections to this instance. This instance can be connected to with PSC from any network in these projects. Each consumer project in this list may be represented by a project number (numeric) or by a project id (alphanumeric).", "items": { "type": "string" }, @@ -4664,6 +4733,10 @@ "description": "Read-replica configuration for connecting to the primary instance.", "id": "ReplicaConfiguration", "properties": { + "cascadableReplica": { + "description": "Optional. Specifies if a SQL Server replica is a cascadable replica. A cascadable replica is a SQL Server cross region replica that supports replica(s) under it.", + "type": "boolean" + }, "failoverTarget": { "description": "Specifies if the replica is the failover target. If the field is set to `true`, the replica will be designated as a failover replica. In case the primary instance fails, the replica instance will be promoted as the new primary instance. Only one replica can be specified as failover target, and the replica has to be in different zone with the primary instance.", "type": "boolean" diff --git a/discovery/sqladmin-v1beta4.json b/discovery/sqladmin-v1beta4.json index bfcbf2f7f7..bc860b41d2 100644 --- a/discovery/sqladmin-v1beta4.json +++ b/discovery/sqladmin-v1beta4.json @@ -753,7 +753,7 @@ ], "parameters": { "instance": { - "description": "Cloud SQL instance ID. This does not include the project ID.", + "description": "The Cloud SQL instance ID. This doesn't include the project ID.", "location": "path", "required": true, "type": "string" @@ -1023,6 +1023,11 @@ "instance" ], "parameters": { + "failover": { + "description": "Set to true if the promote operation should attempt to re-add the original primary as a replica when it comes back online. Otherwise, if this value is false or not set, the original primary will be a standalone instance.", + "location": "query", + "type": "boolean" + }, "instance": { "description": "Cloud SQL read replica instance name.", "location": "path", @@ -1278,6 +1283,44 @@ "https://www.googleapis.com/auth/sqlservice.admin" ] }, + "switchover": { + "description": "Switches over from the primary instance to a replica instance.", + "flatPath": "sql/v1beta4/projects/{project}/instances/{instance}/switchover", + "httpMethod": "POST", + "id": "sql.instances.switchover", + "parameterOrder": [ + "project", + "instance" + ], + "parameters": { + "dbTimeout": { + "description": "Optional. (MySQL only) Cloud SQL instance operations timeout, which is a sum of all database operations. Default value is 10 minutes and can be modified to a maximum value of 24 hours.", + "format": "google-duration", + "location": "query", + "type": "string" + }, + "instance": { + "description": "Cloud SQL read replica instance name.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "ID of the project that contains the replica.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "sql/v1beta4/projects/{project}/instances/{instance}/switchover", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/sqlservice.admin" + ] + }, "truncateLog": { "description": "Truncate MySQL general and slow query log tables MySQL only.", "flatPath": "sql/v1beta4/projects/{project}/instances/{instance}/truncateLog", @@ -2122,7 +2165,7 @@ } } }, - "revision": "20230913", + "revision": "20231011", "rootUrl": "https://sqladmin.googleapis.com/", "schemas": { "AclEntry": { @@ -3025,7 +3068,8 @@ "description": "This field represents the report generated by the proactive database wellness job for OutOfDisk issues. * Writers: * the proactive database wellness job for OOD. * Readers: * the proactive database wellness job" }, "primaryDnsName": { - "description": "Output only. The dns name of the primary instance in a replication group.", + "deprecated": true, + "description": "Output only. DEPRECATED: please use write_endpoint instead.", "readOnly": true, "type": "string" }, @@ -3139,6 +3183,11 @@ "type": "string" }, "type": "array" + }, + "writeEndpoint": { + "description": "Output only. The dns name of the primary instance in a replication group.", + "readOnly": true, + "type": "string" } }, "type": "object" @@ -4052,14 +4101,30 @@ "description": "PSC settings for this instance." }, "requireSsl": { - "description": "Whether SSL connections over IP are enforced or not.", + "description": "LINT.IfChange(require_ssl_deprecate) Whether SSL/TLS connections over IP are enforced or not. If set to false, allow both non-SSL/non-TLS and SSL/TLS connections. For SSL/TLS connections, the client certificate will not be verified. If set to true, only allow connections encrypted with SSL/TLS and with valid client certificates. If you want to enforce SSL/TLS without enforcing the requirement for valid client certificates, use the `ssl_mode` flag instead of the legacy `require_ssl` flag. LINT.ThenChange(//depot/google3/java/com/google/storage/speckle/boss/admin/actions/InstanceUpdateAction.java:update_api_temp_fix)", "type": "boolean" + }, + "sslMode": { + "description": "Specify how SSL/TLS will be enforced in database connections. This flag is only supported for PostgreSQL. Use the legacy `require_ssl` flag for enforcing SSL/TLS in MySQL and SQL Server. But, for PostgreSQL, it is recommended to use the `ssl_mode` flag instead of the legacy `require_ssl` flag. To avoid the conflict between those flags in PostgreSQL, only the following value pairs are valid: ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED, require_ssl=false; ssl_mode=ENCRYPTED_ONLY, require_ssl=false; ssl_mode=TRUSTED_CLIENT_CERTIFICATE_REQUIRED, require_ssl=true; Note that the value of `ssl_mode` gets priority over the value of the legacy `require_ssl`. For example, for the pair `ssl_mode=ENCRYPTED_ONLY, require_ssl=false`, the `ssl_mode=ENCRYPTED_ONLY` means \"only accepts SSL connection\", while the `require_ssl=false` means \"both non-SSL and SSL connections are allowed\". The database will respect `ssl_mode` in this case and only accept SSL connections.", + "enum": [ + "SSL_MODE_UNSPECIFIED", + "ALLOW_UNENCRYPTED_AND_ENCRYPTED", + "ENCRYPTED_ONLY", + "TRUSTED_CLIENT_CERTIFICATE_REQUIRED" + ], + "enumDescriptions": [ + "SSL mode is unknown.", + "Allow non-SSL/non-TLS and SSL/TLS connections. For SSL/TLS connections, the client certificate will not be verified. When this value is used, legacy `require_ssl` flag must be false or unset to avoid the conflict between values of two flags.", + "Only allow connections encrypted with SSL/TLS. When this value is used, legacy `require_ssl` flag must be false or unset to avoid the conflict between values of two flags.", + "Only allow connections encrypted with SSL/TLS and with valid client certificates. When this value is used, legacy `require_ssl` flag must be true or unset to avoid the conflict between values of two flags." + ], + "type": "string" } }, "type": "object" }, "IpMapping": { - "description": "Database instance IP Mapping.", + "description": "Database instance IP mapping", "id": "IpMapping", "properties": { "ipAddress": { @@ -4604,6 +4669,10 @@ ], "type": "string" }, + "disallowCompromisedCredentials": { + "description": "Disallow credentials that have been previously compromised by a public data breach.", + "type": "boolean" + }, "disallowUsernameSubstring": { "description": "Disallow username as a part of the password.", "type": "boolean" @@ -4647,7 +4716,7 @@ "id": "PscConfig", "properties": { "allowedConsumerProjects": { - "description": "List of consumer projects that are allow-listed for PSC connections to this instance. This instance can be connected to with PSC from any network in these projects. Each consumer project in this list may be represented by a project number (numeric) or by a project id (alphanumeric).", + "description": "Optional. The list of consumer projects that are allow-listed for PSC connections to this instance. This instance can be connected to with PSC from any network in these projects. Each consumer project in this list may be represented by a project number (numeric) or by a project id (alphanumeric).", "items": { "type": "string" }, @@ -4664,6 +4733,10 @@ "description": "Read-replica configuration for connecting to the primary instance.", "id": "ReplicaConfiguration", "properties": { + "cascadableReplica": { + "description": "Optional. Specifies if a SQL Server replica is a cascadable replica. A cascadable replica is a SQL Server cross region replica that supports replica(s) under it.", + "type": "boolean" + }, "failoverTarget": { "description": "Specifies if the replica is the failover target. If the field is set to `true` the replica will be designated as a failover replica. In case the primary instance fails, the replica instance will be promoted as the new primary instance. Only one replica can be specified as failover target, and the replica has to be in different zone with the primary instance.", "type": "boolean" diff --git a/discovery/travelimpactmodel-v1.json b/discovery/travelimpactmodel-v1.json index 0f7e663d80..29eb1f3d63 100644 --- a/discovery/travelimpactmodel-v1.json +++ b/discovery/travelimpactmodel-v1.json @@ -116,7 +116,7 @@ } } }, - "revision": "20221212", + "revision": "20231011", "rootUrl": "https://travelimpactmodel.googleapis.com/", "schemas": { "ComputeFlightEmissionsRequest": { @@ -234,7 +234,7 @@ "properties": { "emissionsGramsPerPax": { "$ref": "EmissionsGramsPerPax", - "description": "Optional. Per-passenger emission estimate numbers. Will not be present if emissions could not be computed. For the list of reasons why emissions could not be computed, see ComputeFlightEmissions." + "description": "Optional. Per-passenger emission estimate numbers. Will not be present if emissions could not be computed. For the list of reasons why emissions could not be computed, see ComputeFlightEmissions. Note this field is currently equivalent to ttw_emissions_grams_per_pax until TIM version 1.X.0 which will update this to be total wtw emissions aka wtt_emissions_grams_per_pax + ttw_emissions_grams_per_pax." }, "flight": { "$ref": "Flight", diff --git a/discovery/youtube-v3.json b/discovery/youtube-v3.json index fa47ca4f76..0164fb1c2e 100644 --- a/discovery/youtube-v3.json +++ b/discovery/youtube-v3.json @@ -717,11 +717,6 @@ "location": "query", "type": "string" }, - "forHandle": { - "description": "Return the channel associated with a YouTube handle. UNIMPLEMENTED.", - "location": "query", - "type": "string" - }, "forUsername": { "description": "Return the channel associated with a YouTube username.", "location": "query", @@ -2171,6 +2166,158 @@ } } }, + "playlistImages": { + "methods": { + "delete": { + "description": "Deletes a resource.", + "flatPath": "youtube/v3/playlistImages", + "httpMethod": "DELETE", + "id": "youtube.playlistImages.delete", + "parameterOrder": [], + "parameters": { + "id": { + "description": "Id to identify this image. This is returned from by the List method.", + "location": "query", + "type": "string" + }, + "onBehalfOfContentOwner": { + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", + "location": "query", + "type": "string" + } + }, + "path": "youtube/v3/playlistImages", + "scopes": [ + "https://www.googleapis.com/auth/youtube", + "https://www.googleapis.com/auth/youtube.force-ssl", + "https://www.googleapis.com/auth/youtubepartner" + ] + }, + "insert": { + "description": "Inserts a new resource into this collection.", + "flatPath": "youtube/v3/playlistImages", + "httpMethod": "POST", + "id": "youtube.playlistImages.insert", + "parameterOrder": [], + "parameters": { + "onBehalfOfContentOwner": { + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", + "location": "query", + "type": "string" + }, + "onBehalfOfContentOwnerChannel": { + "description": "This parameter can only be used in a properly authorized request. *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwnerChannel* parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required when a request specifies a value for the onBehalfOfContentOwner parameter, and it can only be used in conjunction with that parameter. In addition, the request must be authorized using a CMS account that is linked to the content owner that the onBehalfOfContentOwner parameter specifies. Finally, the channel that the onBehalfOfContentOwnerChannel parameter value specifies must be linked to the content owner that the onBehalfOfContentOwner parameter specifies. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and perform actions on behalf of the channel specified in the parameter value, without having to provide authentication credentials for each separate channel.", + "location": "query", + "type": "string" + }, + "part": { + "description": "The *part* parameter specifies the properties that the API response will include.", + "location": "query", + "repeated": true, + "type": "string" + } + }, + "path": "youtube/v3/playlistImages", + "request": { + "$ref": "PlaylistImage" + }, + "response": { + "$ref": "PlaylistImage" + }, + "scopes": [ + "https://www.googleapis.com/auth/youtube", + "https://www.googleapis.com/auth/youtube.force-ssl", + "https://www.googleapis.com/auth/youtubepartner" + ] + }, + "list": { + "description": "Retrieves a list of resources, possibly filtered.", + "flatPath": "youtube/v3/playlistImages", + "httpMethod": "GET", + "id": "youtube.playlistImages.list", + "parameterOrder": [], + "parameters": { + "maxResults": { + "default": "5", + "description": "The *maxResults* parameter specifies the maximum number of items that should be returned in the result set.", + "format": "uint32", + "location": "query", + "maximum": "50", + "minimum": "0", + "type": "integer" + }, + "onBehalfOfContentOwner": { + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", + "location": "query", + "type": "string" + }, + "onBehalfOfContentOwnerChannel": { + "description": "This parameter can only be used in a properly authorized request. *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwnerChannel* parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required when a request specifies a value for the onBehalfOfContentOwner parameter, and it can only be used in conjunction with that parameter. In addition, the request must be authorized using a CMS account that is linked to the content owner that the onBehalfOfContentOwner parameter specifies. Finally, the channel that the onBehalfOfContentOwnerChannel parameter value specifies must be linked to the content owner that the onBehalfOfContentOwner parameter specifies. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and perform actions on behalf of the channel specified in the parameter value, without having to provide authentication credentials for each separate channel.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Return PlaylistImages for this playlist id.", + "location": "query", + "type": "string" + }, + "part": { + "description": "The *part* parameter specifies a comma-separated list of one or more playlistImage resource properties that the API response will include. If the parameter identifies a property that contains child properties, the child properties will be included in the response.", + "location": "query", + "repeated": true, + "type": "string" + } + }, + "path": "youtube/v3/playlistImages", + "response": { + "$ref": "PlaylistImageListResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/youtube", + "https://www.googleapis.com/auth/youtube.force-ssl", + "https://www.googleapis.com/auth/youtube.readonly", + "https://www.googleapis.com/auth/youtubepartner" + ] + }, + "update": { + "description": "Updates an existing resource.", + "flatPath": "youtube/v3/playlistImages", + "httpMethod": "PUT", + "id": "youtube.playlistImages.update", + "parameterOrder": [], + "parameters": { + "onBehalfOfContentOwner": { + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", + "location": "query", + "type": "string" + }, + "part": { + "description": "The *part* parameter specifies the properties that the API response will include.", + "location": "query", + "repeated": true, + "type": "string" + } + }, + "path": "youtube/v3/playlistImages", + "request": { + "$ref": "PlaylistImage" + }, + "response": { + "$ref": "PlaylistImage" + }, + "scopes": [ + "https://www.googleapis.com/auth/youtube", + "https://www.googleapis.com/auth/youtube.force-ssl", + "https://www.googleapis.com/auth/youtubepartner" + ] + } + } + }, "playlistItems": { "methods": { "delete": { @@ -2658,11 +2805,6 @@ "location": "query", "type": "string" }, - "relatedToVideoId": { - "description": "Search related to a resource.", - "location": "query", - "type": "string" - }, "relevanceLanguage": { "description": "Return results relevant to this language.", "location": "query", @@ -3852,7 +3994,7 @@ } } }, - "revision": "20231009", + "revision": "20231011", "rootUrl": "https://youtube.googleapis.com/", "schemas": { "AbuseReport": { @@ -9544,6 +9686,84 @@ }, "type": "object" }, + "PlaylistImage": { + "id": "PlaylistImage", + "properties": { + "id": { + "description": "Identifies this resource (playlist id and image type).", + "type": "string" + }, + "kind": { + "default": "youtube#playlistImage", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#playlistImages\".", + "type": "string" + }, + "snippet": { + "$ref": "PlaylistImageSnippet" + } + }, + "type": "object" + }, + "PlaylistImageListResponse": { + "id": "PlaylistImageListResponse", + "properties": { + "items": { + "items": { + "$ref": "PlaylistImage" + }, + "type": "array" + }, + "kind": { + "default": "youtube#PlaylistImageListResponse", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#playlistImageListResponse\".", + "type": "string" + }, + "nextPageToken": { + "description": "The token that can be used as the value of the pageToken parameter to retrieve the next page in the result set.", + "type": "string" + }, + "pageInfo": { + "$ref": "PageInfo", + "description": "General pagination information." + }, + "prevPageToken": { + "description": "The token that can be used as the value of the pageToken parameter to retrieve the previous page in the result set.", + "type": "string" + } + }, + "type": "object" + }, + "PlaylistImageSnippet": { + "description": "A *playlistImage* resource identifies another resource, such as a image, that is associated with a playlist. In addition, the playlistImage resource contains details about the included resource that pertain specifically to how that resource is used in that playlist. YouTube uses playlists to identify special collections of videos for a channel, such as: - uploaded videos - favorite videos - positively rated (liked) videos - watch history To be more specific, these lists are associated with a channel, which is a collection of a person, group, or company's videos, playlists, and other YouTube information. You can retrieve the playlist IDs for each of these lists from the channel resource for a given channel. You can then use the playlistImages.list method to retrieve image data for any of those playlists. You can also add or remove images from those lists by calling the playlistImages.insert and playlistImages.delete methods.", + "id": "PlaylistImageSnippet", + "properties": { + "height": { + "description": "The image height.", + "format": "int32", + "type": "integer" + }, + "playlistId": { + "description": "The Playlist ID of the playlist this image is associated with.", + "type": "string" + }, + "type": { + "description": "The image type.", + "enum": [ + "hero" + ], + "enumDescriptions": [ + "The main image that will be used for this playlist." + ], + "type": "string" + }, + "width": { + "description": "The image width.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, "PlaylistItem": { "description": "A *playlistItem* resource identifies another resource, such as a video, that is included in a playlist. In addition, the playlistItem resource contains details about the included resource that pertain specifically to how that resource is used in that playlist. YouTube uses playlists to identify special collections of videos for a channel, such as: - uploaded videos - favorite videos - positively rated (liked) videos - watch history - watch later To be more specific, these lists are associated with a channel, which is a collection of a person, group, or company's videos, playlists, and other YouTube information. You can retrieve the playlist IDs for each of these lists from the channel resource for a given channel. You can then use the playlistItems.list method to retrieve any of those lists. You can also add or remove items from those lists by calling the playlistItems.insert and playlistItems.delete methods. For example, if a user gives a positive rating to a video, you would insert that video into the liked videos playlist for that user's channel.", "id": "PlaylistItem", diff --git a/src/apis/accesscontextmanager/v1.ts b/src/apis/accesscontextmanager/v1.ts index a8da611718..79118fc4cb 100644 --- a/src/apis/accesscontextmanager/v1.ts +++ b/src/apis/accesscontextmanager/v1.ts @@ -476,7 +476,7 @@ export namespace accesscontextmanager_v1 { name?: string | null; } /** - * Currently, a completed operation means nothing. In the future, this metadata and a completed operation may indicate that the binding has taken effect and is affecting access decisions for all users. + * Metadata of GCP Access Binding Long Running Operations. */ export interface Schema$GcpUserAccessBindingOperationMetadata {} /** diff --git a/src/apis/alloydb/v1.ts b/src/apis/alloydb/v1.ts index ab0647aa8f..585c2ccf7b 100644 --- a/src/apis/alloydb/v1.ts +++ b/src/apis/alloydb/v1.ts @@ -681,7 +681,7 @@ export namespace alloydb_v1 { */ queryInsightsConfig?: Schema$QueryInsightsInstanceConfig; /** - * Read pool instance configuration. This is required if the value of instanceType is READ_POOL. + * Read pool specific config. */ readPoolConfig?: Schema$ReadPoolConfig; /** @@ -843,7 +843,7 @@ export namespace alloydb_v1 { */ export interface Schema$NetworkConfig { /** - * Optional. Name of the allocated IP range for the private IP AlloyDB cluster, for example: "google-managed-services-default". If set, the instance IPs for this cluster will be created in the allocated range. The range name must comply with RFC 1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. Field name is intended to be consistent with Cloud SQL. + * Optional. Name of the allocated IP range for the private IP AlloyDB cluster, for example: "google-managed-services-default". If set, the instance IPs for this cluster will be created in the allocated range. The range name must comply with RFC 1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. Field name is intended to be consistent with CloudSQL. */ allocatedIpRange?: string | null; /** @@ -1187,7 +1187,7 @@ export namespace alloydb_v1 { */ description?: string | null; /** - * Required. The last time at which the event described by this signal took place + * The last time at which the event described by this signal took place */ eventTime?: string | null; /** @@ -1195,7 +1195,7 @@ export namespace alloydb_v1 { */ externalUri?: string | null; /** - * Required. The name of the signal, ex: PUBLIC_SQL_INSTANCE, SQL_LOG_ERROR_VERBOSITY etc. + * The name of the signal, ex: PUBLIC_SQL_INSTANCE, SQL_LOG_ERROR_VERBOSITY etc. */ name?: string | null; /** @@ -1207,21 +1207,17 @@ export namespace alloydb_v1 { */ resourceContainer?: string | null; /** - * Required. Database resource name associated with the signal. Resource name to follow CAIS resource_name format as noted here go/condor-common-datamodel + * Database resource name associated with the signal. Resource name to follow CAIS resource_name format as noted here go/condor-common-datamodel */ resourceName?: string | null; /** - * Required. The class of the signal, such as if it's a THREAT or VULNERABILITY. + * The class of the signal, such as if it's a THREAT or VULNERABILITY. */ signalClass?: string | null; /** - * Required. Unique identifier for the signal. This is an unique id which would be mainatined by partner to identify a signal. + * Unique identifier for the signal. This is an unique id which would be mainatined by partner to identify a signal. */ signalId?: string | null; - /** - * Required. Type of signal, for example, `AVAILABLE_IN_MULTIPLE_ZONES`, `LOGGING_MOST_ERRORS`, etc. - */ - signalType?: string | null; state?: string | null; } /** diff --git a/src/apis/androidpublisher/v3.ts b/src/apis/androidpublisher/v3.ts index 7653249f70..4e890b09a0 100644 --- a/src/apis/androidpublisher/v3.ts +++ b/src/apis/androidpublisher/v3.ts @@ -1857,7 +1857,7 @@ export namespace androidpublisher_v3 { */ export interface Schema$RegionalPriceMigrationConfig { /** - * Required. The cutoff time for historical prices that subscribers can remain paying. Subscribers who are on a price that was created before this cutoff time will be migrated to the currently-offered price. These subscribers will receive a notification that they will be paying a different price. Subscribers who do not agree to the new price will have their subscription ended at the next renewal. + * Required. The cutoff time for historical prices that subscribers can remain paying. Subscribers on prices which were available at this cutoff time or later will stay on their existing price. Subscribers on older prices will be migrated to the currently-offered price. The migrated subscribers will receive a notification that they will be paying a different price. Subscribers who do not agree to the new price will have their subscription ended at the next renewal. */ oldestAllowedPriceVersionTime?: string | null; /** @@ -11204,7 +11204,7 @@ export namespace androidpublisher_v3 { } /** - * Refunds a user's subscription or in-app purchase order. Orders older than 1 year cannot be refunded. + * Refunds a user's subscription or in-app purchase order. Orders older than 3 years cannot be refunded. * * @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 2ae5d221bc..81cc189871 100644 --- a/src/apis/compute/alpha.ts +++ b/src/apis/compute/alpha.ts @@ -6887,6 +6887,14 @@ export namespace compute_alpha { key: string ]: Schema$InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection; } | null; + /** + * Named instance selections configuring properties that the group will use when creating new VMs. + */ + instanceSelections?: { + [ + key: string + ]: Schema$InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection; + } | null; } export interface Schema$InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection { /** @@ -6983,6 +6991,10 @@ export namespace compute_alpha { * When set, defines queing parameters for the requested deferred capacity. When unset, the request starts provisioning immediately, or fails if immediate provisioning is not possible. */ queuingPolicy?: Schema$QueuingPolicy; + /** + * Requested run duration for instances that will be created by this request. If specified, the instance termination action will be performed at the end of the run duration. + */ + requestedRunDuration?: Schema$Duration; /** * The number of instances to be created by this resize request. The group's target size will be increased by this number. */ @@ -9939,7 +9951,7 @@ export namespace compute_alpha { */ lastAttempt?: Schema$ManagedInstanceLastAttempt; /** - * [Output Only] The name of the instance. The name will always exist even if the instance has not yet been created. + * [Output Only] The name of the instance. The name always exists even if the instance has not yet been created. */ name?: string | null; /** @@ -10363,6 +10375,10 @@ export namespace compute_alpha { * The subnetwork used to assign the IP to the producer instance network interface. */ subnetwork?: string | null; + /** + * [Output Only] The CIDR range of the subnet from which the IPv4 internal IP was allocated from. + */ + subnetworkCidrRange?: string | null; } export interface Schema$NetworkAttachmentList { /** @@ -12841,6 +12857,10 @@ export namespace compute_alpha { * A public advertised prefix represents an aggregated IP prefix or netblock which customers bring to cloud. The IP prefix is a single unit of route advertisement and is announced globally to the internet. */ export interface Schema$PublicAdvertisedPrefix { + /** + * [Output Only] The version of BYOIP API. + */ + byoipApiVersion?: string | null; /** * [Output Only] Creation timestamp in RFC3339 text format. */ @@ -12961,6 +12981,10 @@ export namespace compute_alpha { * The allocatable prefix length supported by this public delegated prefix. This field is optional and cannot be set for prefixes in DELEGATION mode. It cannot be set for IPv4 prefixes either, and it always defaults to 32. */ allocatablePrefixLength?: number | null; + /** + * [Output Only] The version of BYOIP API. + */ + byoipApiVersion?: string | null; /** * [Output Only] Creation timestamp in RFC3339 text format. */ @@ -17159,6 +17183,41 @@ export namespace compute_alpha { */ userLicenses?: string[] | null; } + export interface Schema$SnapshotAggregatedList { + etag?: string | null; + /** + * [Output Only] Unique identifier for the resource; defined by the server. + */ + id?: string | null; + /** + * A list of SnapshotsScopedList resources. + */ + items?: {[key: string]: Schema$SnapshotsScopedList} | null; + /** + * [Output Only] Type of resource. Always compute#snapshotAggregatedList for aggregated lists of snapshots. + */ + kind?: string | null; + /** + * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + */ + nextPageToken?: string | null; + /** + * [Output Only] Server-defined URL for this resource. + */ + selfLink?: string | null; + /** + * [Output Only] Unreachable resources. + */ + unreachables?: string[] | null; + /** + * [Output Only] Informational warning message. + */ + warning?: { + code?: string; + data?: Array<{key?: string; value?: string}>; + message?: string; + } | null; + } /** * Contains a list of Snapshot resources. */ @@ -17221,6 +17280,20 @@ export namespace compute_alpha { */ name?: string | null; } + export interface Schema$SnapshotsScopedList { + /** + * [Output Only] A list of snapshots contained in this scope. + */ + snapshots?: Schema$Snapshot[]; + /** + * [Output Only] Informational warning which replaces the list of snapshots when the list is empty. + */ + warning?: { + code?: string; + data?: Array<{key?: string; value?: string}>; + message?: string; + } | null; + } export interface Schema$SourceDiskEncryptionKey { /** * The customer-supplied encryption key of the source disk. Required if the source disk is protected by a customer-supplied encryption key. @@ -104151,6 +104224,99 @@ export namespace compute_alpha { this.context = context; } + /** + * Retrieves an aggregated list of all of the snapshots in your project across all regions and global scope. + * + * @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. + */ + aggregatedList( + params: Params$Resource$Snapshots$Aggregatedlist, + options: StreamMethodOptions + ): GaxiosPromise; + aggregatedList( + params?: Params$Resource$Snapshots$Aggregatedlist, + options?: MethodOptions + ): GaxiosPromise; + aggregatedList( + params: Params$Resource$Snapshots$Aggregatedlist, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + aggregatedList( + params: Params$Resource$Snapshots$Aggregatedlist, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + aggregatedList( + params: Params$Resource$Snapshots$Aggregatedlist, + callback: BodyResponseCallback + ): void; + aggregatedList( + callback: BodyResponseCallback + ): void; + aggregatedList( + paramsOrCallback?: + | Params$Resource$Snapshots$Aggregatedlist + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | GaxiosPromise + | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Snapshots$Aggregatedlist; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Snapshots$Aggregatedlist; + 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}/aggregated/snapshots' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + }, + options + ), + params, + requiredParams: ['project'], + pathParams: ['project'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + /** * Deletes the specified Snapshot resource. Keep in mind that deleting a single snapshot might not necessarily delete all the data on that snapshot. If any data on the snapshot that is marked for deletion is needed for subsequent snapshots, the data will be moved to the next corresponding snapshot. For more information, see Deleting snapshots. * @@ -104849,6 +105015,41 @@ export namespace compute_alpha { } } + export interface Params$Resource$Snapshots$Aggregatedlist + 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; + /** + * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + */ + includeAllScopes?: boolean; + /** + * 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; + /** + * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. + */ + returnPartialSuccess?: boolean; + /** + * + */ + serviceProjectNumber?: string; + } export interface Params$Resource$Snapshots$Delete extends StandardParameters { /** * Project ID for this request. diff --git a/src/apis/compute/beta.ts b/src/apis/compute/beta.ts index 485bf47e1c..2f4824b36d 100644 --- a/src/apis/compute/beta.ts +++ b/src/apis/compute/beta.ts @@ -9171,7 +9171,7 @@ export namespace compute_beta { */ lastAttempt?: Schema$ManagedInstanceLastAttempt; /** - * [Output Only] The name of the instance. The name will always exist even if the instance has not yet been created. + * [Output Only] The name of the instance. The name always exists even if the instance has not yet been created. */ name?: string | null; /** @@ -9506,6 +9506,10 @@ export namespace compute_beta { * The IPv4 address assigned to the producer instance network interface. This value will be a range in case of Serverless. */ ipAddress?: string | null; + /** + * The IPv6 address assigned to the producer instance network interface. This is only assigned when the stack types of both the instance network interface and the consumer subnet are IPv4_IPv6. + */ + ipv6Address?: string | null; /** * The project id or number of the interface to which the IP was assigned. */ @@ -9522,6 +9526,10 @@ export namespace compute_beta { * The subnetwork used to assign the IP to the producer instance network interface. */ subnetwork?: string | null; + /** + * [Output Only] The CIDR range of the subnet from which the IPv4 internal IP was allocated from. + */ + subnetworkCidrRange?: string | null; } export interface Schema$NetworkAttachmentList { /** diff --git a/src/apis/compute/v1.ts b/src/apis/compute/v1.ts index 6b290d3579..ea99595508 100644 --- a/src/apis/compute/v1.ts +++ b/src/apis/compute/v1.ts @@ -8142,6 +8142,10 @@ export namespace compute_v1 { * [Output Only] Information about the last attempt to create or delete the instance. */ lastAttempt?: Schema$ManagedInstanceLastAttempt; + /** + * [Output Only] The name of the instance. The name always exists even if the instance has not yet been created. + */ + name?: string | null; /** * [Output Only] Preserved state applied from per-instance config for this instance. */ @@ -8462,6 +8466,10 @@ export namespace compute_v1 { * The IPv4 address assigned to the producer instance network interface. This value will be a range in case of Serverless. */ ipAddress?: string | null; + /** + * The IPv6 address assigned to the producer instance network interface. This is only assigned when the stack types of both the instance network interface and the consumer subnet are IPv4_IPv6. + */ + ipv6Address?: string | null; /** * The project id or number of the interface to which the IP was assigned. */ @@ -8478,6 +8486,10 @@ export namespace compute_v1 { * The subnetwork used to assign the IP to the producer instance network interface. */ subnetwork?: string | null; + /** + * [Output Only] The CIDR range of the subnet from which the IPv4 internal IP was allocated from. + */ + subnetworkCidrRange?: string | null; } export interface Schema$NetworkAttachmentList { /** @@ -48747,6 +48759,93 @@ export namespace compute_v1 { } } + /** + * Patches the specified NetworkAttachment resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * + * @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$Networkattachments$Patch, + options: StreamMethodOptions + ): GaxiosPromise; + patch( + params?: Params$Resource$Networkattachments$Patch, + options?: MethodOptions + ): GaxiosPromise; + patch( + params: Params$Resource$Networkattachments$Patch, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Networkattachments$Patch, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Networkattachments$Patch, + callback: BodyResponseCallback + ): void; + patch(callback: BodyResponseCallback): void; + patch( + paramsOrCallback?: + | Params$Resource$Networkattachments$Patch + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): void | GaxiosPromise | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Networkattachments$Patch; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Networkattachments$Patch; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://compute.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/compute/v1/projects/{project}/regions/{region}/networkAttachments/{networkAttachment}' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'PATCH', + }, + options + ), + params, + requiredParams: ['project', 'region', 'networkAttachment'], + pathParams: ['networkAttachment', 'project', 'region'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + /** * Sets the access control policy on the specified resource. Replaces any existing policy. * @@ -49068,6 +49167,30 @@ export namespace compute_v1 { */ returnPartialSuccess?: boolean; } + export interface Params$Resource$Networkattachments$Patch + extends StandardParameters { + /** + * Name of the NetworkAttachment resource to patch. + */ + networkAttachment?: 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). end_interface: MixerMutationRequestBuilder + */ + requestId?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$NetworkAttachment; + } export interface Params$Resource$Networkattachments$Setiampolicy extends StandardParameters { /** diff --git a/src/apis/containeranalysis/v1.ts b/src/apis/containeranalysis/v1.ts index 0b7f313e59..e724f64b0d 100644 --- a/src/apis/containeranalysis/v1.ts +++ b/src/apis/containeranalysis/v1.ts @@ -3100,6 +3100,10 @@ export namespace containeranalysis_v1 { * Details of all known distros and packages affected by this vulnerability. */ details?: Schema$Detail[]; + /** + * Occurrence-specific extra details about the vulnerability. + */ + extraDetails?: string | null; /** * The note provider assigned severity of this vulnerability. */ @@ -3137,10 +3141,6 @@ export namespace containeranalysis_v1 { * The distro assigned severity for this vulnerability when it is available, otherwise this is the note provider assigned severity. When there are multiple PackageIssues for this vulnerability, they can have different effective severities because some might be provided by the distro while others are provided by the language ecosystem for a language pack. For this reason, it is advised to use the effective severity on the PackageIssue level. In the case where multiple PackageIssues have differing effective severities, this field should be the highest severity for any of the PackageIssues. */ effectiveSeverity?: string | null; - /** - * Occurrence-specific extra details about the vulnerability. - */ - extraDetails?: string | null; /** * Output only. Whether at least one of the affected packages has a fix available. */ diff --git a/src/apis/containeranalysis/v1alpha1.ts b/src/apis/containeranalysis/v1alpha1.ts index 6da6ea5ad2..6932de6a17 100644 --- a/src/apis/containeranalysis/v1alpha1.ts +++ b/src/apis/containeranalysis/v1alpha1.ts @@ -3647,10 +3647,6 @@ export namespace containeranalysis_v1alpha1 { * The distro assigned severity for this vulnerability when that is available and note provider assigned severity when distro has not yet assigned a severity for this vulnerability. When there are multiple package issues for this vulnerability, they can have different effective severities because some might come from the distro and some might come from installed language packs (e.g. Maven JARs or Go binaries). For this reason, it is advised to use the effective severity on the PackageIssue level, as this field may eventually be deprecated. In the case where multiple PackageIssues have different effective severities, the one set here will be the highest severity of any of the PackageIssues. */ effectiveSeverity?: string | null; - /** - * Occurrence-specific extra details about the vulnerability. - */ - extraDetails?: string | null; /** * The set of affected locations and their fixes (if available) within the associated resource. */ diff --git a/src/apis/content/v2.1.ts b/src/apis/content/v2.1.ts index a015af2315..02bbb641d3 100644 --- a/src/apis/content/v2.1.ts +++ b/src/apis/content/v2.1.ts @@ -7581,7 +7581,7 @@ export namespace content_v2_1 { buyboxWinsCount?: number | null; } /** - * Represents a repricing rule. A repricing rule is used by shopping serving to adjust transactable offer prices if conditions are met. + * *Deprecated*: New merchants can't start using this resource. Represents a repricing rule. A repricing rule is used by shopping serving to adjust transactable offer prices if conditions are met. */ export interface Schema$RepricingRule { /** @@ -7589,7 +7589,7 @@ export namespace content_v2_1 { */ cogsBasedRule?: Schema$RepricingRuleCostOfGoodsSaleRule; /** - * Required. Immutable. [CLDR country code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) (e.g. "US"). + * Required. Immutable. [CLDR country code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) (for example, "US"). */ countryCode?: string | null; /** @@ -7642,7 +7642,7 @@ export namespace content_v2_1 { */ percentageDelta?: number | null; /** - * The price delta against the COGS. E.g. 2 means $2 more of the COGS. + * The price delta against the COGS. For example, 2 means $2 more of the COGS. */ priceDelta?: string | null; } @@ -7695,7 +7695,7 @@ export namespace content_v2_1 { */ export interface Schema$RepricingRuleEligibleOfferMatcherStringMatcher { /** - * String attributes, as long as such attribute of an offer is one of the string attribute values, the offer is considered as passing the matcher. The string matcher checks an offer for inclusivity in the string attributes, not equality. Only literal string matching is supported, no regex. + * String attributes, as long as such attribute of an offer is one of the string attribute values, the offer is considered as passing the matcher. The string matcher checks an offer for inclusivity in the string attributes, not equality. Only literal string matching is supported, no regular expressions. */ strAttributes?: string[] | null; } @@ -8443,7 +8443,7 @@ export namespace content_v2_1 { */ rateGroups?: Schema$RateGroup[]; /** - * Type of locations this service ships orders to. Acceptable values are: - "`delivery`" - "`pickup`" - "`local_delivery`" + * Type of locations this service ships orders to. Acceptable values are: - "`delivery`" - "`pickup`" - "`local_delivery`" - "`collection_point`" */ shipmentType?: string | null; /** @@ -25896,7 +25896,7 @@ export namespace content_v2_1 { export interface Params$Resource$Repricingrules$List extends StandardParameters { /** - * [CLDR country code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) (e.g. "US"), used as a filter on repricing rules. + * [CLDR country code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) (for example, "US"), used as a filter on repricing rules. */ countryCode?: string; /** @@ -25940,7 +25940,7 @@ export namespace content_v2_1 { } /** - * Lists the metrics report for a given Repricing rule. + * *Deprecated*: New merchants can't start using this service. Lists the metrics report for a given Repricing rule. * * @param params - Parameters for request * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. diff --git a/src/apis/dlp/v2.ts b/src/apis/dlp/v2.ts index 6dee6fea90..59490275ba 100644 --- a/src/apis/dlp/v2.ts +++ b/src/apis/dlp/v2.ts @@ -273,7 +273,7 @@ export namespace dlp_v2 { */ export interface Schema$GooglePrivacyDlpV2BigQueryOptions { /** - * References to fields excluded from scanning. This allows you to skip inspection of entire columns which you know have no findings. When inspecting a table, we recommend that you inspect all columns. Otherwise, findings might be impacted because hints from excluded columns will not be used. + * References to fields excluded from scanning. This allows you to skip inspection of entire columns which you know have no findings. When inspecting a table, we recommend that you inspect all columns. Otherwise, findings might be affected because hints from excluded columns will not be used. */ excludedFields?: Schema$GooglePrivacyDlpV2FieldId[]; /** @@ -281,7 +281,7 @@ export namespace dlp_v2 { */ identifyingFields?: Schema$GooglePrivacyDlpV2FieldId[]; /** - * Limit scanning only to these fields. When inspecting a table, we recommend that you inspect all columns. Otherwise, findings might be impacted because hints from excluded columns will not be used. + * Limit scanning only to these fields. When inspecting a table, we recommend that you inspect all columns. Otherwise, findings might be affected because hints from excluded columns will not be used. */ includedFields?: Schema$GooglePrivacyDlpV2FieldId[]; /** @@ -1404,7 +1404,7 @@ export namespace dlp_v2 { */ details?: Schema$GoogleRpcStatus; /** - * The times the error occurred. List includes the oldest timestamp, and the last 9 ones. + * The times the error occurred. List includes the oldest timestamp and the last 9 timestamps. */ timestamps?: string[] | null; } @@ -1851,7 +1851,7 @@ export namespace dlp_v2 { versions?: Schema$GooglePrivacyDlpV2VersionDescription[]; } /** - * Configuration to control custom minimum likelihoods per infotype. Used when certain infotypes need to return with higher or lower precision than the baseline, i.e. when wanting PERSON_NAME to return all possible names without lowering the precision of other infotypes. + * Configuration for setting a minimum likelihood per infotype. Used to customize the minimum likelihood level for specific infotypes in the request. For example, use this if you want to lower the precision for PERSON_NAME without lowering the precision for the other infotypes in the request. */ export interface Schema$GooglePrivacyDlpV2InfoTypeLikelihood { /** @@ -1859,7 +1859,7 @@ export namespace dlp_v2 { */ infoType?: Schema$GooglePrivacyDlpV2InfoType; /** - * Only returns findings equal or above this threshold. This field is required or else the configuration fails. + * Only returns findings equal to or above this threshold. This field is required or else the configuration fails. */ minLikelihood?: string | null; } @@ -1953,11 +1953,11 @@ export namespace dlp_v2 { */ limits?: Schema$GooglePrivacyDlpV2FindingLimits; /** - * Only returns findings equal or above this threshold. The default is POSSIBLE. See https://cloud.google.com/dlp/docs/likelihood to learn more. + * Only returns findings equal to or above this threshold. The default is POSSIBLE. In general, the highest likelihood setting yields the fewest findings in results and the lowest chance of a false positive. For more information, see [Match likelihood](https://cloud.google.com/dlp/docs/likelihood). */ minLikelihood?: string | null; /** - * Per infotype likelihoods. For each infotype, a user can specify a minimum likelihood, and only return that infotype if it is above that threshold. If an infotype is not included, it uses the InspectConfig min_likelihood. + * Minimum likelihood per infotype. For each infotype, a user can specify a minimum likelihood. The system only returns a finding if its likelihood is above this threshold. If this field is not set, the system uses the InspectConfig min_likelihood. */ minLikelihoodPerInfoType?: Schema$GooglePrivacyDlpV2InfoTypeLikelihood[]; /** diff --git a/src/apis/gkeonprem/v1.ts b/src/apis/gkeonprem/v1.ts index 7119e7164a..862e9fefbc 100644 --- a/src/apis/gkeonprem/v1.ts +++ b/src/apis/gkeonprem/v1.ts @@ -147,7 +147,7 @@ export namespace gkeonprem_v1 { value?: string | null; } /** - * Resource that represents a bare metal admin cluster. LINT.IfChange + * ## Resource that represents a bare metal admin cluster. */ export interface Schema$BareMetalAdminCluster { /** @@ -531,7 +531,7 @@ export namespace gkeonprem_v1 { ipAddress?: string | null; } /** - * Resource that represents a bare metal user cluster. LINT.IfChange + * Resource that represents a bare metal user cluster. */ export interface Schema$BareMetalCluster { /** @@ -1917,10 +1917,6 @@ export namespace gkeonprem_v1 { * The VMware platform configuration. */ platformConfig?: Schema$VmwarePlatformConfig; - /** - * The VMware admin cluster prepared secrets configuration. - */ - preparedSecrets?: Schema$VmwareAdminPreparedSecretsConfig; /** * Output only. If set, there are currently changes in flight to the VMware admin cluster. */ @@ -2073,15 +2069,6 @@ export namespace gkeonprem_v1 { */ vcenterNetwork?: string | null; } - /** - * VmwareAdminPreparedSecretsConfig represents configuration for admin cluster prepared secrets. - */ - export interface Schema$VmwareAdminPreparedSecretsConfig { - /** - * Whether prepared secrets is enabled. - */ - enabled?: boolean | null; - } /** * VmwareSeesawConfig represents configuration parameters for an already existing Seesaw load balancer. IMPORTANT: Please note that the Anthos On-Prem API will not generate or update Seesaw configurations it can only bind a pre-existing configuration to a new user cluster. IMPORTANT: When attempting to create a user cluster with a pre-existing Seesaw load balancer you will need to follow some preparation steps before calling the 'CreateVmwareCluster' API method. First you will need to create the user cluster's namespace via kubectl. The namespace will need to use the following naming convention : -gke-onprem-mgmt or -gke-onprem-mgmt depending on whether you used the 'VmwareCluster.local_name' to disambiguate collisions; for more context see the documentation of 'VmwareCluster.local_name'. Once the namespace is created you will need to create a secret resource via kubectl. This secret will contain copies of your Seesaw credentials. The Secret must be called 'user-cluster-creds' and contain Seesaw's SSH and Cert credentials. The credentials must be keyed with the following names: 'seesaw-ssh-private-key', 'seesaw-ssh-public-key', 'seesaw-ssh-ca-key', 'seesaw-ssh-ca-cert'. */ diff --git a/src/apis/recaptchaenterprise/v1.ts b/src/apis/recaptchaenterprise/v1.ts index 116150ab5d..d39c618b6b 100644 --- a/src/apis/recaptchaenterprise/v1.ts +++ b/src/apis/recaptchaenterprise/v1.ts @@ -129,7 +129,7 @@ export namespace recaptchaenterprise_v1 { */ export interface Schema$GoogleCloudRecaptchaenterpriseV1AccountDefenderAssessment { /** - * Labels for this request. + * Output only. Labels for this request. */ labels?: string[] | null; } @@ -138,11 +138,11 @@ export namespace recaptchaenterprise_v1 { */ export interface Schema$GoogleCloudRecaptchaenterpriseV1AccountVerificationInfo { /** - * Endpoints that can be used for identity verification. + * Optional. Endpoints that can be used for identity verification. */ endpoints?: Schema$GoogleCloudRecaptchaenterpriseV1EndpointVerificationInfo[]; /** - * Language code preference for the verification message, set as a IETF BCP 47 language code. + * Optional. Language code preference for the verification message, set as a IETF BCP 47 language code. */ languageCode?: string | null; /** @@ -159,15 +159,15 @@ export namespace recaptchaenterprise_v1 { */ export interface Schema$GoogleCloudRecaptchaenterpriseV1AndroidKeySettings { /** - * If set to true, allowed_package_names are not enforced. + * Optional. If set to true, allowed_package_names are not enforced. */ allowAllPackageNames?: boolean | null; /** - * Android package names of apps allowed to use the key. Example: 'com.companyname.appname' + * Optional. Android package names of apps allowed to use the key. Example: 'com.companyname.appname' */ allowedPackageNames?: string[] | null; /** - * Set to true for keys that are used in an Android application that is available for download in app stores in addition to the Google Play Store. + * Optional. Set to true for keys that are used in an Android application that is available for download in app stores in addition to the Google Play Store. */ supportNonGoogleAppStoreDistribution?: boolean | null; } @@ -218,23 +218,23 @@ export namespace recaptchaenterprise_v1 { */ export interface Schema$GoogleCloudRecaptchaenterpriseV1Assessment { /** - * Assessment returned by account defender when a hashed_account_id is provided. + * Output only. Assessment returned by account defender when a hashed_account_id is provided. */ accountDefenderAssessment?: Schema$GoogleCloudRecaptchaenterpriseV1AccountDefenderAssessment; /** - * Account verification information for identity verification. The assessment event must include a token and site key to use this feature. + * Optional. Account verification information for identity verification. The assessment event must include a token and site key to use this feature. */ accountVerification?: Schema$GoogleCloudRecaptchaenterpriseV1AccountVerificationInfo; /** - * The event being assessed. + * Optional. The event being assessed. */ event?: Schema$GoogleCloudRecaptchaenterpriseV1Event; /** - * Assessment returned when firewall policies belonging to the project are evaluated using the field firewall_policy_evaluation. + * Output only. Assessment returned when firewall policies belonging to the project are evaluated using the field firewall_policy_evaluation. */ firewallPolicyAssessment?: Schema$GoogleCloudRecaptchaenterpriseV1FirewallPolicyAssessment; /** - * Assessment returned by Fraud Prevention when TransactionData is provided. + * Output only. Assessment returned by Fraud Prevention when TransactionData is provided. */ fraudPreventionAssessment?: Schema$GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessment; /** @@ -242,11 +242,11 @@ export namespace recaptchaenterprise_v1 { */ fraudSignals?: Schema$GoogleCloudRecaptchaenterpriseV1FraudSignals; /** - * Output only. The resource name for the Assessment in the format "projects/{project\}/assessments/{assessment\}". + * Output only. The resource name for the Assessment in the format `projects/{project\}/assessments/{assessment\}`. */ name?: string | null; /** - * The private password leak verification field contains the parameters that are used to to check for leaks privately without sharing user credentials. + * Optional. The private password leak verification field contains the parameters that are used to to check for leaks privately without sharing user credentials. */ privatePasswordLeakVerification?: Schema$GoogleCloudRecaptchaenterpriseV1PrivatePasswordLeakVerification; /** @@ -325,7 +325,7 @@ export namespace recaptchaenterprise_v1 { */ headers?: string[] | null; /** - * Optional. Optional JA3 fingerprint for SSL clients. + * Optional. JA3 fingerprint for SSL clients. */ ja3?: string | null; /** @@ -399,11 +399,11 @@ export namespace recaptchaenterprise_v1 { */ export interface Schema$GoogleCloudRecaptchaenterpriseV1FirewallActionSetHeaderAction { /** - * The header key to set in the request to the backend server. + * Optional. The header key to set in the request to the backend server. */ key?: string | null; /** - * The header value to set in the request to the backend server. + * Optional. The header value to set in the request to the backend server. */ value?: string | null; } @@ -412,7 +412,7 @@ export namespace recaptchaenterprise_v1 { */ export interface Schema$GoogleCloudRecaptchaenterpriseV1FirewallActionSubstituteAction { /** - * The address to redirect to. The target is a relative path in the current host. Example: "/blog/404.html". + * Optional. The address to redirect to. The target is a relative path in the current host. Example: "/blog/404.html". */ path?: string | null; } @@ -421,23 +421,23 @@ export namespace recaptchaenterprise_v1 { */ export interface Schema$GoogleCloudRecaptchaenterpriseV1FirewallPolicy { /** - * The actions that the caller should take regarding user access. There should be at most one terminal action. A terminal action is any action that forces a response, such as AllowAction, BlockAction or SubstituteAction. Zero or more non-terminal actions such as SetHeader might be specified. A single policy can contain up to 16 actions. + * Optional. The actions that the caller should take regarding user access. There should be at most one terminal action. A terminal action is any action that forces a response, such as `AllowAction`, `BlockAction` or `SubstituteAction`. Zero or more non-terminal actions such as `SetHeader` might be specified. A single policy can contain up to 16 actions. */ actions?: Schema$GoogleCloudRecaptchaenterpriseV1FirewallAction[]; /** - * A CEL (Common Expression Language) conditional expression that specifies if this policy applies to an incoming user request. If this condition evaluates to true and the requested path matched the path pattern, the associated actions should be executed by the caller. The condition string is checked for CEL syntax correctness on creation. For more information, see the [CEL spec](https://github.com/google/cel-spec) and its [language definition](https://github.com/google/cel-spec/blob/master/doc/langdef.md). A condition has a max length of 500 characters. + * Optional. A CEL (Common Expression Language) conditional expression that specifies if this policy applies to an incoming user request. If this condition evaluates to true and the requested path matched the path pattern, the associated actions should be executed by the caller. The condition string is checked for CEL syntax correctness on creation. For more information, see the [CEL spec](https://github.com/google/cel-spec) and its [language definition](https://github.com/google/cel-spec/blob/master/doc/langdef.md). A condition has a max length of 500 characters. */ condition?: string | null; /** - * A description of what this policy aims to achieve, for convenience purposes. The description can at most include 256 UTF-8 characters. + * Optional. A description of what this policy aims to achieve, for convenience purposes. The description can at most include 256 UTF-8 characters. */ description?: string | null; /** - * The resource name for the FirewallPolicy in the format "projects/{project\}/firewallpolicies/{firewallpolicy\}". + * The resource name for the FirewallPolicy in the format `projects/{project\}/firewallpolicies/{firewallpolicy\}`. */ name?: string | null; /** - * The path for which this policy applies, specified as a glob pattern. For more information on glob, see the [manual page](https://man7.org/linux/man-pages/man7/glob.7.html). A path has a max length of 200 characters. + * Optional. The path for which this policy applies, specified as a glob pattern. For more information on glob, see the [manual page](https://man7.org/linux/man-pages/man7/glob.7.html). A path has a max length of 200 characters. */ path?: string | null; } @@ -446,7 +446,7 @@ export namespace recaptchaenterprise_v1 { */ export interface Schema$GoogleCloudRecaptchaenterpriseV1FirewallPolicyAssessment { /** - * If the processing of a policy config fails, an error will be populated and the firewall_policy will be left empty. + * Output only. If the processing of a policy config fails, an error will be populated and the firewall_policy will be left empty. */ error?: Schema$GoogleRpcStatus; /** @@ -459,19 +459,19 @@ export namespace recaptchaenterprise_v1 { */ export interface Schema$GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessment { /** - * Assessment of this transaction for behavioral trust. + * Output only. Assessment of this transaction for behavioral trust. */ behavioralTrustVerdict?: Schema$GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessmentBehavioralTrustVerdict; /** - * Assessment of this transaction for risk of being part of a card testing attack. + * Output only. Assessment of this transaction for risk of being part of a card testing attack. */ cardTestingVerdict?: Schema$GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessmentCardTestingVerdict; /** - * Assessment of this transaction for risk of a stolen instrument. + * Output only. Assessment of this transaction for risk of a stolen instrument. */ stolenInstrumentVerdict?: Schema$GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessmentStolenInstrumentVerdict; /** - * Probability of this transaction being fraudulent. Summarizes the combined risk of attack vectors below. Values are from 0.0 (lowest) to 1.0 (highest). + * Output only. Probability of this transaction being fraudulent. Summarizes the combined risk of attack vectors below. Values are from 0.0 (lowest) to 1.0 (highest). */ transactionRisk?: number | null; } @@ -480,7 +480,7 @@ export namespace recaptchaenterprise_v1 { */ export interface Schema$GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessmentBehavioralTrustVerdict { /** - * Probability of this transaction attempt being executed in a behaviorally trustworthy way. Values are from 0.0 (lowest) to 1.0 (highest). + * Output only. Probability of this transaction attempt being executed in a behaviorally trustworthy way. Values are from 0.0 (lowest) to 1.0 (highest). */ trust?: number | null; } @@ -489,7 +489,7 @@ export namespace recaptchaenterprise_v1 { */ export interface Schema$GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessmentCardTestingVerdict { /** - * Probability of this transaction attempt being part of a card testing attack. Values are from 0.0 (lowest) to 1.0 (highest). + * Output only. Probability of this transaction attempt being part of a card testing attack. Values are from 0.0 (lowest) to 1.0 (highest). */ risk?: number | null; } @@ -498,7 +498,7 @@ export namespace recaptchaenterprise_v1 { */ export interface Schema$GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessmentStolenInstrumentVerdict { /** - * Probability of this transaction being executed with a stolen instrument. Values are from 0.0 (lowest) to 1.0 (highest). + * Output only. Probability of this transaction being executed with a stolen instrument. Values are from 0.0 (lowest) to 1.0 (highest). */ risk?: number | null; } @@ -542,15 +542,15 @@ export namespace recaptchaenterprise_v1 { */ export interface Schema$GoogleCloudRecaptchaenterpriseV1IOSKeySettings { /** - * If set to true, allowed_bundle_ids are not enforced. + * Optional. If set to true, allowed_bundle_ids are not enforced. */ allowAllBundleIds?: boolean | null; /** - * iOS bundle ids of apps allowed to use the key. Example: 'com.companyname.productname.appname' + * Optional. iOS bundle ids of apps allowed to use the key. Example: 'com.companyname.productname.appname' */ allowedBundleIds?: string[] | null; /** - * Apple Developer account details for the app that is protected by the reCAPTCHA Key. reCAPTCHA Enterprise leverages platform-specific checks like Apple App Attest and Apple DeviceCheck to protect your app from abuse. Providing these fields allows reCAPTCHA Enterprise to get a better assessment of the integrity of your app. + * Optional. Apple Developer account details for the app that is protected by the reCAPTCHA Key. reCAPTCHA Enterprise leverages platform-specific checks like Apple App Attest and Apple DeviceCheck to protect your app from abuse. Providing these fields allows reCAPTCHA Enterprise to get a better assessment of the integrity of your app. */ appleDeveloperId?: Schema$GoogleCloudRecaptchaenterpriseV1AppleDeveloperId; } @@ -567,7 +567,7 @@ export namespace recaptchaenterprise_v1 { */ createTime?: string | null; /** - * Human-readable display name of this key. Modifiable by user. + * Required. Human-readable display name of this key. Modifiable by user. */ displayName?: string | null; /** @@ -575,19 +575,19 @@ export namespace recaptchaenterprise_v1 { */ iosSettings?: Schema$GoogleCloudRecaptchaenterpriseV1IOSKeySettings; /** - * See Creating and managing labels. + * Optional. See [Creating and managing labels] (https://cloud.google.com/recaptcha-enterprise/docs/labels). */ labels?: {[key: string]: string} | null; /** - * The resource name for the Key in the format "projects/{project\}/keys/{key\}". + * The resource name for the Key in the format `projects/{project\}/keys/{key\}`. */ name?: string | null; /** - * Options for user acceptance testing. + * Optional. Options for user acceptance testing. */ testingOptions?: Schema$GoogleCloudRecaptchaenterpriseV1TestingOptions; /** - * Settings for WAF + * Optional. Settings for WAF */ wafSettings?: Schema$GoogleCloudRecaptchaenterpriseV1WafSettings; /** @@ -656,7 +656,7 @@ export namespace recaptchaenterprise_v1 { */ challengeMetrics?: Schema$GoogleCloudRecaptchaenterpriseV1ChallengeMetrics[]; /** - * Output only. The name of the metrics, in the format "projects/{project\}/keys/{key\}/metrics". + * Output only. The name of the metrics, in the format `projects/{project\}/keys/{key\}/metrics`. */ name?: string | null; /** @@ -690,7 +690,7 @@ export namespace recaptchaenterprise_v1 { */ encryptedUserCredentialsHash?: string | null; /** - * Optional. Exactly 26-bit prefix of the SHA-256 hash of the canonicalized username. It is used to look up password leaks associated with that hash prefix. + * Required. Exactly 26-bit prefix of the SHA-256 hash of the canonicalized username. It is used to look up password leaks associated with that hash prefix. */ lookupHashPrefix?: string | null; /** @@ -734,15 +734,15 @@ export namespace recaptchaenterprise_v1 { */ export interface Schema$GoogleCloudRecaptchaenterpriseV1RiskAnalysis { /** - * Extended verdict reasons to be used for experimentation only. The set of possible reasons is subject to change. + * Output only. Extended verdict reasons to be used for experimentation only. The set of possible reasons is subject to change. */ extendedVerdictReasons?: string[] | null; /** - * Reasons contributing to the risk analysis verdict. + * Output only. Reasons contributing to the risk analysis verdict. */ reasons?: string[] | null; /** - * Legitimate event score from 0.0 to 1.0. (1.0 means very likely legitimate traffic while 0.0 means very likely non-legitimate traffic). + * Output only. Legitimate event score from 0.0 to 1.0. (1.0 means very likely legitimate traffic while 0.0 means very likely non-legitimate traffic). */ score?: number | null; } @@ -805,11 +805,11 @@ export namespace recaptchaenterprise_v1 { */ export interface Schema$GoogleCloudRecaptchaenterpriseV1TestingOptions { /** - * For challenge-based keys only (CHECKBOX, INVISIBLE), all challenge requests for this site will return nocaptcha if NOCAPTCHA, or an unsolvable challenge if CHALLENGE. + * Optional. For challenge-based keys only (CHECKBOX, INVISIBLE), all challenge requests for this site will return nocaptcha if NOCAPTCHA, or an unsolvable challenge if CHALLENGE. */ testingChallenge?: string | null; /** - * All assessments for this Key will return this score. Must be between 0 (likely not legitimate) and 1 (likely legitimate) inclusive. + * Optional. All assessments for this Key will return this score. Must be between 0 (likely not legitimate) and 1 (likely legitimate) inclusive. */ testingScore?: number | null; } @@ -818,76 +818,76 @@ export namespace recaptchaenterprise_v1 { */ export interface Schema$GoogleCloudRecaptchaenterpriseV1TokenProperties { /** - * Action name provided at token generation. + * Output only. Action name provided at token generation. */ action?: string | null; /** - * The name of the Android package with which the token was generated (Android keys only). + * Output only. The name of the Android package with which the token was generated (Android keys only). */ androidPackageName?: string | null; /** - * The timestamp corresponding to the generation of the token. + * Output only. The timestamp corresponding to the generation of the token. */ createTime?: string | null; /** - * The hostname of the page on which the token was generated (Web keys only). + * Output only. The hostname of the page on which the token was generated (Web keys only). */ hostname?: string | null; /** - * Reason associated with the response when valid = false. + * Output only. Reason associated with the response when valid = false. */ invalidReason?: string | null; /** - * The ID of the iOS bundle with which the token was generated (iOS keys only). + * Output only. The ID of the iOS bundle with which the token was generated (iOS keys only). */ iosBundleId?: string | null; /** - * Whether the provided user response token is valid. When valid = false, the reason could be specified in invalid_reason or it could also be due to a user failing to solve a challenge or a sitekey mismatch (i.e the sitekey used to generate the token was different than the one specified in the assessment). + * Output only. Whether the provided user response token is valid. When valid = false, the reason could be specified in invalid_reason or it could also be due to a user failing to solve a challenge or a sitekey mismatch (i.e the sitekey used to generate the token was different than the one specified in the assessment). */ valid?: boolean | null; } /** - * Transaction data associated with a payment protected by reCAPTCHA Enterprise. All fields are optional. + * Transaction data associated with a payment protected by reCAPTCHA Enterprise. */ export interface Schema$GoogleCloudRecaptchaenterpriseV1TransactionData { /** - * Address associated with the payment method when applicable. + * Optional. Address associated with the payment method when applicable. */ billingAddress?: Schema$GoogleCloudRecaptchaenterpriseV1TransactionDataAddress; /** - * The Bank Identification Number - generally the first 6 or 8 digits of the card. + * Optional. The Bank Identification Number - generally the first 6 or 8 digits of the card. */ cardBin?: string | null; /** - * The last four digits of the card. + * Optional. The last four digits of the card. */ cardLastFour?: string | null; /** - * The currency code in ISO-4217 format. + * Optional. The currency code in ISO-4217 format. */ currencyCode?: string | null; /** - * Information about the payment gateway's response to the transaction. + * Optional. Information about the payment gateway's response to the transaction. */ gatewayInfo?: Schema$GoogleCloudRecaptchaenterpriseV1TransactionDataGatewayInfo; /** - * Items purchased in this transaction. + * Optional. Items purchased in this transaction. */ items?: Schema$GoogleCloudRecaptchaenterpriseV1TransactionDataItem[]; /** - * Information about the user or users fulfilling the transaction. + * Optional. Information about the user or users fulfilling the transaction. */ merchants?: Schema$GoogleCloudRecaptchaenterpriseV1TransactionDataUser[]; /** - * The payment method for the transaction. The allowed values are: * credit-card * debit-card * gift-card * processor-{name\} (If a third-party is used, for example, processor-paypal) * custom-{name\} (If an alternative method is used, for example, custom-crypto) + * Optional. The payment method for the transaction. The allowed values are: * credit-card * debit-card * gift-card * processor-{name\} (If a third-party is used, for example, processor-paypal) * custom-{name\} (If an alternative method is used, for example, custom-crypto) */ paymentMethod?: string | null; /** - * Destination address if this transaction involves shipping a physical item. + * Optional. Destination address if this transaction involves shipping a physical item. */ shippingAddress?: Schema$GoogleCloudRecaptchaenterpriseV1TransactionDataAddress; /** - * The value of shipping in the specified currency. 0 for free or no shipping. + * Optional. The value of shipping in the specified currency. 0 for free or no shipping. */ shippingValue?: number | null; /** @@ -895,11 +895,11 @@ export namespace recaptchaenterprise_v1 { */ transactionId?: string | null; /** - * Information about the user paying/initiating the transaction. + * Optional. Information about the user paying/initiating the transaction. */ user?: Schema$GoogleCloudRecaptchaenterpriseV1TransactionDataUser; /** - * The decimal value of the transaction in the specified currency. + * Optional. The decimal value of the transaction in the specified currency. */ value?: number | null; } @@ -908,27 +908,27 @@ export namespace recaptchaenterprise_v1 { */ export interface Schema$GoogleCloudRecaptchaenterpriseV1TransactionDataAddress { /** - * The first lines of the address. The first line generally contains the street name and number, and further lines may include information such as an apartment number. + * Optional. The first lines of the address. The first line generally contains the street name and number, and further lines may include information such as an apartment number. */ address?: string[] | null; /** - * The state, province, or otherwise administrative area of the address. + * Optional. The state, province, or otherwise administrative area of the address. */ administrativeArea?: string | null; /** - * The town/city of the address. + * Optional. The town/city of the address. */ locality?: string | null; /** - * The postal or ZIP code of the address. + * Optional. The postal or ZIP code of the address. */ postalCode?: string | null; /** - * The recipient name, potentially including information such as "care of". + * Optional. The recipient name, potentially including information such as "care of". */ recipient?: string | null; /** - * The CLDR country/region of the address. + * Optional. The CLDR country/region of the address. */ regionCode?: string | null; } @@ -937,19 +937,19 @@ export namespace recaptchaenterprise_v1 { */ export interface Schema$GoogleCloudRecaptchaenterpriseV1TransactionDataGatewayInfo { /** - * AVS response code from the gateway (available only when reCAPTCHA Enterprise is called after authorization). + * Optional. AVS response code from the gateway (available only when reCAPTCHA Enterprise is called after authorization). */ avsResponseCode?: string | null; /** - * CVV response code from the gateway (available only when reCAPTCHA Enterprise is called after authorization). + * Optional. CVV response code from the gateway (available only when reCAPTCHA Enterprise is called after authorization). */ cvvResponseCode?: string | null; /** - * Gateway response code describing the state of the transaction. + * Optional. Gateway response code describing the state of the transaction. */ gatewayResponseCode?: string | null; /** - * Name of the gateway service (for example, stripe, square, paypal). + * Optional. Name of the gateway service (for example, stripe, square, paypal). */ name?: string | null; } @@ -958,19 +958,19 @@ export namespace recaptchaenterprise_v1 { */ export interface Schema$GoogleCloudRecaptchaenterpriseV1TransactionDataItem { /** - * When a merchant is specified, its corresponding account_id. Necessary to populate marketplace-style transactions. + * Optional. When a merchant is specified, its corresponding account_id. Necessary to populate marketplace-style transactions. */ merchantAccountId?: string | null; /** - * The full name of the item. + * Optional. The full name of the item. */ name?: string | null; /** - * The quantity of this item that is being purchased. + * Optional. The quantity of this item that is being purchased. */ quantity?: string | null; /** - * The value per item that the user is paying, in the transaction currency, after discounts. + * Optional. The value per item that the user is paying, in the transaction currency, after discounts. */ value?: number | null; } @@ -979,27 +979,27 @@ export namespace recaptchaenterprise_v1 { */ export interface Schema$GoogleCloudRecaptchaenterpriseV1TransactionDataUser { /** - * Unique account identifier for this user. If using account defender, this should match the hashed_account_id field. Otherwise, a unique and persistent identifier for this account. + * Optional. Unique account identifier for this user. If using account defender, this should match the hashed_account_id field. Otherwise, a unique and persistent identifier for this account. */ accountId?: string | null; /** - * The epoch milliseconds of the user's account creation. + * Optional. The epoch milliseconds of the user's account creation. */ creationMs?: string | null; /** - * The email address of the user. + * Optional. The email address of the user. */ email?: string | null; /** - * Whether the email has been verified to be accessible by the user (OTP or similar). + * Optional. Whether the email has been verified to be accessible by the user (OTP or similar). */ emailVerified?: boolean | null; /** - * The phone number of the user, with country code. + * Optional. The phone number of the user, with country code. */ phoneNumber?: string | null; /** - * Whether the phone number has been verified to be accessible by the user (OTP or similar). + * Optional. Whether the phone number has been verified to be accessible by the user (OTP or similar). */ phoneVerified?: boolean | null; } @@ -1042,19 +1042,19 @@ export namespace recaptchaenterprise_v1 { */ export interface Schema$GoogleCloudRecaptchaenterpriseV1WebKeySettings { /** - * If set to true, it means allowed_domains will not be enforced. + * Optional. If set to true, it means allowed_domains will not be enforced. */ allowAllDomains?: boolean | null; /** - * If set to true, the key can be used on AMP (Accelerated Mobile Pages) websites. This is supported only for the SCORE integration type. + * Optional. If set to true, the key can be used on AMP (Accelerated Mobile Pages) websites. This is supported only for the SCORE integration type. */ allowAmpTraffic?: boolean | null; /** - * Domains or subdomains of websites allowed to use the key. All subdomains of an allowed domain are automatically allowed. A valid domain requires a host and must not include any path, port, query or fragment. Examples: 'example.com' or 'subdomain.example.com' + * Optional. Domains or subdomains of websites allowed to use the key. All subdomains of an allowed domain are automatically allowed. A valid domain requires a host and must not include any path, port, query or fragment. Examples: 'example.com' or 'subdomain.example.com' */ allowedDomains?: string[] | null; /** - * Settings for the frequency and difficulty at which this key triggers captcha challenges. This should only be specified for IntegrationTypes CHECKBOX and INVISIBLE. + * Optional. Settings for the frequency and difficulty at which this key triggers captcha challenges. This should only be specified for IntegrationTypes CHECKBOX and INVISIBLE. */ challengeSecurityPreference?: string | null; /** @@ -1310,7 +1310,7 @@ export namespace recaptchaenterprise_v1 { export interface Params$Resource$Projects$Assessments$Annotate extends StandardParameters { /** - * Required. The resource name of the Assessment, in the format "projects/{project\}/assessments/{assessment\}". + * Required. The resource name of the Assessment, in the format `projects/{project\}/assessments/{assessment\}`. */ name?: string; @@ -1322,7 +1322,7 @@ export namespace recaptchaenterprise_v1 { export interface Params$Resource$Projects$Assessments$Create extends StandardParameters { /** - * Required. The name of the project in which the assessment will be created, in the format "projects/{project\}". + * Required. The name of the project in which the assessment will be created, in the format `projects/{project\}`. */ parent?: string; @@ -1812,7 +1812,7 @@ export namespace recaptchaenterprise_v1 { export interface Params$Resource$Projects$Firewallpolicies$Create extends StandardParameters { /** - * Required. The name of the project this policy will apply to, in the format "projects/{project\}". + * Required. The name of the project this policy will apply to, in the format `projects/{project\}`. */ parent?: string; @@ -1824,14 +1824,14 @@ export namespace recaptchaenterprise_v1 { export interface Params$Resource$Projects$Firewallpolicies$Delete extends StandardParameters { /** - * Required. The name of the policy to be deleted, in the format "projects/{project\}/firewallpolicies/{firewallpolicy\}". + * Required. The name of the policy to be deleted, in the format `projects/{project\}/firewallpolicies/{firewallpolicy\}`. */ name?: string; } export interface Params$Resource$Projects$Firewallpolicies$Get extends StandardParameters { /** - * Required. The name of the requested policy, in the format "projects/{project\}/firewallpolicies/{firewallpolicy\}". + * Required. The name of the requested policy, in the format `projects/{project\}/firewallpolicies/{firewallpolicy\}`. */ name?: string; } @@ -1846,14 +1846,14 @@ export namespace recaptchaenterprise_v1 { */ pageToken?: string; /** - * Required. The name of the project to list the policies for, in the format "projects/{project\}". + * Required. The name of the project to list the policies for, in the format `projects/{project\}`. */ parent?: string; } export interface Params$Resource$Projects$Firewallpolicies$Patch extends StandardParameters { /** - * The resource name for the FirewallPolicy in the format "projects/{project\}/firewallpolicies/{firewallpolicy\}". + * The resource name for the FirewallPolicy in the format `projects/{project\}/firewallpolicies/{firewallpolicy\}`. */ name?: string; /** @@ -2629,7 +2629,7 @@ export namespace recaptchaenterprise_v1 { export interface Params$Resource$Projects$Keys$Create extends StandardParameters { /** - * Required. The name of the project in which the key will be created, in the format "projects/{project\}". + * Required. The name of the project in which the key will be created, in the format `projects/{project\}`. */ parent?: string; @@ -2641,21 +2641,21 @@ export namespace recaptchaenterprise_v1 { export interface Params$Resource$Projects$Keys$Delete extends StandardParameters { /** - * Required. The name of the key to be deleted, in the format "projects/{project\}/keys/{key\}". + * Required. The name of the key to be deleted, in the format `projects/{project\}/keys/{key\}`. */ name?: string; } export interface Params$Resource$Projects$Keys$Get extends StandardParameters { /** - * Required. The name of the requested key, in the format "projects/{project\}/keys/{key\}". + * Required. The name of the requested key, in the format `projects/{project\}/keys/{key\}`. */ name?: string; } export interface Params$Resource$Projects$Keys$Getmetrics extends StandardParameters { /** - * Required. The name of the requested metrics, in the format "projects/{project\}/keys/{key\}/metrics". + * Required. The name of the requested metrics, in the format `projects/{project\}/keys/{key\}/metrics`. */ name?: string; } @@ -2670,14 +2670,14 @@ export namespace recaptchaenterprise_v1 { */ pageToken?: string; /** - * Required. The name of the project that contains the keys that will be listed, in the format "projects/{project\}". + * Required. The name of the project that contains the keys that will be listed, in the format `projects/{project\}`. */ parent?: string; } export interface Params$Resource$Projects$Keys$Migrate extends StandardParameters { /** - * Required. The name of the key to be migrated, in the format "projects/{project\}/keys/{key\}". + * Required. The name of the key to be migrated, in the format `projects/{project\}/keys/{key\}`. */ name?: string; @@ -2689,7 +2689,7 @@ export namespace recaptchaenterprise_v1 { export interface Params$Resource$Projects$Keys$Patch extends StandardParameters { /** - * The resource name for the Key in the format "projects/{project\}/keys/{key\}". + * The resource name for the Key in the format `projects/{project\}/keys/{key\}`. */ name?: string; /** @@ -2705,7 +2705,7 @@ export namespace recaptchaenterprise_v1 { export interface Params$Resource$Projects$Keys$Retrievelegacysecretkey extends StandardParameters { /** - * Required. The public key name linked to the requested secret key in the format "projects/{project\}/keys/{key\}". + * Required. The public key name linked to the requested secret key in the format `projects/{project\}/keys/{key\}`. */ key?: string; } @@ -2817,7 +2817,7 @@ export namespace recaptchaenterprise_v1 { export interface Params$Resource$Projects$Relatedaccountgroupmemberships$Search extends StandardParameters { /** - * Required. The name of the project to search related account group memberships from. Specify the project name in the following format: "projects/{project\}". + * Required. The name of the project to search related account group memberships from. Specify the project name in the following format: `projects/{project\}`. */ project?: string; @@ -2946,7 +2946,7 @@ export namespace recaptchaenterprise_v1 { */ pageToken?: string; /** - * Required. The name of the project to list related account groups from, in the format "projects/{project\}". + * Required. The name of the project to list related account groups from, in the format `projects/{project\}`. */ parent?: string; } diff --git a/src/apis/run/v2.ts b/src/apis/run/v2.ts index 2ad1265fa0..57f66a60a5 100644 --- a/src/apis/run/v2.ts +++ b/src/apis/run/v2.ts @@ -858,6 +858,10 @@ export namespace run_v2 { * Scaling settings for this revision. */ scaling?: Schema$GoogleCloudRunV2RevisionScaling; + /** + * Output only. The current effective scaling settings for the revision. + */ + scalingStatus?: Schema$GoogleCloudRunV2RevisionScalingStatus; /** * Output only. The name of the parent service. */ @@ -904,6 +908,15 @@ export namespace run_v2 { */ minInstanceCount?: number | null; } + /** + * Effective settings for the current revision + */ + export interface Schema$GoogleCloudRunV2RevisionScalingStatus { + /** + * The current number of min instances provisioned for this revision. + */ + desiredMinInstanceCount?: number | null; + } /** * RevisionTemplate describes the data a revision should have when created from a template. */ diff --git a/src/apis/sqladmin/v1.ts b/src/apis/sqladmin/v1.ts index a674a3586e..0f7c5174f1 100644 --- a/src/apis/sqladmin/v1.ts +++ b/src/apis/sqladmin/v1.ts @@ -598,7 +598,7 @@ export namespace sqladmin_v1 { */ outOfDiskReport?: Schema$SqlOutOfDiskReport; /** - * Output only. The dns name of the primary instance in a replication group. + * Output only. DEPRECATED: please use write_endpoint instead. */ primaryDnsName?: string | null; /** @@ -661,6 +661,10 @@ export namespace sqladmin_v1 { * If the instance state is SUSPENDED, the reason for the suspension. */ suspensionReason?: string[] | null; + /** + * Output only. The dns name of the primary instance in a replication group. + */ + writeEndpoint?: string | null; } /** * Database list response. @@ -1191,12 +1195,16 @@ export namespace sqladmin_v1 { */ pscConfig?: Schema$PscConfig; /** - * Whether SSL connections over IP are enforced or not. + * LINT.IfChange(require_ssl_deprecate) Whether SSL/TLS connections over IP are enforced or not. If set to false, allow both non-SSL/non-TLS and SSL/TLS connections. For SSL/TLS connections, the client certificate will not be verified. If set to true, only allow connections encrypted with SSL/TLS and with valid client certificates. If you want to enforce SSL/TLS without enforcing the requirement for valid client certificates, use the `ssl_mode` flag instead of the legacy `require_ssl` flag. LINT.ThenChange(//depot/google3/java/com/google/storage/speckle/boss/admin/actions/InstanceUpdateAction.java:update_api_temp_fix) */ requireSsl?: boolean | null; + /** + * Specify how SSL/TLS will be enforced in database connections. This flag is only supported for PostgreSQL. Use the legacy `require_ssl` flag for enforcing SSL/TLS in MySQL and SQL Server. But, for PostgreSQL, it is recommended to use the `ssl_mode` flag instead of the legacy `require_ssl` flag. To avoid the conflict between those flags in PostgreSQL, only the following value pairs are valid: ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED, require_ssl=false; ssl_mode=ENCRYPTED_ONLY, require_ssl=false; ssl_mode=TRUSTED_CLIENT_CERTIFICATE_REQUIRED, require_ssl=true; Note that the value of `ssl_mode` gets priority over the value of the legacy `require_ssl`. For example, for the pair `ssl_mode=ENCRYPTED_ONLY, require_ssl=false`, the `ssl_mode=ENCRYPTED_ONLY` means "only accepts SSL connection", while the `require_ssl=false` means "both non-SSL and SSL connections are allowed". The database will respect `ssl_mode` in this case and only accept SSL connections. + */ + sslMode?: string | null; } /** - * Database instance IP Mapping. + * Database instance IP mapping */ export interface Schema$IpMapping { /** @@ -1520,6 +1528,10 @@ export namespace sqladmin_v1 { * The complexity of the password. */ complexity?: string | null; + /** + * Disallow credentials that have been previously compromised by a public data breach. + */ + disallowCompromisedCredentials?: boolean | null; /** * Disallow username as a part of the password. */ @@ -1555,7 +1567,7 @@ export namespace sqladmin_v1 { */ export interface Schema$PscConfig { /** - * List of consumer projects that are allow-listed for PSC connections to this instance. This instance can be connected to with PSC from any network in these projects. Each consumer project in this list may be represented by a project number (numeric) or by a project id (alphanumeric). + * Optional. The list of consumer projects that are allow-listed for PSC connections to this instance. This instance can be connected to with PSC from any network in these projects. Each consumer project in this list may be represented by a project number (numeric) or by a project id (alphanumeric). */ allowedConsumerProjects?: string[] | null; /** @@ -1567,6 +1579,10 @@ export namespace sqladmin_v1 { * Read-replica configuration for connecting to the primary instance. */ export interface Schema$ReplicaConfiguration { + /** + * Optional. Specifies if a SQL Server replica is a cascadable replica. A cascadable replica is a SQL Server cross region replica that supports replica(s) under it. + */ + cascadableReplica?: boolean | null; /** * Specifies if the replica is the failover target. If the field is set to `true`, the replica will be designated as a failover replica. In case the primary instance fails, the replica instance will be promoted as the new primary instance. Only one replica can be specified as failover target, and the replica has to be in different zone with the primary instance. */ @@ -5331,6 +5347,92 @@ export namespace sqladmin_v1 { } } + /** + * Switches over from the primary instance to the replica instance. + * + * @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. + */ + switchover( + params: Params$Resource$Instances$Switchover, + options: StreamMethodOptions + ): GaxiosPromise; + switchover( + params?: Params$Resource$Instances$Switchover, + options?: MethodOptions + ): GaxiosPromise; + switchover( + params: Params$Resource$Instances$Switchover, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + switchover( + params: Params$Resource$Instances$Switchover, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + switchover( + params: Params$Resource$Instances$Switchover, + callback: BodyResponseCallback + ): void; + switchover(callback: BodyResponseCallback): void; + switchover( + paramsOrCallback?: + | Params$Resource$Instances$Switchover + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): void | GaxiosPromise | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Instances$Switchover; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Instances$Switchover; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://sqladmin.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + '/v1/projects/{project}/instances/{instance}/switchover' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'POST', + }, + options + ), + params, + requiredParams: ['project', 'instance'], + pathParams: ['instance', 'project'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + /** * Truncate MySQL general and slow query log tables MySQL only. * @@ -5669,6 +5771,10 @@ export namespace sqladmin_v1 { } export interface Params$Resource$Instances$Promotereplica extends StandardParameters { + /** + * Set to true if the promote operation should attempt to re-add the original primary as a replica when it comes back online. Otherwise, if this value is false or not set, the original primary will be a standalone instance. + */ + failover?: boolean; /** * Cloud SQL read replica instance name. */ @@ -5770,6 +5876,21 @@ export namespace sqladmin_v1 { */ project?: string; } + export interface Params$Resource$Instances$Switchover + extends StandardParameters { + /** + * Optional. (MySQL only) Cloud SQL instance operations timeout, which is a sum of all database operations. Default value is 10 minutes and can be modified to a maximum value of 24 hours. + */ + dbTimeout?: string; + /** + * Cloud SQL read replica instance name. + */ + instance?: string; + /** + * ID of the project that contains the replica. + */ + project?: string; + } export interface Params$Resource$Instances$Truncatelog extends StandardParameters { /** diff --git a/src/apis/sqladmin/v1beta4.ts b/src/apis/sqladmin/v1beta4.ts index a4aca8e9eb..f9ebae9511 100644 --- a/src/apis/sqladmin/v1beta4.ts +++ b/src/apis/sqladmin/v1beta4.ts @@ -598,7 +598,7 @@ export namespace sqladmin_v1beta4 { */ outOfDiskReport?: Schema$SqlOutOfDiskReport; /** - * Output only. The dns name of the primary instance in a replication group. + * Output only. DEPRECATED: please use write_endpoint instead. */ primaryDnsName?: string | null; /** @@ -661,6 +661,10 @@ export namespace sqladmin_v1beta4 { * If the instance state is SUSPENDED, the reason for the suspension. */ suspensionReason?: string[] | null; + /** + * Output only. The dns name of the primary instance in a replication group. + */ + writeEndpoint?: string | null; } /** * Database list response. @@ -1191,12 +1195,16 @@ export namespace sqladmin_v1beta4 { */ pscConfig?: Schema$PscConfig; /** - * Whether SSL connections over IP are enforced or not. + * LINT.IfChange(require_ssl_deprecate) Whether SSL/TLS connections over IP are enforced or not. If set to false, allow both non-SSL/non-TLS and SSL/TLS connections. For SSL/TLS connections, the client certificate will not be verified. If set to true, only allow connections encrypted with SSL/TLS and with valid client certificates. If you want to enforce SSL/TLS without enforcing the requirement for valid client certificates, use the `ssl_mode` flag instead of the legacy `require_ssl` flag. LINT.ThenChange(//depot/google3/java/com/google/storage/speckle/boss/admin/actions/InstanceUpdateAction.java:update_api_temp_fix) */ requireSsl?: boolean | null; + /** + * Specify how SSL/TLS will be enforced in database connections. This flag is only supported for PostgreSQL. Use the legacy `require_ssl` flag for enforcing SSL/TLS in MySQL and SQL Server. But, for PostgreSQL, it is recommended to use the `ssl_mode` flag instead of the legacy `require_ssl` flag. To avoid the conflict between those flags in PostgreSQL, only the following value pairs are valid: ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED, require_ssl=false; ssl_mode=ENCRYPTED_ONLY, require_ssl=false; ssl_mode=TRUSTED_CLIENT_CERTIFICATE_REQUIRED, require_ssl=true; Note that the value of `ssl_mode` gets priority over the value of the legacy `require_ssl`. For example, for the pair `ssl_mode=ENCRYPTED_ONLY, require_ssl=false`, the `ssl_mode=ENCRYPTED_ONLY` means "only accepts SSL connection", while the `require_ssl=false` means "both non-SSL and SSL connections are allowed". The database will respect `ssl_mode` in this case and only accept SSL connections. + */ + sslMode?: string | null; } /** - * Database instance IP Mapping. + * Database instance IP mapping */ export interface Schema$IpMapping { /** @@ -1520,6 +1528,10 @@ export namespace sqladmin_v1beta4 { * The complexity of the password. */ complexity?: string | null; + /** + * Disallow credentials that have been previously compromised by a public data breach. + */ + disallowCompromisedCredentials?: boolean | null; /** * Disallow username as a part of the password. */ @@ -1555,7 +1567,7 @@ export namespace sqladmin_v1beta4 { */ export interface Schema$PscConfig { /** - * List of consumer projects that are allow-listed for PSC connections to this instance. This instance can be connected to with PSC from any network in these projects. Each consumer project in this list may be represented by a project number (numeric) or by a project id (alphanumeric). + * Optional. The list of consumer projects that are allow-listed for PSC connections to this instance. This instance can be connected to with PSC from any network in these projects. Each consumer project in this list may be represented by a project number (numeric) or by a project id (alphanumeric). */ allowedConsumerProjects?: string[] | null; /** @@ -1567,6 +1579,10 @@ export namespace sqladmin_v1beta4 { * Read-replica configuration for connecting to the primary instance. */ export interface Schema$ReplicaConfiguration { + /** + * Optional. Specifies if a SQL Server replica is a cascadable replica. A cascadable replica is a SQL Server cross region replica that supports replica(s) under it. + */ + cascadableReplica?: boolean | null; /** * Specifies if the replica is the failover target. If the field is set to `true` the replica will be designated as a failover replica. In case the primary instance fails, the replica instance will be promoted as the new primary instance. Only one replica can be specified as failover target, and the replica has to be in different zone with the primary instance. */ @@ -5333,6 +5349,93 @@ export namespace sqladmin_v1beta4 { } } + /** + * Switches over from the primary instance to a replica instance. + * + * @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. + */ + switchover( + params: Params$Resource$Instances$Switchover, + options: StreamMethodOptions + ): GaxiosPromise; + switchover( + params?: Params$Resource$Instances$Switchover, + options?: MethodOptions + ): GaxiosPromise; + switchover( + params: Params$Resource$Instances$Switchover, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + switchover( + params: Params$Resource$Instances$Switchover, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + switchover( + params: Params$Resource$Instances$Switchover, + callback: BodyResponseCallback + ): void; + switchover(callback: BodyResponseCallback): void; + switchover( + paramsOrCallback?: + | Params$Resource$Instances$Switchover + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): void | GaxiosPromise | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Instances$Switchover; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Instances$Switchover; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://sqladmin.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/sql/v1beta4/projects/{project}/instances/{instance}/switchover' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'POST', + }, + options + ), + params, + requiredParams: ['project', 'instance'], + pathParams: ['instance', 'project'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + /** * Truncate MySQL general and slow query log tables MySQL only. * @@ -5560,7 +5663,7 @@ export namespace sqladmin_v1beta4 { } export interface Params$Resource$Instances$Export extends StandardParameters { /** - * Cloud SQL instance ID. This does not include the project ID. + * The Cloud SQL instance ID. This doesn't include the project ID. */ instance?: string; /** @@ -5671,6 +5774,10 @@ export namespace sqladmin_v1beta4 { } export interface Params$Resource$Instances$Promotereplica extends StandardParameters { + /** + * Set to true if the promote operation should attempt to re-add the original primary as a replica when it comes back online. Otherwise, if this value is false or not set, the original primary will be a standalone instance. + */ + failover?: boolean; /** * Cloud SQL read replica instance name. */ @@ -5772,6 +5879,21 @@ export namespace sqladmin_v1beta4 { */ project?: string; } + export interface Params$Resource$Instances$Switchover + extends StandardParameters { + /** + * Optional. (MySQL only) Cloud SQL instance operations timeout, which is a sum of all database operations. Default value is 10 minutes and can be modified to a maximum value of 24 hours. + */ + dbTimeout?: string; + /** + * Cloud SQL read replica instance name. + */ + instance?: string; + /** + * ID of the project that contains the replica. + */ + project?: string; + } export interface Params$Resource$Instances$Truncatelog extends StandardParameters { /** diff --git a/src/apis/travelimpactmodel/v1.ts b/src/apis/travelimpactmodel/v1.ts index fcf951eaa4..343c912e1a 100644 --- a/src/apis/travelimpactmodel/v1.ts +++ b/src/apis/travelimpactmodel/v1.ts @@ -214,7 +214,7 @@ export namespace travelimpactmodel_v1 { */ export interface Schema$FlightWithEmissions { /** - * Optional. Per-passenger emission estimate numbers. Will not be present if emissions could not be computed. For the list of reasons why emissions could not be computed, see ComputeFlightEmissions. + * Optional. Per-passenger emission estimate numbers. Will not be present if emissions could not be computed. For the list of reasons why emissions could not be computed, see ComputeFlightEmissions. Note this field is currently equivalent to ttw_emissions_grams_per_pax until TIM version 1.X.0 which will update this to be total wtw emissions aka wtt_emissions_grams_per_pax + ttw_emissions_grams_per_pax. */ emissionsGramsPerPax?: Schema$EmissionsGramsPerPax; /** diff --git a/src/apis/youtube/v3.ts b/src/apis/youtube/v3.ts index 2265facfee..76ffeae667 100644 --- a/src/apis/youtube/v3.ts +++ b/src/apis/youtube/v3.ts @@ -129,6 +129,7 @@ export namespace youtube_v3 { liveStreams: Resource$Livestreams; members: Resource$Members; membershipsLevels: Resource$Membershipslevels; + playlistImages: Resource$Playlistimages; playlistItems: Resource$Playlistitems; playlists: Resource$Playlists; search: Resource$Search; @@ -166,6 +167,7 @@ export namespace youtube_v3 { this.liveStreams = new Resource$Livestreams(this.context); this.members = new Resource$Members(this.context); this.membershipsLevels = new Resource$Membershipslevels(this.context); + this.playlistImages = new Resource$Playlistimages(this.context); this.playlistItems = new Resource$Playlistitems(this.context); this.playlists = new Resource$Playlists(this.context); this.search = new Resource$Search(this.context); @@ -3021,6 +3023,57 @@ export namespace youtube_v3 { */ itemCount?: number | null; } + export interface Schema$PlaylistImage { + /** + * Identifies this resource (playlist id and image type). + */ + id?: string | null; + /** + * Identifies what kind of resource this is. Value: the fixed string "youtube#playlistImages". + */ + kind?: string | null; + snippet?: Schema$PlaylistImageSnippet; + } + export interface Schema$PlaylistImageListResponse { + items?: Schema$PlaylistImage[]; + /** + * Identifies what kind of resource this is. Value: the fixed string "youtube#playlistImageListResponse". + */ + kind?: string | null; + /** + * The token that can be used as the value of the pageToken parameter to retrieve the next page in the result set. + */ + nextPageToken?: string | null; + /** + * General pagination information. + */ + pageInfo?: Schema$PageInfo; + /** + * The token that can be used as the value of the pageToken parameter to retrieve the previous page in the result set. + */ + prevPageToken?: string | null; + } + /** + * A *playlistImage* resource identifies another resource, such as a image, that is associated with a playlist. In addition, the playlistImage resource contains details about the included resource that pertain specifically to how that resource is used in that playlist. YouTube uses playlists to identify special collections of videos for a channel, such as: - uploaded videos - favorite videos - positively rated (liked) videos - watch history To be more specific, these lists are associated with a channel, which is a collection of a person, group, or company's videos, playlists, and other YouTube information. You can retrieve the playlist IDs for each of these lists from the channel resource for a given channel. You can then use the playlistImages.list method to retrieve image data for any of those playlists. You can also add or remove images from those lists by calling the playlistImages.insert and playlistImages.delete methods. + */ + export interface Schema$PlaylistImageSnippet { + /** + * The image height. + */ + height?: number | null; + /** + * The Playlist ID of the playlist this image is associated with. + */ + playlistId?: string | null; + /** + * The image type. + */ + type?: string | null; + /** + * The image width. + */ + width?: number | null; + } /** * A *playlistItem* resource identifies another resource, such as a video, that is included in a playlist. In addition, the playlistItem resource contains details about the included resource that pertain specifically to how that resource is used in that playlist. YouTube uses playlists to identify special collections of videos for a channel, such as: - uploaded videos - favorite videos - positively rated (liked) videos - watch history - watch later To be more specific, these lists are associated with a channel, which is a collection of a person, group, or company's videos, playlists, and other YouTube information. You can retrieve the playlist IDs for each of these lists from the channel resource for a given channel. You can then use the playlistItems.list method to retrieve any of those lists. You can also add or remove items from those lists by calling the playlistItems.insert and playlistItems.delete methods. For example, if a user gives a positive rating to a video, you would insert that video into the liked videos playlist for that user's channel. */ @@ -5714,10 +5767,6 @@ export namespace youtube_v3 { * Return the channels within the specified guide category ID. */ categoryId?: string; - /** - * Return the channel associated with a YouTube handle. UNIMPLEMENTED. - */ - forHandle?: string; /** * Return the channel associated with a YouTube username. */ @@ -9576,6 +9625,441 @@ export namespace youtube_v3 { part?: string[]; } + export class Resource$Playlistimages { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * Deletes a 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. + */ + delete( + params: Params$Resource$Playlistimages$Delete, + options: StreamMethodOptions + ): GaxiosPromise; + delete( + params?: Params$Resource$Playlistimages$Delete, + options?: MethodOptions + ): GaxiosPromise; + delete( + params: Params$Resource$Playlistimages$Delete, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Playlistimages$Delete, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Playlistimages$Delete, + callback: BodyResponseCallback + ): void; + delete(callback: BodyResponseCallback): void; + delete( + paramsOrCallback?: + | Params$Resource$Playlistimages$Delete + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: BodyResponseCallback | BodyResponseCallback + ): void | GaxiosPromise | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Playlistimages$Delete; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Playlistimages$Delete; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://youtube.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/youtube/v3/playlistImages').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'DELETE', + }, + options + ), + params, + requiredParams: [], + pathParams: [], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Inserts a new resource into this collection. + * + * @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$Playlistimages$Insert, + options: StreamMethodOptions + ): GaxiosPromise; + insert( + params?: Params$Resource$Playlistimages$Insert, + options?: MethodOptions + ): GaxiosPromise; + insert( + params: Params$Resource$Playlistimages$Insert, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + insert( + params: Params$Resource$Playlistimages$Insert, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + insert( + params: Params$Resource$Playlistimages$Insert, + callback: BodyResponseCallback + ): void; + insert(callback: BodyResponseCallback): void; + insert( + paramsOrCallback?: + | Params$Resource$Playlistimages$Insert + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): void | GaxiosPromise | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Playlistimages$Insert; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Playlistimages$Insert; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://youtube.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/youtube/v3/playlistImages').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'POST', + }, + options + ), + params, + requiredParams: [], + pathParams: [], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Retrieves a list of resources, possibly filtered. + * + * @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$Playlistimages$List, + options: StreamMethodOptions + ): GaxiosPromise; + list( + params?: Params$Resource$Playlistimages$List, + options?: MethodOptions + ): GaxiosPromise; + list( + params: Params$Resource$Playlistimages$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Playlistimages$List, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Playlistimages$List, + callback: BodyResponseCallback + ): void; + list( + callback: BodyResponseCallback + ): void; + list( + paramsOrCallback?: + | Params$Resource$Playlistimages$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | GaxiosPromise + | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Playlistimages$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Playlistimages$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://youtube.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/youtube/v3/playlistImages').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'GET', + }, + options + ), + params, + requiredParams: [], + pathParams: [], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Updates an existing 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. + */ + update( + params: Params$Resource$Playlistimages$Update, + options: StreamMethodOptions + ): GaxiosPromise; + update( + params?: Params$Resource$Playlistimages$Update, + options?: MethodOptions + ): GaxiosPromise; + update( + params: Params$Resource$Playlistimages$Update, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + update( + params: Params$Resource$Playlistimages$Update, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + update( + params: Params$Resource$Playlistimages$Update, + callback: BodyResponseCallback + ): void; + update(callback: BodyResponseCallback): void; + update( + paramsOrCallback?: + | Params$Resource$Playlistimages$Update + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): void | GaxiosPromise | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Playlistimages$Update; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Playlistimages$Update; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://youtube.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/youtube/v3/playlistImages').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'PUT', + }, + options + ), + params, + requiredParams: [], + pathParams: [], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + } + + export interface Params$Resource$Playlistimages$Delete + extends StandardParameters { + /** + * Id to identify this image. This is returned from by the List method. + */ + id?: string; + /** + * *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner. + */ + onBehalfOfContentOwner?: string; + } + export interface Params$Resource$Playlistimages$Insert + extends StandardParameters { + /** + * *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner. + */ + onBehalfOfContentOwner?: string; + /** + * This parameter can only be used in a properly authorized request. *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwnerChannel* parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required when a request specifies a value for the onBehalfOfContentOwner parameter, and it can only be used in conjunction with that parameter. In addition, the request must be authorized using a CMS account that is linked to the content owner that the onBehalfOfContentOwner parameter specifies. Finally, the channel that the onBehalfOfContentOwnerChannel parameter value specifies must be linked to the content owner that the onBehalfOfContentOwner parameter specifies. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and perform actions on behalf of the channel specified in the parameter value, without having to provide authentication credentials for each separate channel. + */ + onBehalfOfContentOwnerChannel?: string; + /** + * The *part* parameter specifies the properties that the API response will include. + */ + part?: string[]; + + /** + * Request body metadata + */ + requestBody?: Schema$PlaylistImage; + } + export interface Params$Resource$Playlistimages$List + extends StandardParameters { + /** + * The *maxResults* parameter specifies the maximum number of items that should be returned in the result set. + */ + maxResults?: number; + /** + * *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner. + */ + onBehalfOfContentOwner?: string; + /** + * This parameter can only be used in a properly authorized request. *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwnerChannel* parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required when a request specifies a value for the onBehalfOfContentOwner parameter, and it can only be used in conjunction with that parameter. In addition, the request must be authorized using a CMS account that is linked to the content owner that the onBehalfOfContentOwner parameter specifies. Finally, the channel that the onBehalfOfContentOwnerChannel parameter value specifies must be linked to the content owner that the onBehalfOfContentOwner parameter specifies. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and perform actions on behalf of the channel specified in the parameter value, without having to provide authentication credentials for each separate channel. + */ + onBehalfOfContentOwnerChannel?: string; + /** + * The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved. + */ + pageToken?: string; + /** + * Return PlaylistImages for this playlist id. + */ + parent?: string; + /** + * The *part* parameter specifies a comma-separated list of one or more playlistImage resource properties that the API response will include. If the parameter identifies a property that contains child properties, the child properties will be included in the response. + */ + part?: string[]; + } + export interface Params$Resource$Playlistimages$Update + extends StandardParameters { + /** + * *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner. + */ + onBehalfOfContentOwner?: string; + /** + * The *part* parameter specifies the properties that the API response will include. + */ + part?: string[]; + + /** + * Request body metadata + */ + requestBody?: Schema$PlaylistImage; + } + export class Resource$Playlistitems { context: APIRequestContext; constructor(context: APIRequestContext) { @@ -10608,10 +11092,6 @@ export namespace youtube_v3 { * Display the content as seen by viewers in this country. */ regionCode?: string; - /** - * Search related to a resource. - */ - relatedToVideoId?: string; /** * Return results relevant to this language. */