feat: [Kms] Add KeyProjectResolutionMode to AutokeyConfig to support project-level configurations (#8925)

* feat: Add KeyProjectResolutionMode to AutokeyConfig to support project-level configurations
feat: Add more post-quantum (PQ) signature algorithms to CryptoKeyVersion
docs: Update documentation for AutokeyAdmin service and messages to support folder and project-level configurations
docs: Clarify supported resources for the crypto_key_backend field in ImportJob

PiperOrigin-RevId: 870858133

Source-Link: googleapis/googleapis@b026ba8

Source-Link: googleapis/googleapis-gen@958c60c
Copy-Tag: eyJwIjoiS21zLy5Pd2xCb3QueWFtbCIsImgiOiI5NThjNjBjOTg0NGU2YjFjNDM3OGM0M2UzNGViZTg3ZTY2MWEzMzIwIn0=

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

Kms/metadata/V1/AutokeyAdmin.php

@@ -29,11 +29,12 @@
 use Google\Cloud\Kms\V1\GetAutokeyConfigRequest;
 
 /**
- * Returns the [AutokeyConfig][google.cloud.kms.v1.AutokeyConfig] for a
- * folder.
+ * Returns the [AutokeyConfig][google.cloud.kms.v1.AutokeyConfig] for a folder
+ * or project.
  *
  * @param string $formattedName Name of the [AutokeyConfig][google.cloud.kms.v1.AutokeyConfig]
- *                              resource, e.g. `folders/{FOLDER_NUMBER}/autokeyConfig`. Please see
+ *                              resource, e.g. `folders/{FOLDER_NUMBER}/autokeyConfig` or
+ *                              `projects/{PROJECT_NUMBER}/autokeyConfig`. Please see
  *                              {@see AutokeyAdminClient::autokeyConfigName()} for help formatting this field.
  */
 function get_autokey_config_sample(string $formattedName): void

Kms/metadata/V1/Resources.php

@@ -31,6 +31,13 @@
 
 /**
  * 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 sample has been automatically generated and should be regarded as a code
  * template only. It will require modifications to work:

Kms/samples/V1/AutokeyAdminClient/get_autokey_config.php

@@ -30,8 +30,8 @@
 use Google\Protobuf\FieldMask;
 
 /**
- * Updates the [AutokeyConfig][google.cloud.kms.v1.AutokeyConfig] for a
- * folder. The caller must have both `cloudkms.autokeyConfigs.update`
+ * Updates the [AutokeyConfig][google.cloud.kms.v1.AutokeyConfig] for a folder
+ * or a project. The caller must have both `cloudkms.autokeyConfigs.update`
  * permission on the parent folder and `cloudkms.cryptoKeys.setIamPolicy`
  * permission on the provided key project. A
  * [KeyHandle][google.cloud.kms.v1.KeyHandle] creation in the folder's

Kms/samples/V1/AutokeyAdminClient/list_locations.php

@@ -31,6 +31,13 @@
 
 /**
  * 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 sample has been automatically generated and should be regarded as a code
  * template only. It will require modifications to work:

Kms/samples/V1/AutokeyAdminClient/update_autokey_config.php

@@ -31,6 +31,13 @@
 
 /**
  * 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 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,6 +31,13 @@
 
 /**
  * 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 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,6 +31,13 @@
 
 /**
  * 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 sample has been automatically generated and should be regarded as a code
  * template only. It will require modifications to work: