docs: [Kms] Update the comment for duration value unrefreshed_duration_until_disable to accurately reflect the system-defined duration

Kms/samples/V1/AutokeyAdminClient/list_locations.php

@@ -31,13 +31,22 @@
 
 /**
  * Lists information about the supported locations for this service.
-This method can be called in two ways:
 
-*   **List all public locations:** Use the path `GET /v1/locations`.
-*   **List project-visible locations:** Use the path
-`GET /v1/projects/{project_id}/locations`. This may include public
-locations as well as private or other locations specifically visible
-to the project.
+This method lists locations based on the resource scope provided in
+the [ListLocationsRequest.name] field:
+
+* **Global locations**: If `name` is empty, the method lists the
+public locations available to all projects. * **Project-specific
+locations**: If `name` follows the format
+`projects/{project}`, the method lists locations visible to that
+specific project. This includes public, private, or other
+project-specific locations enabled for the project.
+
+For gRPC and client library implementations, the resource name is
+passed as the `name` field. For direct service calls, the resource
+name is
+incorporated into the request path based on the specific service
+implementation and version.
  *
  * This sample has been automatically generated and should be regarded as a code
  * template only. It will require modifications to work:

Kms/samples/V1/AutokeyClient/list_locations.php

@@ -31,13 +31,22 @@
 
 /**
  * Lists information about the supported locations for this service.
-This method can be called in two ways:
 
-*   **List all public locations:** Use the path `GET /v1/locations`.
-*   **List project-visible locations:** Use the path
-`GET /v1/projects/{project_id}/locations`. This may include public
-locations as well as private or other locations specifically visible
-to the project.
+This method lists locations based on the resource scope provided in
+the [ListLocationsRequest.name] field:
+
+* **Global locations**: If `name` is empty, the method lists the
+public locations available to all projects. * **Project-specific
+locations**: If `name` follows the format
+`projects/{project}`, the method lists locations visible to that
+specific project. This includes public, private, or other
+project-specific locations enabled for the project.
+
+For gRPC and client library implementations, the resource name is
+passed as the `name` field. For direct service calls, the resource
+name is
+incorporated into the request path based on the specific service
+implementation and version.
  *
  * This sample has been automatically generated and should be regarded as a code
  * template only. It will require modifications to work:

Kms/samples/V1/EkmServiceClient/list_locations.php

@@ -31,13 +31,22 @@
 
 /**
  * Lists information about the supported locations for this service.
-This method can be called in two ways:
 
-*   **List all public locations:** Use the path `GET /v1/locations`.
-*   **List project-visible locations:** Use the path
-`GET /v1/projects/{project_id}/locations`. This may include public
-locations as well as private or other locations specifically visible
-to the project.
+This method lists locations based on the resource scope provided in
+the [ListLocationsRequest.name] field:
+
+* **Global locations**: If `name` is empty, the method lists the
+public locations available to all projects. * **Project-specific
+locations**: If `name` follows the format
+`projects/{project}`, the method lists locations visible to that
+specific project. This includes public, private, or other
+project-specific locations enabled for the project.
+
+For gRPC and client library implementations, the resource name is
+passed as the `name` field. For direct service calls, the resource
+name is
+incorporated into the request path based on the specific service
+implementation and version.
  *
  * This sample has been automatically generated and should be regarded as a code
  * template only. It will require modifications to work:

Kms/samples/V1/HsmManagementClient/list_locations.php

@@ -31,13 +31,22 @@
 
 /**
  * Lists information about the supported locations for this service.
-This method can be called in two ways:
 
-*   **List all public locations:** Use the path `GET /v1/locations`.
-*   **List project-visible locations:** Use the path
-`GET /v1/projects/{project_id}/locations`. This may include public
-locations as well as private or other locations specifically visible
-to the project.
+This method lists locations based on the resource scope provided in
+the [ListLocationsRequest.name] field:
+
+* **Global locations**: If `name` is empty, the method lists the
+public locations available to all projects. * **Project-specific
+locations**: If `name` follows the format
+`projects/{project}`, the method lists locations visible to that
+specific project. This includes public, private, or other
+project-specific locations enabled for the project.
+
+For gRPC and client library implementations, the resource name is
+passed as the `name` field. For direct service calls, the resource
+name is
+incorporated into the request path based on the specific service
+implementation and version.
  *
  * This sample has been automatically generated and should be regarded as a code
  * template only. It will require modifications to work:

Kms/samples/V1/KeyManagementServiceClient/list_locations.php

@@ -31,13 +31,22 @@
 
 /**
  * Lists information about the supported locations for this service.
-This method can be called in two ways:
 
-*   **List all public locations:** Use the path `GET /v1/locations`.
-*   **List project-visible locations:** Use the path
-`GET /v1/projects/{project_id}/locations`. This may include public
-locations as well as private or other locations specifically visible
-to the project.
+This method lists locations based on the resource scope provided in
+the [ListLocationsRequest.name] field:
+
+* **Global locations**: If `name` is empty, the method lists the
+public locations available to all projects. * **Project-specific
+locations**: If `name` follows the format
+`projects/{project}`, the method lists locations visible to that
+specific project. This includes public, private, or other
+project-specific locations enabled for the project.
+
+For gRPC and client library implementations, the resource name is
+passed as the `name` field. For direct service calls, the resource
+name is
+incorporated into the request path based on the specific service
+implementation and version.
  *
  * This sample has been automatically generated and should be regarded as a code
  * template only. It will require modifications to work:

Kms/src/V1/Client/AutokeyAdminClient.php

@@ -416,13 +416,22 @@ public function getLocation(GetLocationRequest $request, array $callOptions = []
 
     /**
      * Lists information about the supported locations for this service.
-    This method can be called in two ways:
 
-    *   **List all public locations:** Use the path `GET /v1/locations`.
-    *   **List project-visible locations:** Use the path
-    `GET /v1/projects/{project_id}/locations`. This may include public
-    locations as well as private or other locations specifically visible
-    to the project.
+    This method lists locations based on the resource scope provided in
+    the [ListLocationsRequest.name] field:
+
+    * **Global locations**: If `name` is empty, the method lists the
+    public locations available to all projects. * **Project-specific
+    locations**: If `name` follows the format
+    `projects/{project}`, the method lists locations visible to that
+    specific project. This includes public, private, or other
+    project-specific locations enabled for the project.
+
+    For gRPC and client library implementations, the resource name is
+    passed as the `name` field. For direct service calls, the resource
+    name is
+    incorporated into the request path based on the specific service
+    implementation and version.
      *
      * The async variant is {@see AutokeyAdminClient::listLocationsAsync()} .
      *

Kms/src/V1/Client/AutokeyClient.php

@@ -469,13 +469,22 @@ public function getLocation(GetLocationRequest $request, array $callOptions = []
 
     /**
      * Lists information about the supported locations for this service.
-    This method can be called in two ways:
 
-    *   **List all public locations:** Use the path `GET /v1/locations`.
-    *   **List project-visible locations:** Use the path
-    `GET /v1/projects/{project_id}/locations`. This may include public
-    locations as well as private or other locations specifically visible
-    to the project.
+    This method lists locations based on the resource scope provided in
+    the [ListLocationsRequest.name] field:
+
+    * **Global locations**: If `name` is empty, the method lists the
+    public locations available to all projects. * **Project-specific
+    locations**: If `name` follows the format
+    `projects/{project}`, the method lists locations visible to that
+    specific project. This includes public, private, or other
+    project-specific locations enabled for the project.
+
+    For gRPC and client library implementations, the resource name is
+    passed as the `name` field. For direct service calls, the resource
+    name is
+    incorporated into the request path based on the specific service
+    implementation and version.
      *
      * The async variant is {@see AutokeyClient::listLocationsAsync()} .
      *

Kms/src/V1/Client/EkmServiceClient.php

@@ -538,13 +538,22 @@ public function getLocation(GetLocationRequest $request, array $callOptions = []
 
     /**
      * Lists information about the supported locations for this service.
-    This method can be called in two ways:
 
-    *   **List all public locations:** Use the path `GET /v1/locations`.
-    *   **List project-visible locations:** Use the path
-    `GET /v1/projects/{project_id}/locations`. This may include public
-    locations as well as private or other locations specifically visible
-    to the project.
+    This method lists locations based on the resource scope provided in
+    the [ListLocationsRequest.name] field:
+
+    * **Global locations**: If `name` is empty, the method lists the
+    public locations available to all projects. * **Project-specific
+    locations**: If `name` follows the format
+    `projects/{project}`, the method lists locations visible to that
+    specific project. This includes public, private, or other
+    project-specific locations enabled for the project.
+
+    For gRPC and client library implementations, the resource name is
+    passed as the `name` field. For direct service calls, the resource
+    name is
+    incorporated into the request path based on the specific service
+    implementation and version.
      *
      * The async variant is {@see EkmServiceClient::listLocationsAsync()} .
      *

Kms/src/V1/Client/HsmManagementClient.php

@@ -679,13 +679,22 @@ public function getLocation(GetLocationRequest $request, array $callOptions = []
 
     /**
      * Lists information about the supported locations for this service.
-    This method can be called in two ways:
 
-    *   **List all public locations:** Use the path `GET /v1/locations`.
-    *   **List project-visible locations:** Use the path
-    `GET /v1/projects/{project_id}/locations`. This may include public
-    locations as well as private or other locations specifically visible
-    to the project.
+    This method lists locations based on the resource scope provided in
+    the [ListLocationsRequest.name] field:
+
+    * **Global locations**: If `name` is empty, the method lists the
+    public locations available to all projects. * **Project-specific
+    locations**: If `name` follows the format
+    `projects/{project}`, the method lists locations visible to that
+    specific project. This includes public, private, or other
+    project-specific locations enabled for the project.
+
+    For gRPC and client library implementations, the resource name is
+    passed as the `name` field. For direct service calls, the resource
+    name is
+    incorporated into the request path based on the specific service
+    implementation and version.
      *
      * The async variant is {@see HsmManagementClient::listLocationsAsync()} .
      *

Kms/src/V1/Client/KeyManagementServiceClient.php

@@ -1543,13 +1543,22 @@ public function getLocation(GetLocationRequest $request, array $callOptions = []
 
     /**
      * Lists information about the supported locations for this service.
-    This method can be called in two ways:
 
-    *   **List all public locations:** Use the path `GET /v1/locations`.
-    *   **List project-visible locations:** Use the path
-    `GET /v1/projects/{project_id}/locations`. This may include public
-    locations as well as private or other locations specifically visible
-    to the project.
+    This method lists locations based on the resource scope provided in
+    the [ListLocationsRequest.name] field:
+
+    * **Global locations**: If `name` is empty, the method lists the
+    public locations available to all projects. * **Project-specific
+    locations**: If `name` follows the format
+    `projects/{project}`, the method lists locations visible to that
+    specific project. This includes public, private, or other
+    project-specific locations enabled for the project.
+
+    For gRPC and client library implementations, the resource name is
+    passed as the `name` field. For direct service calls, the resource
+    name is
+    incorporated into the request path based on the specific service
+    implementation and version.
      *
      * The async variant is {@see KeyManagementServiceClient::listLocationsAsync()} .
      *