docs: Resource Settings is deprecated. As of November 7, 2023, no org…

…anizations will be onboarded for any of the enabled settings, and the service will be shut down on October 1, 2024 (#7358) PiperOrigin-RevId: 639070750 Source-Link: googleapis/googleapis@7f62415 Source-Link: googleapis/googleapis-gen@9fd8f8e Copy-Tag: eyJwIjoiUmVzb3VyY2VTZXR0aW5ncy8uT3dsQm90LnlhbWwiLCJoIjoiOWZkOGY4ZTkxMzY5N2RiNDI0NWJmOTkxZmNmZTkzYmJhYzRlZjE4NSJ9
googleapis · Jun 4, 2024 · 7a1be5a · 7a1be5a
1 parent 23415ce
commit 7a1be5a
Show file tree

Hide file tree

Showing 12 changed files with 139 additions and 84 deletions.
diff --git a/ResourceSettings/metadata/V1/ResourceSettings.php b/ResourceSettings/metadata/V1/ResourceSettings.php
diff --git a/ResourceSettings/samples/V1/ResourceSettingsServiceClient/get_setting.php b/ResourceSettings/samples/V1/ResourceSettingsServiceClient/get_setting.php
@@ -34,7 +34,8 @@
  * Returns a `google.rpc.Status` with `google.rpc.Code.NOT_FOUND` if the
  * setting does not exist.
  *
- * @param string $formattedName The name of the setting to get. See [Setting][google.cloud.resourcesettings.v1.Setting] for naming
+ * @param string $formattedName The name of the setting to get. See
+ *                              [Setting][google.cloud.resourcesettings.v1.Setting] for naming
  *                              requirements. Please see
  *                              {@see ResourceSettingsServiceClient::settingName()} for help formatting this field.
  */

diff --git a/ResourceSettings/samples/V1/ResourceSettingsServiceClient/list_settings.php b/ResourceSettings/samples/V1/ResourceSettingsServiceClient/list_settings.php
@@ -32,8 +32,8 @@
 /**
  * Lists all the settings that are available on the Cloud resource `parent`.
  *
- * @param string $parent The Cloud resource that parents the setting. Must be in one of the
- *                       following forms:
+ * @param string $parent The Cloud resource that parents the setting. Must be in one of
+ *                       the following forms:
  *
  *                       * `projects/{project_number}`
  *                       * `projects/{project_id}`

diff --git a/ResourceSettings/src/V1/Client/ResourceSettingsServiceClient.php b/ResourceSettings/src/V1/Client/ResourceSettingsServiceClient.php
@@ -52,6 +52,9 @@
  * resource is not in a Cloud Organization.
  * For all requests, returns a `google.rpc.Status` with
  * `google.rpc.Code.INVALID_ARGUMENT` if the request is malformed.
+ * (== deprecation_description Resource Settings is deprecated. As of November
+ * 7, 2023, no organizations will be onboarded for any of the enabled settings,
+ * and the service will be shut down on October 1, 2024. ==)
  *
  * This class provides the ability to make remote calls to the backing service through method
  * calls that map to API methods.
@@ -61,6 +64,8 @@
  * name, and additionally a parseName method to extract the individual identifiers
  * contained within formatted names that are returned by the API.
  *
+ * @deprecated This class will be removed in the next major version update.
+ *
  * @method PromiseInterface getSettingAsync(GetSettingRequest $request, array $optionalArgs = [])
  * @method PromiseInterface listSettingsAsync(ListSettingsRequest $request, array $optionalArgs = [])
  * @method PromiseInterface updateSettingAsync(UpdateSettingRequest $request, array $optionalArgs = [])

diff --git a/ResourceSettings/src/V1/Gapic/ResourceSettingsServiceGapicClient.php b/ResourceSettings/src/V1/Gapic/ResourceSettingsServiceGapicClient.php
@@ -53,6 +53,9 @@
  * resource is not in a Cloud Organization.
  * For all requests, returns a `google.rpc.Status` with
  * `google.rpc.Code.INVALID_ARGUMENT` if the request is malformed.
+ * (== deprecation_description Resource Settings is deprecated. As of November
+ * 7, 2023, no organizations will be onboarded for any of the enabled settings,
+ * and the service will be shut down on October 1, 2024. ==)
  *
  * This class provides the ability to make remote calls to the backing service through method
  * calls that map to API methods. Sample code to get started:
@@ -395,7 +398,8 @@ public function __construct(array $options = [])
      * }
      * ```
      *
-     * @param string $name         Required. The name of the setting to get. See [Setting][google.cloud.resourcesettings.v1.Setting] for naming
+     * @param string $name         Required. The name of the setting to get. See
+     *                             [Setting][google.cloud.resourcesettings.v1.Setting] for naming
      *                             requirements.
      * @param array  $optionalArgs {
      *     Optional.
@@ -463,8 +467,8 @@ public function getSetting($name, array $optionalArgs = [])
      * }
      * ```
      *
-     * @param string $parent       Required. The Cloud resource that parents the setting. Must be in one of the
-     *                             following forms:
+     * @param string $parent       Required. The Cloud resource that parents the setting. Must be in one of
+     *                             the following forms:
      *
      *                             * `projects/{project_number}`
      *                             * `projects/{project_id}`
@@ -556,7 +560,8 @@ public function listSettings($parent, array $optionalArgs = [])
      * }
      * ```
      *
-     * @param Setting $setting      Required. The setting to update. See [Setting][google.cloud.resourcesettings.v1.Setting] for field requirements.
+     * @param Setting $setting      Required. The setting to update. See
+     *                              [Setting][google.cloud.resourcesettings.v1.Setting] for field requirements.
      * @param array   $optionalArgs {
      *     Optional.
      *

diff --git a/ResourceSettings/src/V1/GetSettingRequest.php b/ResourceSettings/src/V1/GetSettingRequest.php
diff --git a/ResourceSettings/src/V1/ListSettingsRequest.php b/ResourceSettings/src/V1/ListSettingsRequest.php