google-api-python-client 2.140.0__py2.py3-none-any.whl → 2.141.0__py2.py3-none-any.whl

googleapiclient/discovery_cache/documents/securitycenter.v1beta2.json

@@ -1906,7 +1906,7 @@
 }
 }
 },
-"revision": "20240720",
+"revision": "20240806",
 "rootUrl": "https://securitycenter.googleapis.com/",
 "schemas": {
 "Access": {
@@ -2644,6 +2644,11 @@
 "$ref": "Cvssv3",
 "description": "Describe Common Vulnerability Scoring System specified at https://www.first.org/cvss/v3.1/specification-document"
 },
+"exploitReleaseDate": {
+"description": "Date the first publicly available exploit or PoC was released.",
+"format": "google-datetime",
+"type": "string"
+},
 "exploitationActivity": {
 "description": "The exploitation activity of the vulnerability in the wild.",
 "enum": [
@@ -2946,6 +2951,22 @@
 },
 "type": "object"
 },
+"DynamicMuteRecord": {
+"description": "The record of a dynamic mute rule that matches the finding.",
+"id": "DynamicMuteRecord",
+"properties": {
+"matchTime": {
+"description": "When the dynamic mute rule first matched the finding.",
+"format": "google-datetime",
+"type": "string"
+},
+"muteConfig": {
+"description": "The relative resource name of the mute rule, represented by a mute config, that created this record, for example `organizations/123/muteConfigs/mymuteconfig` or `organizations/123/locations/global/muteConfigs/mymuteconfig`.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "EnvironmentVariable": {
 "description": "A name-value pair representing an environment variable used in an operating system process.",
 "id": "EnvironmentVariable",
@@ -3303,6 +3324,11 @@
 ],
 "type": "string"
 },
+"muteInfo": {
+"$ref": "MuteInfo",
+"description": "Output only. The mute information regarding this finding.",
+"readOnly": true
+},
 "muteInitiator": {
 "description": "Records additional information about the mute operation, for example, the [mute configuration](/security-command-center/docs/how-to-mute-findings) that muted the finding and the user who muted the finding.",
 "type": "string"
@@ -3722,6 +3748,11 @@
 "description": "The human readable name to be displayed for the mute config.",
 "type": "string"
 },
+"expiryTime": {
+"description": "Optional. The expiry of the mute config. Only applicable for dynamic configs. If the expiry is set, when the config expires, it is removed from all findings.",
+"format": "google-datetime",
+"type": "string"
+},
 "filter": {
 "description": "Required. An expression that defines the filter to apply across create/update events of findings. While creating a filter string, be mindful of the scope in which the mute configuration is being created. E.g., If a filter contains project = X but is created under the project = Y scope, it might not match any findings. The following field and operator combinations are supported: * severity: `=`, `:` * category: `=`, `:` * resource.name: `=`, `:` * resource.project_name: `=`, `:` * resource.project_display_name: `=`, `:` * resource.folders.resource_folder: `=`, `:` * resource.parent_name: `=`, `:` * resource.parent_display_name: `=`, `:` * resource.type: `=`, `:` * finding_class: `=`, `:` * indicator.ip_addresses: `=`, `:` * indicator.domains: `=`, `:`",
 "type": "string"
@@ -3735,6 +3766,20 @@
 "description": "This field will be ignored if provided on config creation. Format `organizations/{organization}/muteConfigs/{mute_config}` `folders/{folder}/muteConfigs/{mute_config}` `projects/{project}/muteConfigs/{mute_config}` `organizations/{organization}/locations/global/muteConfigs/{mute_config}` `folders/{folder}/locations/global/muteConfigs/{mute_config}` `projects/{project}/locations/global/muteConfigs/{mute_config}`",
 "type": "string"
 },
+"type": {
+"description": "Optional. The type of the mute config, which determines what type of mute state the config affects. The static mute state takes precedence over the dynamic mute state. Immutable after creation. STATIC by default if not set during creation.",
+"enum": [
+"MUTE_CONFIG_TYPE_UNSPECIFIED",
+"STATIC",
+"DYNAMIC"
+],
+"enumDescriptions": [
+"Unused.",
+"A static mute config, which sets the static mute state of future matching findings to muted. Once the static mute state has been set, finding or config modifications will not affect the state.",
+"A dynamic mute config, which is applied to existing and future matching findings, setting their dynamic mute state to \"muted\". If the config is updated or deleted, or a matching finding is updated, such that the finding doesn't match the config, the config will be removed from the finding, and the finding's dynamic mute state may become \"unmuted\" (unless other configs still match)."
+],
+"type": "string"
+},
 "updateTime": {
 "description": "Output only. The most recent time at which the mute config was updated. This field is set by the server and will be ignored if provided on config creation or update.",
 "format": "google-datetime",
@@ -5004,6 +5049,11 @@
 "$ref": "GoogleCloudSecuritycenterV2Cvssv3",
 "description": "Describe Common Vulnerability Scoring System specified at https://www.first.org/cvss/v3.1/specification-document"
 },
+"exploitReleaseDate": {
+"description": "Date the first publicly available exploit or PoC was released.",
+"format": "google-datetime",
+"type": "string"
+},
 "exploitationActivity": {
 "description": "The exploitation activity of the vulnerability in the wild.",
 "enum": [
@@ -5269,6 +5319,22 @@
 },
 "type": "object"
 },
+"GoogleCloudSecuritycenterV2DynamicMuteRecord": {
+"description": "The record of a dynamic mute rule that matches the finding.",
+"id": "GoogleCloudSecuritycenterV2DynamicMuteRecord",
+"properties": {
+"matchTime": {
+"description": "When the dynamic mute rule first matched the finding.",
+"format": "google-datetime",
+"type": "string"
+},
+"muteConfig": {
+"description": "The relative resource name of the mute rule, represented by a mute config, that created this record, for example `organizations/123/muteConfigs/mymuteconfig` or `organizations/123/locations/global/muteConfigs/mymuteconfig`.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudSecuritycenterV2EnvironmentVariable": {
 "description": "A name-value pair representing an environment variable used in an operating system process.",
 "id": "GoogleCloudSecuritycenterV2EnvironmentVariable",
@@ -5623,6 +5689,11 @@
 ],
 "type": "string"
 },
+"muteInfo": {
+"$ref": "GoogleCloudSecuritycenterV2MuteInfo",
+"description": "Output only. The mute information regarding this finding.",
+"readOnly": true
+},
 "muteInitiator": {
 "description": "Records additional information about the mute operation, for example, the [mute configuration](https://cloud.google.com/security-command-center/docs/how-to-mute-findings) that muted the finding and the user who muted the finding.",
 "type": "string"
@@ -6385,6 +6456,11 @@
 "description": "A description of the mute config.",
 "type": "string"
 },
+"expiryTime": {
+"description": "Optional. The expiry of the mute config. Only applicable for dynamic configs. If the expiry is set, when the config expires, it is removed from all findings.",
+"format": "google-datetime",
+"type": "string"
+},
 "filter": {
 "description": "Required. An expression that defines the filter to apply across create/update events of findings. While creating a filter string, be mindful of the scope in which the mute configuration is being created. E.g., If a filter contains project = X but is created under the project = Y scope, it might not match any findings. The following field and operator combinations are supported: * severity: `=`, `:` * category: `=`, `:` * resource.name: `=`, `:` * resource.project_name: `=`, `:` * resource.project_display_name: `=`, `:` * resource.folders.resource_folder: `=`, `:` * resource.parent_name: `=`, `:` * resource.parent_display_name: `=`, `:` * resource.type: `=`, `:` * finding_class: `=`, `:` * indicator.ip_addresses: `=`, `:` * indicator.domains: `=`, `:`",
 "type": "string"
@@ -6402,11 +6478,13 @@
 "description": "Required. The type of the mute config, which determines what type of mute state the config affects. Immutable after creation.",
 "enum": [
 "MUTE_CONFIG_TYPE_UNSPECIFIED",
-"STATIC"
+"STATIC",
+"DYNAMIC"
 ],
 "enumDescriptions": [
 "Unused.",
-"A static mute config, which sets the static mute state of future matching findings to muted. Once the static mute state has been set, finding or config modifications will not affect the state."
+"A static mute config, which sets the static mute state of future matching findings to muted. Once the static mute state has been set, finding or config modifications will not affect the state.",
+"A dynamic mute config, which is applied to existing and future matching findings, setting their dynamic mute state to \"muted\". If the config is updated or deleted, or a matching finding is updated, such that the finding doesn't match the config, the config will be removed from the finding, and the finding's dynamic mute state may become \"unmuted\" (unless other configs still match)."
 ],
 "type": "string"
 },
@@ -6419,6 +6497,24 @@
 },
 "type": "object"
 },
+"GoogleCloudSecuritycenterV2MuteInfo": {
+"description": "Mute information about the finding, including whether the finding has a static mute or any matching dynamic mute rules.",
+"id": "GoogleCloudSecuritycenterV2MuteInfo",
+"properties": {
+"dynamicMuteRecords": {
+"description": "The list of dynamic mute rules that currently match the finding.",
+"items": {
+"$ref": "GoogleCloudSecuritycenterV2DynamicMuteRecord"
+},
+"type": "array"
+},
+"staticMute": {
+"$ref": "GoogleCloudSecuritycenterV2StaticMute",
+"description": "If set, the static mute applied to this finding. Static mutes override dynamic mutes. If unset, there is no static mute."
+}
+},
+"type": "object"
+},
 "GoogleCloudSecuritycenterV2Node": {
 "description": "Kubernetes nodes associated with the finding.",
 "id": "GoogleCloudSecuritycenterV2Node",
@@ -7129,6 +7225,34 @@
 },
 "type": "object"
 },
+"GoogleCloudSecuritycenterV2StaticMute": {
+"description": "Information about the static mute state. A static mute state overrides any dynamic mute rules that apply to this finding. The static mute state can be set by a static mute rule or by muting the finding directly.",
+"id": "GoogleCloudSecuritycenterV2StaticMute",
+"properties": {
+"applyTime": {
+"description": "When the static mute was applied.",
+"format": "google-datetime",
+"type": "string"
+},
+"state": {
+"description": "The static mute state. If the value is `MUTED` or `UNMUTED`, then the finding's overall mute state will have the same value.",
+"enum": [
+"MUTE_UNSPECIFIED",
+"MUTED",
+"UNMUTED",
+"UNDEFINED"
+],
+"enumDescriptions": [
+"Unspecified.",
+"Finding has been muted.",
+"Finding has been unmuted.",
+"Finding has never been muted/unmuted."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudSecuritycenterV2Subject": {
 "description": "Represents a Kubernetes subject.",
 "id": "GoogleCloudSecuritycenterV2Subject",
@@ -7858,6 +7982,24 @@
 },
 "type": "object"
 },
+"MuteInfo": {
+"description": "Mute information about the finding, including whether the finding has a static mute or any matching dynamic mute rules.",
+"id": "MuteInfo",
+"properties": {
+"dynamicMuteRecords": {
+"description": "The list of dynamic mute rules that currently match the finding.",
+"items": {
+"$ref": "DynamicMuteRecord"
+},
+"type": "array"
+},
+"staticMute": {
+"$ref": "StaticMute",
+"description": "If set, the static mute applied to this finding. Static mutes override dynamic mutes. If unset, there is no static mute."
+}
+},
+"type": "object"
+},
 "Node": {
 "description": "Kubernetes nodes associated with the finding.",
 "id": "Node",
@@ -8467,6 +8609,34 @@
 },
 "type": "object"
 },
+"StaticMute": {
+"description": "Information about the static mute state. A static mute state overrides any dynamic mute rules that apply to this finding. The static mute state can be set by a static mute rule or by muting the finding directly.",
+"id": "StaticMute",
+"properties": {
+"applyTime": {
+"description": "When the static mute was applied.",
+"format": "google-datetime",
+"type": "string"
+},
+"state": {
+"description": "The static mute state. If the value is `MUTED` or `UNMUTED`, then the finding's overall mute state will have the same value.",
+"enum": [
+"MUTE_UNSPECIFIED",
+"MUTED",
+"UNMUTED",
+"UNDEFINED"
+],
+"enumDescriptions": [
+"Unspecified.",
+"Finding has been muted.",
+"Finding has been unmuted.",
+"Finding has never been muted/unmuted."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "Subject": {
 "description": "Represents a Kubernetes subject.",
 "id": "Subject",

googleapiclient/discovery_cache/documents/servicecontrol.v1.json

@@ -197,7 +197,7 @@
 }
 }
 },
-"revision": "20240628",
+"revision": "20240802",
 "rootUrl": "https://servicecontrol.googleapis.com/",
 "schemas": {
 "AllocateInfo": {
@@ -2178,6 +2178,11 @@
 "description": "Report v2 extension proto for passing the resource metadata associated with a resource create/update/delete/undelete event from ESF to Chemist. ResourceEvent proto should be serialized into the ReportRequest.operations.extensions.",
 "id": "V1ResourceEvent",
 "properties": {
+"contextId": {
+"description": "The ESF unique context id of the api request, from which this resource event originated. This field is only needed for CAIS integration via api annotation. See go/cais-lro-delete for more details.",
+"format": "int64",
+"type": "string"
+},
 "destinations": {
 "description": "The destinations field determines which backend services should handle the event. This should be specified as a comma-delimited string.",
 "type": "string"

googleapiclient/discovery_cache/documents/servicecontrol.v2.json

@@ -169,7 +169,7 @@
 }
 }
 },
-"revision": "20240705",
+"revision": "20240802",
 "rootUrl": "https://servicecontrol.googleapis.com/",
 "schemas": {
 "Api": {
@@ -1191,6 +1191,11 @@
 "description": "Report v2 extension proto for passing the resource metadata associated with a resource create/update/delete/undelete event from ESF to Chemist. ResourceEvent proto should be serialized into the ReportRequest.operations.extensions.",
 "id": "V2ResourceEvent",
 "properties": {
+"contextId": {
+"description": "The ESF unique context id of the api request, from which this resource event originated. This field is only needed for CAIS integration via api annotation. See go/cais-lro-delete for more details.",
+"format": "int64",
+"type": "string"
+},
 "destinations": {
 "description": "The destinations field determines which backend services should handle the event. This should be specified as a comma-delimited string.",
 "type": "string"

googleapiclient/discovery_cache/documents/sheets.v4.json

@@ -870,7 +870,7 @@
 }
 }
 },
-"revision": "20240716",
+"revision": "20240730",
 "rootUrl": "https://sheets.googleapis.com/",
 "schemas": {
 "AddBandingRequest": {
@@ -5132,7 +5132,7 @@
 "id": "LookerDataSourceSpec",
 "properties": {
 "explore": {
-"description": "Name of a LookerML model explore.",
+"description": "Name of a Looker model explore.",
 "type": "string"
 },
 "instanceUri": {
@@ -5140,7 +5140,7 @@
 "type": "string"
 },
 "model": {
-"description": "Name of a LookerML model.",
+"description": "Name of a Looker model.",
 "type": "string"
 }
 },

googleapiclient/discovery_cache/documents/spanner.v1.json

@@ -1397,7 +1397,7 @@
 "databases": {
 "methods": {
 "changequorum": {
-"description": "ChangeQuorum is strictly restricted to databases that use dual region instance configurations. Initiates a background operation to change quorum a database from dual-region mode to single-region mode and vice versa. The returned long-running operation will have a name of the format `projects//instances//databases//operations/` and can be used to track execution of the ChangeQuorum. The metadata field type is ChangeQuorumMetadata. Authorization requires `spanner.databases.changequorum` permission on the resource database.",
+"description": "`ChangeQuorum` is strictly restricted to databases that use dual-region instance configurations. Initiates a background operation to change the quorum of a database from dual-region mode to single-region mode or vice versa. The returned long-running operation has a name of the format `projects//instances//databases//operations/` and can be used to track execution of the `ChangeQuorum`. The metadata field type is ChangeQuorumMetadata. Authorization requires `spanner.databases.changequorum` permission on the resource database.",
 "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}:changequorum",
 "httpMethod": "POST",
 "id": "spanner.projects.instances.databases.changequorum",
@@ -1406,7 +1406,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. Name of the database in which to apply the ChangeQuorum. Values are of the form `projects//instances//databases/`.",
+"description": "Required. Name of the database in which to apply `ChangeQuorum`. Values are of the form `projects//instances//databases/`.",
 "location": "path",
 "pattern": "^projects/[^/]+/instances/[^/]+/databases/[^/]+$",
 "required": true,
@@ -3254,7 +3254,7 @@
 }
 }
 },
-"revision": "20240719",
+"revision": "20240731",
 "rootUrl": "https://spanner.googleapis.com/",
 "schemas": {
 "AutoscalingConfig": {
@@ -3635,16 +3635,16 @@
 "id": "ChangeQuorumRequest",
 "properties": {
 "etag": {
-"description": "Optional. The etag is the hash of the QuorumInfo. The ChangeQuorum operation will only be performed if the etag matches that of the QuorumInfo in the current database resource. Otherwise the API will return an `ABORTED` error. The etag is used for optimistic concurrency control as a way to help prevent simultaneous change quorum requests that could create a race condition.",
+"description": "Optional. The etag is the hash of the `QuorumInfo`. The `ChangeQuorum` operation is only performed if the etag matches that of the `QuorumInfo` in the current database resource. Otherwise the API returns an `ABORTED` error. The etag is used for optimistic concurrency control as a way to help prevent simultaneous change quorum requests that could create a race condition.",
 "type": "string"
 },
 "name": {
-"description": "Required. Name of the database in which to apply the ChangeQuorum. Values are of the form `projects//instances//databases/`.",
+"description": "Required. Name of the database in which to apply `ChangeQuorum`. Values are of the form `projects//instances//databases/`.",
 "type": "string"
 },
 "quorumType": {
 "$ref": "QuorumType",
-"description": "Required. The type of this Quorum."
+"description": "Required. The type of this quorum."
 }
 },
 "type": "object"
@@ -4190,7 +4190,7 @@
 },
 "quorumInfo": {
 "$ref": "QuorumInfo",
-"description": "Output only. Applicable only for databases that use dual region instance configurations. Contains information about the quorum.",
+"description": "Output only. Applicable only for databases that use dual-region instance configurations. Contains information about the quorum.",
 "readOnly": true
 },
 "reconciling": {
@@ -4905,10 +4905,10 @@
 "MULTI_REGION"
 ],
 "enumDescriptions": [
-"Not specified.",
-"An instance configuration tagged with REGION quorum type forms a write quorum in a single region.",
-"An instance configuration tagged with DUAL_REGION quorum type forms a write quorums with exactly two read-write regions in a multi-region configuration. This instance configurations requires reconfiguration in the event of regional failures.",
-"An instance configuration tagged with MULTI_REGION quorum type forms a write quorums from replicas are spread across more than one region in a multi-region configuration."
+"Quorum type not specified.",
+"An instance configuration tagged with `REGION` quorum type forms a write quorum in a single region.",
+"An instance configuration tagged with the `DUAL_REGION` quorum type forms a write quorum with exactly two read-write regions in a multi-region configuration. This instance configuration requires failover in the event of regional failures.",
+"An instance configuration tagged with the `MULTI_REGION` quorum type forms a write quorum from replicas that are spread across more than one region in a multi-region configuration."
 ],
 "readOnly": true,
 "type": "string"
@@ -5008,7 +5008,8 @@
 "type": "integer"
 },
 "referencingBackups": {
-"description": "Output only. The names of the backups that reference this instance partition. Referencing backups should share the parent instance. The existence of any referencing backup prevents the instance partition from being deleted.",
+"deprecated": true,
+"description": "Output only. Deprecated: This field is not populated. Output only. The names of the backups that reference this instance partition. Referencing backups should share the parent instance. The existence of any referencing backup prevents the instance partition from being deleted.",
 "items": {
 "type": "string"
 },
@@ -6011,16 +6012,16 @@
 "type": "object"
 },
 "QuorumInfo": {
-"description": "Information about the dual region quorum.",
+"description": "Information about the dual-region quorum.",
 "id": "QuorumInfo",
 "properties": {
 "etag": {
-"description": "Output only. The etag is used for optimistic concurrency control as a way to help prevent simultaneous ChangeQuorum requests that could create a race condition.",
+"description": "Output only. The etag is used for optimistic concurrency control as a way to help prevent simultaneous `ChangeQuorum` requests that might create a race condition.",
 "readOnly": true,
 "type": "string"
 },
 "initiator": {
-"description": "Output only. Whether this ChangeQuorum is a Google or User initiated.",
+"description": "Output only. Whether this `ChangeQuorum` is Google or User initiated.",
 "enum": [
 "INITIATOR_UNSPECIFIED",
 "GOOGLE",
@@ -6028,8 +6029,8 @@
 ],
 "enumDescriptions": [
 "Unspecified.",
-"ChangeQuorum initiated by Google.",
-"ChangeQuorum initiated by User."
+"`ChangeQuorum` initiated by Google.",
+"`ChangeQuorum` initiated by User."
 ],
 "readOnly": true,
 "type": "string"
@@ -6049,16 +6050,16 @@
 "type": "object"
 },
 "QuorumType": {
-"description": "Information about the database quorum type. this applies only for dual region instance configs.",
+"description": "Information about the database quorum type. This only applies to dual-region instance configs.",
 "id": "QuorumType",
 "properties": {
 "dualRegion": {
 "$ref": "DualRegionQuorum",
-"description": "Dual region quorum type."
+"description": "Dual-region quorum type."
 },
 "singleRegion": {
 "$ref": "SingleRegionQuorum",
-"description": "Single region quorum type."
+"description": "Single-region quorum type."
 }
 },
 "type": "object"
@@ -6620,7 +6621,7 @@
 "id": "SingleRegionQuorum",
 "properties": {
 "servingLocation": {
-"description": "Required. The location of the serving region, e.g. \"us-central1\". The location must be one of the regions within the dual region instance configuration of your database. The list of valid locations is available via [GetInstanceConfig[InstanceAdmin.GetInstanceConfig] API. This should only be used if you plan to change quorum in single-region quorum type.",
+"description": "Required. The location of the serving region, e.g. \"us-central1\". The location must be one of the regions within the dual-region instance configuration of your database. The list of valid locations is available using the GetInstanceConfig API. This should only be used if you plan to change quorum to the single-region quorum type.",
 "type": "string"
 }
 },