google-api-python-client 2.192.0__py3-none-any.whl → 2.193.0__py3-none-any.whl

googleapiclient/discovery_cache/documents/workloadmanager.v1.json

@@ -574,12 +574,12 @@
 ],
 "parameters": {
 "evaluationId": {
-"description": "Required. Id of the requesting object",
+"description": "Required. Id of the requesting object.",
 "location": "query",
 "type": "string"
 },
 "parent": {
-"description": "Required. The resource prefix of the evaluation location using the form: `projects/{project_id}/locations/{location_id}`",
+"description": "Required. The resource prefix of the evaluation location using the form: `projects/{project_id}/locations/{location_id}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+$",
 "required": true,
@@ -612,12 +612,12 @@
 ],
 "parameters": {
 "force": {
-"description": "Optional. Followed the best practice from https://aip.dev/135#cascading-delete",
+"description": "Optional. Followed the best practice from https://aip.dev/135#cascading-delete.",
 "location": "query",
 "type": "boolean"
 },
 "name": {
-"description": "Required. Name of the resource",
+"description": "Required. Name of the resource.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/evaluations/[^/]+$",
 "required": true,
@@ -647,7 +647,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. Name of the resource",
+"description": "Required. Name of the resource.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/evaluations/[^/]+$",
 "required": true,
@@ -677,7 +677,7 @@
 "type": "string"
 },
 "orderBy": {
-"description": "Hint for how to order the results",
+"description": "Hint for how to order the results.",
 "location": "query",
 "type": "string"
 },
@@ -693,7 +693,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. Parent value for ListEvaluationsRequest",
+"description": "Required. Parent value for ListEvaluationsRequest.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+$",
 "required": true,
@@ -718,7 +718,7 @@
 ],
 "parameters": {
 "name": {
-"description": "name of resource names have the form 'projects/{project_id}/locations/{location_id}/evaluations/{evaluation_id}'",
+"description": "Name of resource that has the form `projects/{project_id}/locations/{location_id}/evaluations/{evaluation_id}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/evaluations/[^/]+$",
 "required": true,
@@ -761,7 +761,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. Name of the resource",
+"description": "Required. Name of the resource.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/evaluations/[^/]+/executions/[^/]+$",
 "required": true,
@@ -791,7 +791,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. Name of the resource",
+"description": "Required. Name of the resource.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/evaluations/[^/]+/executions/[^/]+$",
 "required": true,
@@ -816,7 +816,7 @@
 ],
 "parameters": {
 "filter": {
-"description": "Filtering results",
+"description": "Filtering results.",
 "location": "query",
 "type": "string"
 },
@@ -837,7 +837,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The resource prefix of the Execution using the form: 'projects/{project}/locations/{location}/evaluations/{evaluation}'",
+"description": "Required. The resource prefix of the Execution using the form: `projects/{project}/locations/{location}/evaluations/{evaluation}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/evaluations/[^/]+$",
 "required": true,
@@ -862,7 +862,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Execution using the form: 'projects/{project}/locations/{location}/evaluations/{evaluation}/executions/{execution}'",
+"description": "Required. The resource name of the Evaluation using the form: `projects/{project}/locations/{location}/evaluations/{evaluation}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/evaluations/[^/]+$",
 "required": true,
@@ -894,7 +894,7 @@
 ],
 "parameters": {
 "filter": {
-"description": "Filtering results",
+"description": "Filtering results.",
 "location": "query",
 "type": "string"
 },
@@ -910,7 +910,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The execution results. Format: {parent}/evaluations/*/executions/*/results",
+"description": "Required. The execution results. Format: {parent}/evaluations/*/executions/*/results.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/evaluations/[^/]+/executions/[^/]+$",
 "required": true,
@@ -939,7 +939,7 @@
 ],
 "parameters": {
 "filter": {
-"description": "Filtering results",
+"description": "Filtering results.",
 "location": "query",
 "type": "string"
 },
@@ -960,14 +960,14 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. parent for ListScannedResourcesRequest",
+"description": "Required. Parent for ListScannedResourcesRequest.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/evaluations/[^/]+/executions/[^/]+$",
 "required": true,
 "type": "string"
 },
 "rule": {
-"description": "rule name",
+"description": "Rule name.",
 "location": "query",
 "type": "string"
 }
@@ -1198,28 +1198,19 @@
 "EVALUATION_TYPE_UNSPECIFIED",
 "SAP",
 "SQL_SERVER",
-"OTHER",
-"SCC_IAC"
-],
-"enumDeprecated": [
-false,
-false,
-false,
-false,
-true
+"OTHER"
 ],
 "enumDescriptions": [
-"Not specified",
-"SAP best practices",
-"SQL best practices",
-"Customized best practices",
-"SCC IaC (Infra as Code) best practices."
+"Not specified.",
+"SAP best practices.",
+"SQL best practices.",
+"Customized best practices."
 ],
 "location": "query",
 "type": "string"
 },
 "filter": {
-"description": "Filter based on primary_category, secondary_category",
+"description": "Filter based on primary_category, secondary_category.",
 "location": "query",
 "type": "string"
 },
@@ -1235,7 +1226,7 @@ true
 "type": "string"
 },
 "parent": {
-"description": "Required. The [project] on which to execute the request. The format is: projects/{project_id}/locations/{location} Currently, the pre-defined rules are global available to all projects and all regions",
+"description": "Required. The [project] on which to execute the request. The format is: projects/{project_id}/locations/{location} Currently, the pre-defined rules are global available to all projects and all regions.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+$",
 "required": true,
@@ -1257,7 +1248,7 @@ true
 }
 }
 },
-"revision": "20260204",
+"revision": "20260217",
 "rootUrl": "https://workloadmanager.googleapis.com/",
 "schemas": {
 "ActiveDirectory": {
@@ -1442,18 +1433,18 @@ true
 "type": "object"
 },
 "AgentCommand": {
-"description": "* An AgentCommand specifies a one-time executable program for the agent to run.",
+"description": "An AgentCommand specifies a one-time executable program for the agent to run.",
 "id": "AgentCommand",
 "properties": {
 "command": {
-"description": "command is the name of the agent one-time executable that will be invoked.",
+"description": "The name of the agent one-time executable that will be invoked.",
 "type": "string"
 },
 "parameters": {
 "additionalProperties": {
 "type": "string"
 },
-"description": "parameters is a map of key/value pairs that can be used to specify additional one-time executable settings.",
+"description": "A map of key/value pairs that can be used to specify additional one-time executable settings.",
 "type": "object"
 }
 },
@@ -1859,15 +1850,15 @@ true
 "type": "object"
 },
 "BigQueryDestination": {
-"description": "Message describing big query destination",
+"description": "BigQuery destination for evaluation results.",
 "id": "BigQueryDestination",
 "properties": {
 "createNewResultsTable": {
-"description": "Optional. determine if results will be saved in a new table",
+"description": "Optional. Determines if a new results table will be created when an Execution is created.",
 "type": "boolean"
 },
 "destinationDataset": {
-"description": "Optional. destination dataset to save evaluation results",
+"description": "Optional. Destination dataset to save evaluation results.",
 "type": "string"
 }
 },
@@ -1930,7 +1921,7 @@ true
 "type": "object"
 },
 "Command": {
-"description": "* Command specifies the type of command to execute.",
+"description": "Command specifies the type of command to execute.",
 "id": "Command",
 "properties": {
 "agentCommand": {
@@ -2253,15 +2244,15 @@ true
 "type": "object"
 },
 "Evaluation": {
-"description": "Message describing Evaluation object",
+"description": "Represents a Workload Manager Evaluation configuration. An Evaluation defines a set of rules to be validated against a scope of Cloud resources.",
 "id": "Evaluation",
 "properties": {
 "bigQueryDestination": {
 "$ref": "BigQueryDestination",
-"description": "Optional. BigQuery destination"
+"description": "Optional. The BigQuery destination for detailed evaluation results. If this field is specified, the results of each evaluation execution are exported to BigQuery."
 },
 "createTime": {
-"description": "Output only. [Output only] Create time stamp",
+"description": "Output only. [Output only] Create time stamp.",
 "format": "google-datetime",
 "readOnly": true,
 "type": "string"
@@ -2271,79 +2262,62 @@ true
 "type": "string"
 },
 "description": {
-"description": "Description of the Evaluation",
+"description": "Description of the Evaluation.",
 "type": "string"
 },
 "evaluationType": {
-"description": "Evaluation type",
+"description": "Evaluation type.",
 "enum": [
 "EVALUATION_TYPE_UNSPECIFIED",
 "SAP",
 "SQL_SERVER",
-"OTHER",
-"SCC_IAC"
-],
-"enumDeprecated": [
-false,
-false,
-false,
-false,
-true
+"OTHER"
 ],
 "enumDescriptions": [
-"Not specified",
-"SAP best practices",
-"SQL best practices",
-"Customized best practices",
-"SCC IaC (Infra as Code) best practices."
+"Not specified.",
+"SAP best practices.",
+"SQL best practices.",
+"Customized best practices."
 ],
 "type": "string"
 },
 "kmsKey": {
-"description": "Optional. Immutable. Customer-managed encryption key name, in the format projects/*/locations/*/keyRings/*/cryptoKeys/*.",
+"description": "Optional. Immutable. Customer-managed encryption key name, in the format projects/*/locations/*/keyRings/*/cryptoKeys/*. The key will be used for CMEK encryption of the evaluation resource.",
 "type": "string"
 },
 "labels": {
 "additionalProperties": {
 "type": "string"
 },
-"description": "Labels as key value pairs",
+"description": "Labels as key value pairs.",
 "type": "object"
 },
 "name": {
-"description": "name of resource names have the form 'projects/{project_id}/locations/{location_id}/evaluations/{evaluation_id}'",
+"description": "Name of resource that has the form `projects/{project_id}/locations/{location_id}/evaluations/{evaluation_id}`.",
 "type": "string"
 },
 "resourceFilter": {
 "$ref": "ResourceFilter",
-"description": "annotations as key value pairs"
+"description": "Resource filter for an evaluation defining the scope of resources to be evaluated."
 },
 "resourceStatus": {
 "$ref": "ResourceStatus",
-"description": "Output only. [Output only] The updated rule ids if exist.",
+"description": "Output only. [Output only] The current lifecycle state of the evaluation resource.",
 "readOnly": true
 },
 "ruleNames": {
-"description": "the name of the rule",
-"items": {
-"type": "string"
-},
-"type": "array"
-},
-"ruleVersions": {
-"description": "Output only. [Output only] The updated rule ids if exist.",
+"description": "The names of the rules used for this evaluation.",
 "items": {
 "type": "string"
 },
-"readOnly": true,
 "type": "array"
 },
 "schedule": {
-"description": "crontab format schedule for scheduled evaluation, currently only support the following schedule: \"0 */1 * * *\", \"0 */6 * * *\", \"0 */12 * * *\", \"0 0 */1 * *\", \"0 0 */7 * *\",",
+"description": "Crontab format schedule for scheduled evaluation, currently only supports the following fixed schedules: * `0 */1 * * *` # Hourly * `0 */6 * * *` # Every 6 hours * `0 */12 * * *` # Every 12 hours * `0 0 */1 * *` # Daily * `0 0 */7 * *` # Weekly * `0 0 */14 * *` # Every 14 days * `0 0 1 */1 *` # Monthly",
 "type": "string"
 },
 "updateTime": {
-"description": "Output only. [Output only] Update time stamp",
+"description": "Output only. [Output only] Update time stamp.",
 "format": "google-datetime",
 "readOnly": true,
 "type": "string"
@@ -2352,43 +2326,43 @@ true
 "type": "object"
 },
 "Execution": {
-"description": "Message describing Execution object",
+"description": "Execution that represents a single run of an Evaluation.",
 "id": "Execution",
 "properties": {
 "endTime": {
-"description": "Output only. [Output only] End time stamp",
+"description": "Output only. [Output only] End time stamp.",
 "format": "google-datetime",
 "readOnly": true,
 "type": "string"
 },
 "engine": {
-"description": "Optional. Engine",
+"description": "Optional. Engine.",
 "enum": [
 "ENGINE_UNSPECIFIED",
 "ENGINE_SCANNER",
 "V2"
 ],
 "enumDescriptions": [
-"The original CG",
-"SlimCG / Scanner",
-"Evaluation Engine V2"
+"The original CG.",
+"SlimCG / Scanner.",
+"Evaluation Engine V2."
 ],
 "type": "string"
 },
 "evaluationId": {
-"description": "Output only. [Output only] Evaluation ID",
+"description": "Output only. [Output only] Evaluation ID.",
 "readOnly": true,
 "type": "string"
 },
 "externalDataSources": {
-"description": "Optional. External data sources",
+"description": "Optional. External data sources.",
 "items": {
 "$ref": "ExternalDataSources"
 },
 "type": "array"
 },
 "inventoryTime": {
-"description": "Output only. [Output only] Inventory time stamp",
+"description": "Output only. [Output only] Inventory time stamp.",
 "format": "google-datetime",
 "readOnly": true,
 "type": "string"
@@ -2397,15 +2371,15 @@ true
 "additionalProperties": {
 "type": "string"
 },
-"description": "Labels as key value pairs",
+"description": "Labels as key value pairs.",
 "type": "object"
 },
 "name": {
-"description": "The name of execution resource. The format is projects/{project}/locations/{location}/evaluations/{evaluation}/executions/{execution}",
+"description": "The name of execution resource. The format is projects/{project}/locations/{location}/evaluations/{evaluation}/executions/{execution}.",
 "type": "string"
 },
 "notices": {
-"description": "Output only. Additional information generated by the execution",
+"description": "Output only. Additional information generated by the execution.",
 "items": {
 "$ref": "Notice"
 },
@@ -2414,11 +2388,11 @@ true
 },
 "resultSummary": {
 "$ref": "Summary",
-"description": "Output only. [Output only] Result summary for the execution",
+"description": "Output only. [Output only] Result summary for the execution.",
 "readOnly": true
 },
 "ruleResults": {
-"description": "Output only. execution result summary per rule",
+"description": "Output only. Execution result summary per rule.",
 "items": {
 "$ref": "RuleExecutionResult"
 },
@@ -2426,27 +2400,27 @@ true
 "type": "array"
 },
 "runType": {
-"description": "type represent whether the execution executed directly by user or scheduled according evaluation.schedule field.",
+"description": "Type which represents whether the execution executed directly by user or scheduled according to the `Evaluation.schedule` field.",
 "enum": [
 "TYPE_UNSPECIFIED",
 "ONE_TIME",
 "SCHEDULED"
 ],
 "enumDescriptions": [
-"type of execution is unspecified",
-"type of execution is one time",
-"type of execution is scheduled"
+"Type of execution is unspecified.",
+"Type of execution is one time.",
+"Type of execution is scheduled."
 ],
 "type": "string"
 },
 "startTime": {
-"description": "Output only. [Output only] Start time stamp",
+"description": "Output only. [Output only] Start time stamp.",
 "format": "google-datetime",
 "readOnly": true,
 "type": "string"
 },
 "state": {
-"description": "Output only. [Output only] State",
+"description": "Output only. [Output only] State.",
 "enum": [
 "STATE_UNSPECIFIED",
 "RUNNING",
@@ -2454,10 +2428,10 @@ true
 "FAILED"
 ],
 "enumDescriptions": [
-"state of execution is unspecified",
-"the execution is running in backend service",
-"the execution run success",
-"the execution run failed"
+"State of execution is unspecified.",
+"The execution is running in backend service.",
+"The execution run succeeded.",
+"The execution run failed."
 ],
 "readOnly": true,
 "type": "string"
@@ -2466,7 +2440,7 @@ true
 "type": "object"
 },
 "ExecutionResult": {
-"description": "Message describing the result of an execution",
+"description": "The result of an execution.",
 "id": "ExecutionResult",
 "properties": {
 "commands": {
@@ -2493,16 +2467,16 @@ true
 "type": "string"
 },
 "type": {
-"description": "Execution result type of the scanned resource",
+"description": "Execution result type of the scanned resource.",
 "enum": [
 "TYPE_UNSPECIFIED",
 "TYPE_PASSED",
 "TYPE_VIOLATED"
 ],
 "enumDescriptions": [
-"Unknown state",
-"resource successfully passed the rule",
-"resource violated the rule"
+"Unknown state.",
+"Resource successfully passed the rule.",
+"Resource violated the rule."
 ],
 "type": "string"
 },
@@ -2518,7 +2492,7 @@ true
 "type": "object"
 },
 "ExternalDataSources": {
-"description": "Message for external data sources",
+"description": "External data sources for an execution.",
 "id": "ExternalDataSources",
 "properties": {
 "assetType": {
@@ -2526,34 +2500,34 @@ true
 "type": "string"
 },
 "name": {
-"description": "Optional. Name of external data source. The name will be used inside the rego/sql to refer the external data",
+"description": "Optional. Name of external data source. The name will be used inside the rego/sql to refer the external data.",
 "type": "string"
 },
 "type": {
-"description": "Required. Type of external data source",
+"description": "Required. Type of external data source.",
 "enum": [
 "TYPE_UNSPECIFIED",
 "BIG_QUERY_TABLE"
 ],
 "enumDescriptions": [
-"Unknown type",
-"BigQuery table"
+"Unknown type.",
+"BigQuery table."
 ],
 "type": "string"
 },
 "uri": {
-"description": "Required. URI of external data source. example of bq table {project_ID}.{dataset_ID}.{table_ID}",
+"description": "Required. URI of external data source. example of bq table {project_ID}.{dataset_ID}.{table_ID}.",
 "type": "string"
 }
 },
 "type": "object"
 },
 "GceInstanceFilter": {
-"description": "Message describing compute engine instance filter",
+"description": "A filter for matching Compute Engine instances.",
 "id": "GceInstanceFilter",
 "properties": {
 "serviceAccounts": {
-"description": "Service account of compute engine",
+"description": "If non-empty, only Compute Engine instances associated with at least one of the provided service accounts will be included in the evaluation.",
 "items": {
 "type": "string"
 },
@@ -2718,43 +2692,6 @@ true
 },
 "type": "object"
 },
-"InvalidRule": {
-"description": "Message represent an rule that failed to be validated.",
-"id": "InvalidRule",
-"properties": {
-"displayName": {
-"description": "display name of the invalid rule",
-"type": "string"
-},
-"gcsUri": {
-"description": "cloud storage destination of the invalid rule",
-"type": "string"
-},
-"name": {
-"description": "name of the invalid rule",
-"type": "string"
-},
-"valiadtionError": {
-"description": "The error message of valdating rule formats.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"InvalidRulesWrapper": {
-"description": "Message wrappes a list of invalid rules.",
-"id": "InvalidRulesWrapper",
-"properties": {
-"invalidRules": {
-"description": "The invalid rules that failed to be validated.",
-"items": {
-"$ref": "InvalidRule"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
 "ListActuationsResponse": {
 "description": "The response object from `ListActuations`.",
 "id": "ListActuationsResponse",
@@ -2833,11 +2770,11 @@ true
 "type": "object"
 },
 "ListEvaluationsResponse": {
-"description": "Message for response to listing Evaluations",
+"description": "Response message for the ListEvaluations RPC.",
 "id": "ListEvaluationsResponse",
 "properties": {
 "evaluations": {
-"description": "The list of Evaluation",
+"description": "The list of evaluations.",
 "items": {
 "$ref": "Evaluation"
 },
@@ -2858,7 +2795,7 @@ true
 "type": "object"
 },
 "ListExecutionResultsResponse": {
-"description": "Message for response of list execution results",
+"description": "Response message for the ListExecutionResults RPC.",
 "id": "ListExecutionResultsResponse",
 "properties": {
 "executionResults": {
@@ -2876,11 +2813,11 @@ true
 "type": "object"
 },
 "ListExecutionsResponse": {
-"description": "Message for response to listing Executions",
+"description": "Response message for the ListExecutions RPC.",
 "id": "ListExecutionsResponse",
 "properties": {
 "executions": {
-"description": "The list of Execution",
+"description": "The list of Execution.",
 "items": {
 "$ref": "Execution"
 },
@@ -2944,15 +2881,11 @@ true
 "type": "object"
 },
 "ListRulesResponse": {
-"description": "Mesesage of response of list rules",
+"description": "Response message for the ListRules RPC.",
 "id": "ListRulesResponse",
 "properties": {
-"invalidRulesWrapper": {
-"$ref": "InvalidRulesWrapper",
-"description": "A wrapper of the invalid rules that failed to be validated."
-},
 "rules": {
-"description": "all rules in response",
+"description": "All rules in response.",
 "items": {
 "$ref": "Rule"
 },
@@ -2962,7 +2895,7 @@ true
 "type": "object"
 },
 "ListScannedResourcesResponse": {
-"description": "Message for response to list scanned resources",
+"description": "Response message for the ListScannedResources RPC.",
 "id": "ListScannedResourcesResponse",
 "properties": {
 "nextPageToken": {
@@ -2970,7 +2903,7 @@ true
 "type": "string"
 },
 "scannedResources": {
-"description": "All scanned resources in response",
+"description": "All scanned resources in response.",
 "items": {
 "$ref": "ScannedResource"
 },
@@ -3081,11 +3014,11 @@ true
 "type": "object"
 },
 "Notice": {
-"description": "Message for additional information generated by the execution",
+"description": "Additional information generated by an execution.",
 "id": "Notice",
 "properties": {
 "message": {
-"description": "Output only. Message of the notice",
+"description": "Output only. Message of the notice.",
 "readOnly": true,
 "type": "string"
 }
@@ -3237,7 +3170,7 @@ true
 "type": "object"
 },
 "Resource": {
-"description": "Message represent resource in execution result",
+"description": "Resource in execution result.",
 "id": "Resource",
 "properties": {
 "name": {
@@ -3256,29 +3189,29 @@ true
 "type": "object"
 },
 "ResourceFilter": {
-"description": "Message describing resource filters",
+"description": "Resource filter for an evaluation defining the scope of resources to be evaluated.",
 "id": "ResourceFilter",
 "properties": {
 "gceInstanceFilter": {
 "$ref": "GceInstanceFilter",
-"description": "Filter compute engine resource"
+"description": "Filter compute engine resources."
 },
 "inclusionLabels": {
 "additionalProperties": {
 "type": "string"
 },
-"description": "The label used for filter resource",
+"description": "Labels to filter resources by. Each key-value pair in the map must exist on the resource for it to be included (e.g. VM instance labels). For example, specifying `{ \"env\": \"prod\", \"database\": \"nosql\" }` will only include resources that have labels `env=prod` and `database=nosql`.",
 "type": "object"
 },
 "resourceIdPatterns": {
-"description": "The id pattern for filter resource",
+"description": "The pattern to filter resources by their id For example, a pattern of \".*prod-cluster.*\" will match all resources that contain \"prod-cluster\" in their ID.",
 "items": {
 "type": "string"
 },
 "type": "array"
 },
 "scopes": {
-"description": "The scopes of evaluation resource",
+"description": "The scopes of evaluation resource. Format: * `projects/{project_id}` * `folders/{folder_id}` * `organizations/{organization_id}`",
 "items": {
 "type": "string"
 },
@@ -3288,19 +3221,11 @@ true
 "type": "object"
 },
 "ResourceStatus": {
-"description": "Message describing resource status",
+"description": "The lifecycle status of an Evaluation resource.",
 "id": "ResourceStatus",
 "properties": {
-"rulesNewerVersions": {
-"deprecated": true,
-"description": "Historical: Used before 2023-05-22 the new version of rule id if exists",
-"items": {
-"type": "string"
-},
-"type": "array"
-},
 "state": {
-"description": "State of the resource",
+"description": "State of the Evaluation resource.",
 "enum": [
 "STATE_UNSPECIFIED",
 "CREATING",
@@ -3319,7 +3244,7 @@ true
 "type": "object"
 },
 "Rule": {
-"description": "Message represent a rule",
+"description": "A rule to be evaluated.",
 "id": "Rule",
 "properties": {
 "assetType": {
@@ -3327,31 +3252,31 @@ true
 "type": "string"
 },
 "description": {
-"description": "descrite rule in plain language",
+"description": "Describe rule in plain language.",
 "type": "string"
 },
 "displayName": {
-"description": "the name display in UI",
+"description": "The name display in UI.",
 "type": "string"
 },
 "errorMessage": {
-"description": "the message template for rule",
+"description": "The message template for rule.",
 "type": "string"
 },
 "name": {
-"description": "rule name",
+"description": "Rule name.",
 "type": "string"
 },
 "primaryCategory": {
-"description": "the primary category",
+"description": "The primary category.",
 "type": "string"
 },
 "remediation": {
-"description": "the remediation for the rule",
+"description": "The remediation for the rule.",
 "type": "string"
 },
 "revisionId": {
-"description": "Output only. the version of the rule",
+"description": "Output only. The version of the rule.",
 "readOnly": true,
 "type": "string"
 },
@@ -3364,57 +3289,57 @@ true
 ],
 "enumDescriptions": [
 "Not specified.",
-"Baseline rules",
-"Custom rules"
+"Baseline rules.",
+"Custom rules."
 ],
 "type": "string"
 },
 "secondaryCategory": {
-"description": "the secondary category",
+"description": "The secondary category.",
 "type": "string"
 },
 "severity": {
-"description": "the severity of the rule",
+"description": "The severity of the rule.",
 "type": "string"
 },
 "tags": {
-"description": "List of user-defined tags",
+"description": "List of user-defined tags.",
 "items": {
 "type": "string"
 },
 "type": "array"
 },
 "uri": {
-"description": "the docuement url for the rule",
+"description": "The document url for the rule.",
 "type": "string"
 }
 },
 "type": "object"
 },
 "RuleExecutionResult": {
-"description": "Message for execution result summary per rule",
+"description": "Execution result summary per rule.",
 "id": "RuleExecutionResult",
 "properties": {
 "message": {
-"description": "Execution message, if any",
+"description": "Execution message, if any.",
 "type": "string"
 },
 "resultCount": {
-"description": "Number of violations",
+"description": "Number of violations.",
 "format": "int64",
 "type": "string"
 },
 "rule": {
-"description": "rule name",
+"description": "Rule name as plain text like `sap-hana-configured`.",
 "type": "string"
 },
 "scannedResourceCount": {
-"description": "Number of total scanned resources",
+"description": "Number of total scanned resources.",
 "format": "int64",
 "type": "string"
 },
 "state": {
-"description": "Output only. The execution status",
+"description": "Output only. The execution status.",
 "enum": [
 "STATE_UNSPECIFIED",
 "STATE_SUCCESS",
@@ -3423,9 +3348,9 @@ true
 ],
 "enumDescriptions": [
 "Unknown state",
-"execution completed successfully",
-"execution completed with failures",
-"execution was not executed"
+"Execution completed successfully",
+"Execution completed with failures",
+"Execution was not executed"
 ],
 "readOnly": true,
 "type": "string"
@@ -3454,15 +3379,15 @@ true
 "type": "object"
 },
 "RunEvaluationRequest": {
-"description": "Message for creating a Execution",
+"description": "Request message for the RunEvaluation RPC.",
 "id": "RunEvaluationRequest",
 "properties": {
 "execution": {
 "$ref": "Execution",
-"description": "Required. The resource being created"
+"description": "Required. The resource being created."
 },
 "executionId": {
-"description": "Required. Id of the requesting object If auto-generating Id server-side, remove this field and execution_id from the method_signature of Create RPC",
+"description": "Required. ID of the execution which will be created.",
 "type": "string"
 },
 "requestId": {
@@ -4310,15 +4235,15 @@ true
 "type": "object"
 },
 "ScannedResource": {
-"description": "Message of scanned resource",
+"description": "A scanned resource.",
 "id": "ScannedResource",
 "properties": {
 "resource": {
-"description": "resource name",
+"description": "Resource name.",
 "type": "string"
 },
 "type": {
-"description": "resource type",
+"description": "Resource type.",
 "type": "string"
 }
 },
@@ -4361,15 +4286,15 @@ true
 "type": "object"
 },
 "ShellCommand": {
-"description": "* A ShellCommand is invoked via the agent's command line executor",
+"description": "A ShellCommand is invoked via the agent's command line executor.",
 "id": "ShellCommand",
 "properties": {
 "args": {
-"description": "args is a string of arguments to be passed to the command.",
+"description": "Arguments to be passed to the command.",
 "type": "string"
 },
 "command": {
-"description": "command is the name of the command to be executed.",
+"description": "The name of the command to be executed.",
 "type": "string"
 },
 "timeoutSeconds": {
@@ -4714,23 +4639,23 @@ true
 "type": "object"
 },
 "Summary": {
-"description": "Message for execution summary",
+"description": "Execution summary.",
 "id": "Summary",
 "properties": {
 "failures": {
-"description": "Output only. Number of failures",
+"description": "Output only. Number of failures.",
 "format": "int64",
 "readOnly": true,
 "type": "string"
 },
 "newFailures": {
-"description": "Output only. Number of new failures compared to the previous execution",
+"description": "Output only. Number of new failures compared to the previous execution.",
 "format": "int64",
 "readOnly": true,
 "type": "string"
 },
 "newFixes": {
-"description": "Output only. Number of new fixes compared to the previous execution",
+"description": "Output only. Number of new fixes compared to the previous execution.",
 "format": "int64",
 "readOnly": true,
 "type": "string"
@@ -4821,7 +4746,7 @@ true
 "type": "object"
 },
 "ViolationDetails": {
-"description": "Message describing the violation in an evaluation result.",
+"description": "The violation in an evaluation result.",
 "id": "ViolationDetails",
 "properties": {
 "asset": {