Update discovery documents and generated code

automatically_generated_update
googleapis · Oct 26, 2023 · 0ac3f1c · 0ac3f1c
1 parent 2c037ac
commit 0ac3f1c
Show file tree

Hide file tree

Showing 136 changed files with 10,055 additions and 770 deletions.
diff --git a/DiscoveryJson/admin_directory_v1.json b/DiscoveryJson/admin_directory_v1.json
@@ -4643,7 +4643,7 @@
       }
     }
   },
-  "revision": "20231017",
+  "revision": "20231023",
   "rootUrl": "https://admin.googleapis.com/",
   "schemas": {
     "Alias": {

diff --git a/DiscoveryJson/aiplatform_v1.json b/DiscoveryJson/aiplatform_v1.json
@@ -12998,7 +12998,7 @@
    }
   }
  },
- "revision": "20231012",
+ "revision": "20231023",
  "rootUrl": "https://aiplatform.googleapis.com/",
  "schemas": {
   "GoogleApiHttpBody": {
@@ -14711,7 +14711,7 @@
      "type": "string"
     },
     "protectedArtifactLocationId": {
-     "description": "The ID of the location to store protected artifacts. e.g. us-central1. Populate only when the location is different than CustomJob location. For unprotected artifacts, the value of this field is ignored. List of supported locations: https://cloud.google.com/vertex-ai/docs/general/locations",
+     "description": "The ID of the location to store protected artifacts. e.g. us-central1. Populate only when the location is different than CustomJob location. List of supported locations: https://cloud.google.com/vertex-ai/docs/general/locations",
      "type": "string"
     },
     "reservedIpRanges": {
@@ -26815,7 +26815,7 @@
    "type": "object"
   },
   "GoogleCloudAiplatformV1Study": {
-   "description": "A message representing a Study.",
+   "description": "A message representing a Study. Next id: 12",
    "id": "GoogleCloudAiplatformV1Study",
    "properties": {
     "createTime": {
@@ -26933,6 +26933,10 @@
       "$ref": "GoogleCloudAiplatformV1StudySpecParameterSpec"
      },
      "type": "array"
+    },
+    "studyStoppingConfig": {
+     "$ref": "GoogleCloudAiplatformV1StudySpecStudyStoppingConfig",
+     "description": "Conditions for automated stopping of a Study. Enable automated stopping by configuring at least one condition."
     }
    },
    "type": "object"
@@ -27238,6 +27242,62 @@
    },
    "type": "object"
   },
+  "GoogleCloudAiplatformV1StudySpecStudyStoppingConfig": {
+   "description": "The configuration (stopping conditions) for automated stopping of a Study. Conditions include trial budgets, time budgets, and convergence detection.",
+   "id": "GoogleCloudAiplatformV1StudySpecStudyStoppingConfig",
+   "properties": {
+    "maxDurationNoProgress": {
+     "description": "If the objective value has not improved for this much time, stop the study. WARNING: Effective only for single-objective studies.",
+     "format": "google-duration",
+     "type": "string"
+    },
+    "maxNumTrials": {
+     "description": "If there are more than this many trials, stop the study.",
+     "format": "int32",
+     "type": "integer"
+    },
+    "maxNumTrialsNoProgress": {
+     "description": "If the objective value has not improved for this many consecutive trials, stop the study. WARNING: Effective only for single-objective studies.",
+     "format": "int32",
+     "type": "integer"
+    },
+    "maximumRuntimeConstraint": {
+     "$ref": "GoogleCloudAiplatformV1StudyTimeConstraint",
+     "description": "If the specified time or duration has passed, stop the study."
+    },
+    "minNumTrials": {
+     "description": "If there are fewer than this many COMPLETED trials, do not stop the study.",
+     "format": "int32",
+     "type": "integer"
+    },
+    "minimumRuntimeConstraint": {
+     "$ref": "GoogleCloudAiplatformV1StudyTimeConstraint",
+     "description": "Each \"stopping rule\" in this proto specifies an \"if\" condition. Before Vizier would generate a new suggestion, it first checks each specified stopping rule, from top to bottom in this list. Note that the first few rules (e.g. minimum_runtime_constraint, min_num_trials) will prevent other stopping rules from being evaluated until they are met. For example, setting `min_num_trials=5` and `always_stop_after= 1 hour` means that the Study will ONLY stop after it has 5 COMPLETED trials, even if more than an hour has passed since its creation. It follows the first applicable rule (whose \"if\" condition is satisfied) to make a stopping decision. If none of the specified rules are applicable, then Vizier decides that the study should not stop. If Vizier decides that the study should stop, the study enters STOPPING state (or STOPPING_ASAP if should_stop_asap = true). IMPORTANT: The automatic study state transition happens precisely as described above; that is, deleting trials or updating StudyConfig NEVER automatically moves the study state back to ACTIVE. If you want to _resume_ a Study that was stopped, 1) change the stopping conditions if necessary, 2) activate the study, and then 3) ask for suggestions. If the specified time or duration has not passed, do not stop the study."
+    },
+    "shouldStopAsap": {
+     "description": "If true, a Study enters STOPPING_ASAP whenever it would normally enters STOPPING state. The bottom line is: set to true if you want to interrupt on-going evaluations of Trials as soon as the study stopping condition is met. (Please see Study.State documentation for the source of truth).",
+     "type": "boolean"
+    }
+   },
+   "type": "object"
+  },
+  "GoogleCloudAiplatformV1StudyTimeConstraint": {
+   "description": "Time-based Constraint for Study",
+   "id": "GoogleCloudAiplatformV1StudyTimeConstraint",
+   "properties": {
+    "endTime": {
+     "description": "Compares the wallclock time to this time. Must use UTC timezone.",
+     "format": "google-datetime",
+     "type": "string"
+    },
+    "maxDuration": {
+     "description": "Counts the wallclock time passed since the creation of this Study.",
+     "format": "google-duration",
+     "type": "string"
+    }
+   },
+   "type": "object"
+  },
   "GoogleCloudAiplatformV1SuggestTrialsMetadata": {
    "description": "Details of operations that perform Trials suggestion.",
    "id": "GoogleCloudAiplatformV1SuggestTrialsMetadata",

diff --git a/DiscoveryJson/aiplatform_v1beta1.json b/DiscoveryJson/aiplatform_v1beta1.json
@@ -16094,7 +16094,7 @@
    }
   }
  },
- "revision": "20231012",
+ "revision": "20231023",
  "rootUrl": "https://aiplatform.googleapis.com/",
  "schemas": {
   "GoogleApiHttpBody": {
@@ -17987,7 +17987,7 @@
      "type": "string"
     },
     "protectedArtifactLocationId": {
-     "description": "The ID of the location to store protected artifacts. e.g. us-central1. Populate only when the location is different than CustomJob location. For unprotected artifacts, the value of this field is ignored. List of supported locations: https://cloud.google.com/vertex-ai/docs/general/locations",
+     "description": "The ID of the location to store protected artifacts. e.g. us-central1. Populate only when the location is different than CustomJob location. List of supported locations: https://cloud.google.com/vertex-ai/docs/general/locations",
      "type": "string"
     },
     "reservedIpRanges": {
@@ -31302,7 +31302,7 @@
    "type": "object"
   },
   "GoogleCloudAiplatformV1beta1Study": {
-   "description": "A message representing a Study.",
+   "description": "A message representing a Study. Next id: 12",
    "id": "GoogleCloudAiplatformV1beta1Study",
    "properties": {
     "createTime": {
@@ -31426,6 +31426,10 @@
      },
      "type": "array"
     },
+    "studyStoppingConfig": {
+     "$ref": "GoogleCloudAiplatformV1beta1StudySpecStudyStoppingConfig",
+     "description": "Conditions for automated stopping of a Study. Enable automated stopping by configuring at least one condition."
+    },
     "transferLearningConfig": {
      "$ref": "GoogleCloudAiplatformV1beta1StudySpecTransferLearningConfig",
      "description": "The configuration info/options for transfer learning. Currently supported for Vertex AI Vizier service, not HyperParameterTuningJob"
@@ -31765,6 +31769,45 @@
    },
    "type": "object"
   },
+  "GoogleCloudAiplatformV1beta1StudySpecStudyStoppingConfig": {
+   "description": "The configuration (stopping conditions) for automated stopping of a Study. Conditions include trial budgets, time budgets, and convergence detection.",
+   "id": "GoogleCloudAiplatformV1beta1StudySpecStudyStoppingConfig",
+   "properties": {
+    "maxDurationNoProgress": {
+     "description": "If the objective value has not improved for this much time, stop the study. WARNING: Effective only for single-objective studies.",
+     "format": "google-duration",
+     "type": "string"
+    },
+    "maxNumTrials": {
+     "description": "If there are more than this many trials, stop the study.",
+     "format": "int32",
+     "type": "integer"
+    },
+    "maxNumTrialsNoProgress": {
+     "description": "If the objective value has not improved for this many consecutive trials, stop the study. WARNING: Effective only for single-objective studies.",
+     "format": "int32",
+     "type": "integer"
+    },
+    "maximumRuntimeConstraint": {
+     "$ref": "GoogleCloudAiplatformV1beta1StudyTimeConstraint",
+     "description": "If the specified time or duration has passed, stop the study."
+    },
+    "minNumTrials": {
+     "description": "If there are fewer than this many COMPLETED trials, do not stop the study.",
+     "format": "int32",
+     "type": "integer"
+    },
+    "minimumRuntimeConstraint": {
+     "$ref": "GoogleCloudAiplatformV1beta1StudyTimeConstraint",
+     "description": "Each \"stopping rule\" in this proto specifies an \"if\" condition. Before Vizier would generate a new suggestion, it first checks each specified stopping rule, from top to bottom in this list. Note that the first few rules (e.g. minimum_runtime_constraint, min_num_trials) will prevent other stopping rules from being evaluated until they are met. For example, setting `min_num_trials=5` and `always_stop_after= 1 hour` means that the Study will ONLY stop after it has 5 COMPLETED trials, even if more than an hour has passed since its creation. It follows the first applicable rule (whose \"if\" condition is satisfied) to make a stopping decision. If none of the specified rules are applicable, then Vizier decides that the study should not stop. If Vizier decides that the study should stop, the study enters STOPPING state (or STOPPING_ASAP if should_stop_asap = true). IMPORTANT: The automatic study state transition happens precisely as described above; that is, deleting trials or updating StudyConfig NEVER automatically moves the study state back to ACTIVE. If you want to _resume_ a Study that was stopped, 1) change the stopping conditions if necessary, 2) activate the study, and then 3) ask for suggestions. If the specified time or duration has not passed, do not stop the study."
+    },
+    "shouldStopAsap": {
+     "description": "If true, a Study enters STOPPING_ASAP whenever it would normally enters STOPPING state. The bottom line is: set to true if you want to interrupt on-going evaluations of Trials as soon as the study stopping condition is met. (Please see Study.State documentation for the source of truth).",
+     "type": "boolean"
+    }
+   },
+   "type": "object"
+  },
   "GoogleCloudAiplatformV1beta1StudySpecTransferLearningConfig": {
    "description": "This contains flag for manually disabling transfer learning for a study. The names of prior studies being used for transfer learning (if any) are also listed here.",
    "id": "GoogleCloudAiplatformV1beta1StudySpecTransferLearningConfig",
@@ -31784,6 +31827,23 @@
    },
    "type": "object"
   },
+  "GoogleCloudAiplatformV1beta1StudyTimeConstraint": {
+   "description": "Time-based Constraint for Study",
+   "id": "GoogleCloudAiplatformV1beta1StudyTimeConstraint",
+   "properties": {
+    "endTime": {
+     "description": "Compares the wallclock time to this time. Must use UTC timezone.",
+     "format": "google-datetime",
+     "type": "string"
+    },
+    "maxDuration": {
+     "description": "Counts the wallclock time passed since the creation of this Study.",
+     "format": "google-duration",
+     "type": "string"
+    }
+   },
+   "type": "object"
+  },
   "GoogleCloudAiplatformV1beta1SuggestTrialsMetadata": {
    "description": "Details of operations that perform Trials suggestion.",
    "id": "GoogleCloudAiplatformV1beta1SuggestTrialsMetadata",

diff --git a/DiscoveryJson/androidmanagement_v1.json b/DiscoveryJson/androidmanagement_v1.json
@@ -1095,7 +1095,7 @@
    }
   }
  },
- "revision": "20231009",
+ "revision": "20231016",
  "rootUrl": "https://androidmanagement.googleapis.com/",
  "schemas": {
   "AdbShellCommandEvent": {
@@ -3031,7 +3031,7 @@
    "type": "object"
   },
   "FreezePeriod": {
-   "description": "A system freeze period. When a device\u2019s clock is within the freeze period, all incoming system updates (including security patches) are blocked and won\u2019t be installed. When a device is outside the freeze period, normal update behavior applies. Leap years are ignored in freeze period calculations, in particular: * If Feb. 29th is set as the start or end date of a freeze period, the freeze period will start or end on Feb. 28th instead. * When a device\u2019s system clock reads Feb. 29th, it\u2019s treated as Feb. 28th. * When calculating the number of days in a freeze period or the time between two freeze periods, Feb. 29th is ignored and not counted as a day.Note: For Freeze Periods to take effect, SystemUpdateType cannot be specified as SYSTEM_UPDATE_TYPE_UNSPECIFIED, because freeze periods require a defined policy to be specified.",
+   "description": "A system freeze period. When a device\u2019s clock is within the freeze period, all incoming system updates (including security patches) are blocked and won\u2019t be installed.When the device is outside any set freeze periods, the normal policy behavior (automatic, windowed, or postponed) applies.Leap years are ignored in freeze period calculations, in particular: If Feb. 29th is set as the start or end date of a freeze period, the freeze period will start or end on Feb. 28th instead. When a device\u2019s system clock reads Feb. 29th, it\u2019s treated as Feb. 28th. When calculating the number of days in a freeze period or the time between two freeze periods, Feb. 29th is ignored and not counted as a day.Note: For Freeze Periods to take effect, SystemUpdateType cannot be specified as SYSTEM_UPDATE_TYPE_UNSPECIFIED, because freeze periods require a defined policy to be specified.",
    "id": "FreezePeriod",
    "properties": {
     "endDate": {
@@ -4375,7 +4375,7 @@
      "type": "boolean"
     },
     "maxDaysWithWorkOff": {
-     "description": "Controls how long the work profile can stay off. The minimum duration must be at least 3 days. Other details are as follows: - If the duration is set to 0, the feature is turned off. - If the duration is set to any value between 1-2 days, the feature is automatically set to 3 days. *Note:* If you want to avoid personal profiles being suspended during long periods of off-time, you can temporarily set a large value for this parameter.",
+     "description": "Controls how long the work profile can stay off. The minimum duration must be at least 3 days. Other details are as follows: - If the duration is set to 0, the feature is turned off. - If the duration is set to a value smaller than the minimum duration, the feature returns an error. *Note:* If you want to avoid personal profiles being suspended during long periods of off-time, you can temporarily set a large value for this parameter.",
      "format": "int32",
      "type": "integer"
     },