@ibm-cloud/secrets-manager 1.0.2 → 1.0.3

package/secrets-manager/v1.d.ts

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2021.
+ * (C) Copyright IBM Corp. 2022.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -18,8 +18,8 @@ import { IncomingHttpHeaders, OutgoingHttpHeaders } from 'http';
 import { BaseService, UserOptions } from 'ibm-cloud-sdk-core';
 /**
  * With IBM Cloud® Secrets Manager, you can create, lease, and centrally manage secrets that are used in IBM Cloud
- * services or your custom-built applications. Secrets are stored in a dedicated instance of Secrets Manager, built on
- * open source HashiCorp Vault.
+ * services or your custom-built applications. Secrets are stored in a dedicated instance of Secrets Manager, which is
+ * built on open source HashiCorp Vault.
  *
  * API Version: 1.0.0
  * See: https://cloud.ibm.com/docs/secrets-manager
@@ -124,7 +124,7 @@ declare class SecretsManagerV1 extends BaseService {
     /**
      * Create a secret.
      *
-     * Creates a secret or imports an existing value that you can use to access or authenticate to a protected resource.
+     * Create a secret or import an existing value that you can use to access or authenticate to a protected resource.
      *
      * Use this method to either generate or import an existing secret, such as an arbitrary value or a TLS certificate,
      * that you can manage in your Secrets Manager service instance. A successful request stores the secret in your
@@ -204,7 +204,7 @@ declare class SecretsManagerV1 extends BaseService {
     /**
      * Get a secret.
      *
-     * Retrieves a secret and its details by specifying the ID of the secret.
+     * Get a secret and its details by specifying the ID of the secret.
      *
      * A successful request returns the secret data that is associated with your secret, along with other metadata. To
      * view only the details of a specified secret without retrieving its value, use the [Get secret
@@ -222,14 +222,15 @@ declare class SecretsManagerV1 extends BaseService {
      *
      * Invokes an action on a specified secret. This method supports the following actions:
      *
-     * - `rotate`: Replace the value of an `arbitrary`, `username_password`, `public_cert` or `imported_cert` secret.
+     * - `rotate`: Replace the value of a secret.
+     * - `restore`: Restore a previous version of an `iam_credentials` secret.
      * - `delete_credentials`: Delete the API key that is associated with an `iam_credentials` secret.
      *
      * @param {Object} params - The parameters to send to the service.
      * @param {string} params.secretType - The secret type.
      * @param {string} params.id - The v4 UUID that uniquely identifies the secret.
      * @param {string} params.action - The action to perform on the specified secret.
-     * @param {SecretAction} params.secretAction - The properties to update for the secret.
+     * @param {SecretAction} [params.secretAction] - The properties to update for the secret.
      * @param {OutgoingHttpHeaders} [params.headers] - Custom request headers
      * @returns {Promise<SecretsManagerV1.Response<SecretsManagerV1.GetSecret>>}
      */
@@ -246,6 +247,20 @@ declare class SecretsManagerV1 extends BaseService {
      * @returns {Promise<SecretsManagerV1.Response<SecretsManagerV1.Empty>>}
      */
     deleteSecret(params: SecretsManagerV1.DeleteSecretParams): Promise<SecretsManagerV1.Response<SecretsManagerV1.Empty>>;
+    /**
+     * List versions of a secret.
+     *
+     * Retrieves a list of the versions of a secret.
+     *
+     * A successful request returns the list of the versions along with the metadata of each version.
+     *
+     * @param {Object} params - The parameters to send to the service.
+     * @param {string} params.secretType - The secret type.
+     * @param {string} params.id - The v4 UUID that uniquely identifies the secret.
+     * @param {OutgoingHttpHeaders} [params.headers] - Custom request headers
+     * @returns {Promise<SecretsManagerV1.Response<SecretsManagerV1.ListSecretVersions>>}
+     */
+    listSecretVersions(params: SecretsManagerV1.ListSecretVersionsParams): Promise<SecretsManagerV1.Response<SecretsManagerV1.ListSecretVersions>>;
     /**
      * Get a version of a secret.
      *
@@ -363,7 +378,7 @@ declare class SecretsManagerV1 extends BaseService {
      * configuration](#create_config_element) method.
      *
      * @param {Object} params - The parameters to send to the service.
-     * @param {string} params.secretType -
+     * @param {string} params.secretType - The secret type.
      * @param {EngineConfig} params.engineConfig - Properties to update for a secrets engine.
      * @param {OutgoingHttpHeaders} [params.headers] - Custom request headers
      * @returns {Promise<SecretsManagerV1.Response<SecretsManagerV1.Empty>>}
@@ -385,7 +400,7 @@ declare class SecretsManagerV1 extends BaseService {
      *
      * Adds a configuration element to the specified secret type.
      *
-     * Use this method to define the configurations that are required to enable the  public certificates (`public_cert`)
+     * Use this method to define the configurations that are required to enable the public certificates (`public_cert`)
      * engine. You can add up to 10 certificate authority and DNS provider configurations for your instance.
      *
      * @param {Object} params - The parameters to send to the service.
@@ -394,7 +409,7 @@ declare class SecretsManagerV1 extends BaseService {
      * @param {string} params.name - The human-readable name to assign to your configuration.
      * @param {string} params.type - The type of configuration. Value options differ depending on the `config_element`
      * property that you want to define.
-     * @param {ConfigElementDefConfig} params.config - The configuration to define for the specified secret type.
+     * @param {JsonObject} params.config - The configuration to define for the specified secret type.
      * @param {OutgoingHttpHeaders} [params.headers] - Custom request headers
      * @returns {Promise<SecretsManagerV1.Response<SecretsManagerV1.GetSingleConfigElement>>}
      */
@@ -435,7 +450,7 @@ declare class SecretsManagerV1 extends BaseService {
      * @param {string} params.configName - The name of your configuration.
      * @param {string} params.type - The type of configuration. Value options differ depending on the `config_element`
      * property that you want to define.
-     * @param {JsonObject} params.config -
+     * @param {JsonObject} params.config - Properties that describe a configuration, which depends on type.
      * @param {OutgoingHttpHeaders} [params.headers] - Custom request headers
      * @returns {Promise<SecretsManagerV1.Response<SecretsManagerV1.GetSingleConfigElement>>}
      */
@@ -529,7 +544,8 @@ declare namespace SecretsManagerV1 {
             IAM_CREDENTIALS = "iam_credentials",
             IMPORTED_CERT = "imported_cert",
             PUBLIC_CERT = "public_cert",
-            USERNAME_PASSWORD = "username_password"
+            USERNAME_PASSWORD = "username_password",
+            KV = "kv"
         }
     }
     /** Parameters for the `listSecrets` operation. */
@@ -560,7 +576,8 @@ declare namespace SecretsManagerV1 {
             IAM_CREDENTIALS = "iam_credentials",
             IMPORTED_CERT = "imported_cert",
             PUBLIC_CERT = "public_cert",
-            USERNAME_PASSWORD = "username_password"
+            USERNAME_PASSWORD = "username_password",
+            KV = "kv"
         }
     }
     /** Parameters for the `listAllSecrets` operation. */
@@ -630,7 +647,8 @@ declare namespace SecretsManagerV1 {
             IAM_CREDENTIALS = "iam_credentials",
             IMPORTED_CERT = "imported_cert",
             PUBLIC_CERT = "public_cert",
-            USERNAME_PASSWORD = "username_password"
+            USERNAME_PASSWORD = "username_password",
+            KV = "kv"
         }
     }
     /** Parameters for the `updateSecret` operation. */
@@ -642,7 +660,7 @@ declare namespace SecretsManagerV1 {
         /** The action to perform on the specified secret. */
         action: UpdateSecretConstants.Action | string;
         /** The properties to update for the secret. */
-        secretAction: SecretAction;
+        secretAction?: SecretAction;
         headers?: OutgoingHttpHeaders;
     }
     /** Constants for the `updateSecret` operation. */
@@ -653,11 +671,13 @@ declare namespace SecretsManagerV1 {
             IAM_CREDENTIALS = "iam_credentials",
             IMPORTED_CERT = "imported_cert",
             PUBLIC_CERT = "public_cert",
-            USERNAME_PASSWORD = "username_password"
+            USERNAME_PASSWORD = "username_password",
+            KV = "kv"
         }
         /** The action to perform on the specified secret. */
         enum Action {
             ROTATE = "rotate",
+            RESTORE = "restore",
             DELETE_CREDENTIALS = "delete_credentials"
         }
     }
@@ -677,7 +697,28 @@ declare namespace SecretsManagerV1 {
             IAM_CREDENTIALS = "iam_credentials",
             IMPORTED_CERT = "imported_cert",
             PUBLIC_CERT = "public_cert",
-            USERNAME_PASSWORD = "username_password"
+            USERNAME_PASSWORD = "username_password",
+            KV = "kv"
+        }
+    }
+    /** Parameters for the `listSecretVersions` operation. */
+    interface ListSecretVersionsParams {
+        /** The secret type. */
+        secretType: ListSecretVersionsConstants.SecretType | string;
+        /** The v4 UUID that uniquely identifies the secret. */
+        id: string;
+        headers?: OutgoingHttpHeaders;
+    }
+    /** Constants for the `listSecretVersions` operation. */
+    namespace ListSecretVersionsConstants {
+        /** The secret type. */
+        enum SecretType {
+            ARBITRARY = "arbitrary",
+            IAM_CREDENTIALS = "iam_credentials",
+            IMPORTED_CERT = "imported_cert",
+            PUBLIC_CERT = "public_cert",
+            USERNAME_PASSWORD = "username_password",
+            KV = "kv"
         }
     }
     /** Parameters for the `getSecretVersion` operation. */
@@ -699,8 +740,12 @@ declare namespace SecretsManagerV1 {
     namespace GetSecretVersionConstants {
         /** The secret type. */
         enum SecretType {
+            ARBITRARY = "arbitrary",
+            IAM_CREDENTIALS = "iam_credentials",
             IMPORTED_CERT = "imported_cert",
-            PUBLIC_CERT = "public_cert"
+            PUBLIC_CERT = "public_cert",
+            USERNAME_PASSWORD = "username_password",
+            KV = "kv"
         }
     }
     /** Parameters for the `getSecretVersionMetadata` operation. */
@@ -722,8 +767,12 @@ declare namespace SecretsManagerV1 {
     namespace GetSecretVersionMetadataConstants {
         /** The secret type. */
         enum SecretType {
+            ARBITRARY = "arbitrary",
+            IAM_CREDENTIALS = "iam_credentials",
             IMPORTED_CERT = "imported_cert",
-            PUBLIC_CERT = "public_cert"
+            PUBLIC_CERT = "public_cert",
+            USERNAME_PASSWORD = "username_password",
+            KV = "kv"
         }
     }
     /** Parameters for the `getSecretMetadata` operation. */
@@ -742,7 +791,8 @@ declare namespace SecretsManagerV1 {
             IAM_CREDENTIALS = "iam_credentials",
             IMPORTED_CERT = "imported_cert",
             PUBLIC_CERT = "public_cert",
-            USERNAME_PASSWORD = "username_password"
+            USERNAME_PASSWORD = "username_password",
+            KV = "kv"
         }
     }
     /** Parameters for the `updateSecretMetadata` operation. */
@@ -765,7 +815,8 @@ declare namespace SecretsManagerV1 {
             IAM_CREDENTIALS = "iam_credentials",
             IMPORTED_CERT = "imported_cert",
             PUBLIC_CERT = "public_cert",
-            USERNAME_PASSWORD = "username_password"
+            USERNAME_PASSWORD = "username_password",
+            KV = "kv"
         }
     }
     /** Parameters for the `putPolicy` operation. */
@@ -818,6 +869,7 @@ declare namespace SecretsManagerV1 {
     }
     /** Parameters for the `putConfig` operation. */
     interface PutConfigParams {
+        /** The secret type. */
         secretType: PutConfigConstants.SecretType | string;
         /** Properties to update for a secrets engine. */
         engineConfig: EngineConfig;
@@ -825,7 +877,7 @@ declare namespace SecretsManagerV1 {
     }
     /** Constants for the `putConfig` operation. */
     namespace PutConfigConstants {
-        /** SecretType */
+        /** The secret type. */
         enum SecretType {
             IAM_CREDENTIALS = "iam_credentials"
         }
@@ -857,7 +909,7 @@ declare namespace SecretsManagerV1 {
          */
         type: CreateConfigElementConstants.Type | string;
         /** The configuration to define for the specified secret type. */
-        config: ConfigElementDefConfig;
+        config: JsonObject;
         headers?: OutgoingHttpHeaders;
     }
     /** Constants for the `createConfigElement` operation. */
@@ -933,6 +985,7 @@ declare namespace SecretsManagerV1 {
          *  define.
          */
         type: UpdateConfigElementConstants.Type | string;
+        /** Properties that describe a configuration, which depends on type. */
         config: JsonObject;
         headers?: OutgoingHttpHeaders;
     }
@@ -980,15 +1033,6 @@ declare namespace SecretsManagerV1 {
     /*************************
      * model interfaces
      ************************/
-    /** CertificateSecretData. */
-    interface CertificateSecretData {
-        /** The contents of the certificate. */
-        certificate?: string;
-        /** The private key that is associated with the certificate. */
-        private_key?: string;
-        /** The intermediate certificate that is associated with the certificate. */
-        intermediate?: string;
-    }
     /** The metadata that describes the resource array. */
     interface CollectionMetadata {
         /** The type of resources in the resource array. */
@@ -1005,10 +1049,7 @@ declare namespace SecretsManagerV1 {
          */
         type: string;
         /** The configuration to define for the specified secret type. */
-        config: ConfigElementDefConfig;
-    }
-    /** The configuration to define for the specified secret type. */
-    interface ConfigElementDefConfig {
+        config: JsonObject;
     }
     /** Properties that describe a configuration element. */
     interface ConfigElementMetadata {
@@ -1059,24 +1100,6 @@ declare namespace SecretsManagerV1 {
     /** GetSecretPolicies. */
     interface GetSecretPolicies {
     }
-    /** Properties that describe a rotation policy. */
-    interface GetSecretPolicyRotationResourcesItem {
-        /** The v4 UUID that uniquely identifies the policy. */
-        id: string;
-        /** The Cloud Resource Name (CRN) that uniquely identifies your cloud resources. */
-        crn?: string;
-        /** The date the policy was created. The date format follows RFC 3339. */
-        creation_date?: string;
-        /** The unique identifier for the entity that created the policy. */
-        created_by?: string;
-        /** Updates when the policy is replaced or modified. The date format follows RFC 3339. */
-        last_update_date?: string;
-        /** The unique identifier for the entity that updated the policy. */
-        updated_by?: string;
-        /** The MIME type that represents the policy. Currently, only the default is supported. */
-        type: string;
-        rotation: SecretPolicyRotationRotation;
-    }
     /** Properties that describe the version of a secret. */
     interface GetSecretVersion {
         /** The metadata that describes the resource array. */
@@ -1102,7 +1125,7 @@ declare namespace SecretsManagerV1 {
     interface IssuanceInfo {
         /** The date the certificate was ordered. The date format follows RFC 3339. */
         ordered_on?: string;
-        /** An code that identifies an issuance error.
+        /** A code that identifies an issuance error.
          *
          *  This field, along with `error_message`, is returned when Secrets Manager successfully processes your request,
          *  but a certificate is unable to be issued by the certificate authority.
@@ -1125,6 +1148,13 @@ declare namespace SecretsManagerV1 {
         /** The name that was assigned to the DNS provider configuration. */
         dns?: string;
     }
+    /** Properties that describe a list of versions of a secret. */
+    interface ListSecretVersions {
+        /** The metadata that describes the resource array. */
+        metadata: CollectionMetadata;
+        /** A collection of resources. */
+        resources?: SecretVersionInfo[];
+    }
     /** Properties that describe a list of secrets. */
     interface ListSecrets {
         /** The metadata that describes the resource array. */
@@ -1137,7 +1167,7 @@ declare namespace SecretsManagerV1 {
         /** Determines whether Secrets Manager rotates your certificate automatically.
          *
          *  If set to `true`, the service reorders your certificate 31 days before it expires. To access the previous
-         *  version of the certifcate, you can use the [Get a version of a secret](#get-secret-version) method.
+         *  version of the certificate, you can use the [Get a version of a secret](#get-secret-version) method.
          */
         auto_rotate?: boolean;
         /** Determines whether Secrets Manager rotates the private key for your certificate automatically.
@@ -1221,6 +1251,9 @@ declare namespace SecretsManagerV1 {
     /** SecretVersion. */
     interface SecretVersion {
     }
+    /** Properties that describe a secret version within a list of secret versions. */
+    interface SecretVersionInfo {
+    }
     /** SecretVersionMetadata. */
     interface SecretVersionMetadata {
     }
@@ -1237,8 +1270,9 @@ declare namespace SecretsManagerV1 {
         id?: string;
         /** Labels that you can use to filter for secrets in your instance.
          *
-         *  Up to 30 labels can be created. Labels can be between 2-30 characters, including spaces. Special characters not
-         *  permitted include the angled bracket, comma, colon, ampersand, and vertical pipe character (|).
+         *  Up to 30 labels can be created. Labels can be in the range 2 - 30 characters, including spaces. Special
+         *  characters that are not permitted include the angled bracket, comma, colon, ampersand, and vertical pipe
+         *  character (|).
          *
          *  To protect your privacy, do not use personal data, such as your name or location, as a label for your secret.
          */
@@ -1310,8 +1344,8 @@ declare namespace SecretsManagerV1 {
         secret_group_id?: string;
         /** Labels that you can use to filter for secrets in your instance.
          *
-         *  Up to 30 labels can be created. Labels can be between 2-30 characters, including spaces. Special characters not
-         *  permitted include the angled bracket, comma, colon, ampersand, and vertical pipe character (|).
+         *  Up to 30 labels can be created. Labels can be 2 - 30 characters, including spaces. Special characters that are
+         *  not permitted include the angled bracket, comma, colon, ampersand, and vertical pipe character (|).
          *
          *  To protect your privacy, do not use personal data, such as your name or location, as a label for your secret.
          */
@@ -1350,16 +1384,53 @@ declare namespace SecretsManagerV1 {
         expiration_date?: string;
         /** The new secret data to assign to the secret. */
         payload?: string;
+        /** The data that is associated with the secret version. The data object contains the field `payload`. */
         secret_data?: JsonObject;
     }
+    /** ArbitrarySecretVersion. */
+    interface ArbitrarySecretVersion extends SecretVersion {
+        /** The v4 UUID that uniquely identifies the secret. */
+        id?: string;
+        /** The ID of the secret version. */
+        version_id?: string;
+        /** The date that the version of the secret was created. */
+        creation_date?: string;
+        /** The unique identifier for the entity that created the secret version. */
+        created_by?: string;
+        /** The data that is associated with the secret version. The data object contains the field `payload`. */
+        secret_data?: JsonObject;
+    }
+    /** ArbitrarySecretVersionInfo. */
+    interface ArbitrarySecretVersionInfo extends SecretVersionInfo {
+        /** The ID of the secret version. */
+        id?: string;
+        /** The date that the version of the secret was created. */
+        creation_date?: string;
+        /** The unique identifier for the entity that created the secret version. */
+        created_by?: string;
+        /** Indicates whether the payload for the secret version is stored and available. */
+        payload_available?: boolean;
+        /** Indicates whether the secret data that is associated with a secret version was retrieved in a call to the
+         *  service API.
+         */
+        downloaded?: boolean;
+    }
     /** Properties that describe a secret version. */
     interface ArbitrarySecretVersionMetadata extends SecretVersionMetadata {
-        /** The ID of the secret version. */
+        /** The v4 UUID that uniquely identifies the secret. */
         id?: string;
+        /** The ID of the secret version. */
+        version_id?: string;
         /** The date that the version of the secret was created. */
         creation_date?: string;
         /** The unique identifier for the entity that created the secret version. */
         created_by?: string;
+        /** Indicates whether the payload for the secret version is stored and available. */
+        payload_available?: boolean;
+        /** Indicates whether the secret data that is associated with a secret version was retrieved in a call to the
+         *  service API.
+         */
+        downloaded?: boolean;
     }
     /** Metadata properties that describe a certificate secret. */
     interface CertificateSecretMetadata extends SecretMetadata {
@@ -1367,8 +1438,9 @@ declare namespace SecretsManagerV1 {
         id?: string;
         /** Labels that you can use to filter for secrets in your instance.
          *
-         *  Up to 30 labels can be created. Labels can be between 2-30 characters, including spaces. Special characters not
-         *  permitted include the angled bracket, comma, colon, ampersand, and vertical pipe character (|).
+         *  Up to 30 labels can be created. Labels can be in the range 2 - 30 characters, including spaces. Special
+         *  characters that are not permitted include the angled bracket, comma, colon, ampersand, and vertical pipe
+         *  character (|).
          *
          *  To protect your privacy, do not use personal data, such as your name or location, as a label for your secret.
          */
@@ -1409,8 +1481,8 @@ declare namespace SecretsManagerV1 {
         versions_total?: number;
         /** The unique serial number that was assigned to the certificate by the issuing certificate authority. */
         serial_number?: string;
-        /** The identifier for the cryptographic algorthim that was used by the issuing certificate authority to sign
-         *  the ceritificate.
+        /** The identifier for the cryptographic algorithm that was used by the issuing certificate authority to sign
+         *  the certificate.
          */
         algorithm?: string;
         /** The identifier for the cryptographic algorithm that was used to generate the public key that is associated
@@ -1453,8 +1525,8 @@ declare namespace SecretsManagerV1 {
         secret_group_id?: string;
         /** Labels that you can use to filter for secrets in your instance.
          *
-         *  Up to 30 labels can be created. Labels can be between 2-30 characters, including spaces. Special characters not
-         *  permitted include the angled bracket, comma, colon, ampersand, and vertical pipe character (|).
+         *  Up to 30 labels can be created. Labels can be 2 - 30 characters, including spaces. Special characters that are
+         *  not permitted include the angled bracket, comma, colon, ampersand, and vertical pipe character (|).
          *
          *  To protect your privacy, do not use personal data, such as your name or location, as a label for your secret.
          */
@@ -1493,11 +1565,16 @@ declare namespace SecretsManagerV1 {
          *  line with embedded newline characters.
          */
         intermediate?: string;
+        /** The data that is associated with the secret. The data object contains the following fields:
+         *  `certificate`: The contents of the certificate.
+         *  `private_key`: The private key that is associated with the certificate.
+         *  `intermediate`: The intermediate certificate that is associated with the certificate.
+         */
         secret_data?: JsonObject;
         /** The unique serial number that was assigned to the certificate by the issuing certificate authority. */
         serial_number?: string;
-        /** The identifier for the cryptographic algorthim that was used by the issuing certificate authority to sign
-         *  the ceritificate.
+        /** The identifier for the cryptographic algorithm that was used by the issuing certificate authority to sign
+         *  the certificate.
          */
         algorithm?: string;
         /** The identifier for the cryptographic algorithm that was used to generate the public key that is associated
@@ -1522,8 +1599,6 @@ declare namespace SecretsManagerV1 {
     interface CertificateSecretVersion extends SecretVersion {
         /** The v4 UUID that uniquely identifies the secret. */
         id?: string;
-        /** The Cloud Resource Name (CRN) that uniquely identifies the secret. */
-        crn?: string;
         /** The ID of the secret version. */
         version_id?: string;
         /** The date that the version of the secret was created. */
@@ -1535,71 +1610,58 @@ declare namespace SecretsManagerV1 {
         serial_number?: string;
         /** The date that the certificate expires. The date format follows RFC 3339. */
         expiration_date?: string;
-        secret_data?: CertificateSecretData;
+        /** The data that is associated with the secret version. The data object contains the following fields:
+         *  `certificate`: The contents of the certificate.
+         *  `private_key`: The private key that is associated with the certificate.
+         *  `intermediate`: The intermediate certificate that is associated with the certificate.
+         */
+        secret_data?: JsonObject;
     }
-    /** Properties that describe a secret version. */
-    interface CertificateSecretVersionMetadata extends SecretVersionMetadata {
+    /** CertificateSecretVersionInfo. */
+    interface CertificateSecretVersionInfo extends SecretVersionInfo {
         /** The ID of the secret version. */
         id?: string;
         /** The date that the version of the secret was created. */
         creation_date?: string;
         /** The unique identifier for the entity that created the secret version. */
         created_by?: string;
+        /** Indicates whether the payload for the secret version is stored and available. */
+        payload_available?: boolean;
+        /** Indicates whether the secret data that is associated with a secret version was retrieved in a call to the
+         *  service API.
+         */
+        downloaded?: boolean;
         /** The unique serial number that was assigned to the certificate by the issuing certificate authority. */
         serial_number?: string;
         /** The date that the certificate expires. The date format follows RFC 3339. */
         expiration_date?: string;
         validity?: CertificateValidity;
     }
-    /** Properties that describe an IBM Cloud classic infrastructure (SoftLayer) configuration. */
-    interface ConfigElementDefConfigClassicInfrastructureConfig extends ConfigElementDefConfig {
-        /** The username that is associated with your classic infrastructure account.
-         *
-         *  In most cases, your classic infrastructure username is your `<account_id>_<email_address>`. In the console, you
-         *  can find your username by going to **Manage > Access (IAM) > Users > name > VPN password.** For more
-         *  information, see the
-         *  [docs](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-prepare-order-certificates#authorize-classic-infrastructure).
-         */
-        classic_infrastructure_username: string;
-        /** Your classic infrastructure API key.
-         *
-         *  In the console, you can view or create a classic infrastructure API key by going to **Manage > Access (IAM)
-         *  > Users > name > API keys.** For more information, see the
-         *  [docs](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-prepare-order-certificates#authorize-classic-infrastructure).
-         */
-        classic_infrastructure_password: string;
-    }
-    /** Properties that describe an IBM Cloud Internet Services (CIS) configuration. */
-    interface ConfigElementDefConfigCloudInternetServicesConfig extends ConfigElementDefConfig {
-        /** The Cloud Resource Name (CRN) that is associated with the CIS instance. */
-        cis_crn: string;
-        /** An IBM Cloud API key that has the capability to list domains in your CIS instance.
-         *
-         *  To grant Secrets Manager the ability to view the CIS instance and all of its domains, the API key must be
-         *  assigned the Reader service role on Internet Services (`internet-svcs`).
-         *
-         *  If you need to manage specific domains, you can assign the Manager role. For production environments, it is
-         *  recommended that you assign the Reader access role, and then use the
-         *  [IAM Policy Management API](https://cloud.ibm.com/apidocs/iam-policy-management#create-policy) to control
-         *  specific domains. For more information, see the
-         *  [docs](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-prepare-order-certificates#authorize-specific-domains).
-         */
-        cis_apikey?: string;
-    }
-    /** Properties that describe a Let's Encrypt configuration. */
-    interface ConfigElementDefConfigLetsEncryptConfig extends ConfigElementDefConfig {
-        /** The private key that is associated with your Automatic Certificate Management Environment (ACME) account.
-         *
-         *  If you have a working ACME client or account for Let's Encrypt, you can use the existing private key to  enable
-         *  communications with Secrets Manager. If you don't have an account yet, you can create one. For more information,
-         *  see the
-         *  [docs](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-prepare-order-certificates#create-acme-account).
+    /** Properties that describe a secret version. */
+    interface CertificateSecretVersionMetadata extends SecretVersionMetadata {
+        /** The v4 UUID that uniquely identifies the secret. */
+        id?: string;
+        /** The ID of the secret version. */
+        version_id?: string;
+        /** The date that the version of the secret was created. */
+        creation_date?: string;
+        /** The unique identifier for the entity that created the secret version. */
+        created_by?: string;
+        /** Indicates whether the payload for the secret version is stored and available. */
+        payload_available?: boolean;
+        /** Indicates whether the secret data that is associated with a secret version was retrieved in a call to the
+         *  service API.
          */
-        private_key: string;
+        downloaded?: boolean;
+        /** The unique serial number that was assigned to the certificate by the issuing certificate authority. */
+        serial_number?: string;
+        /** The date that the certificate expires. The date format follows RFC 3339. */
+        expiration_date?: string;
+        validity?: CertificateValidity;
     }
     /** Configuration for the IAM credentials engine. */
     interface CreateIAMCredentialsSecretEngineRootConfig extends EngineConfig {
-        /** An IBM Cloud API key that has the capability to create and manage service IDs.
+        /** An IBM Cloud API key that can create and manage service IDs.
          *
          *  The API key must be assigned the Editor platform role on the Access Groups Service and the Operator platform
          *  role on the IAM Identity Service. For more information, see the
@@ -1611,8 +1673,16 @@ declare namespace SecretsManagerV1 {
     }
     /** Delete the credentials that are associated with an `iam_credentials` secret. */
     interface DeleteCredentialsForIAMCredentialsSecret extends SecretAction {
-        /** The service ID that you want to delete. It is deleted together with its API key. */
-        service_id: string;
+        /** The ID of the API key that you want to delete. If the secret was created with a static service ID, only the
+         *  API key is deleted. Otherwise, the service ID is deleted together with its API key.
+         */
+        api_key_id?: string;
+        /** The service ID that you want to delete. This property can be used instead of the `api_key_id` field, but
+         *  only for secrets that were created with a service ID that was generated by Secrets Manager.
+         *
+         *  **Deprecated.** Use the `api_key_id` field instead.
+         */
+        service_id?: string;
     }
     /** Certificate authorities configuration. */
     interface GetConfigElementsResourcesItemCertificateAuthoritiesConfig extends GetConfigElementsResourcesItem {
@@ -1627,11 +1697,11 @@ declare namespace SecretsManagerV1 {
         /** The metadata that describes the resource array. */
         metadata: CollectionMetadata;
         /** A collection of resources. */
-        resources: GetSecretPolicyRotationResourcesItem[];
+        resources: JsonObject[];
     }
     /** Configuration for the IAM credentials engine. */
     interface IAMCredentialsSecretEngineRootConfig extends GetConfigResourcesItem {
-        /** An IBM Cloud API key that has the capability to create and manage service IDs.
+        /** An IBM Cloud API key that can create and manage service IDs.
          *
          *  The API key must be assigned the Editor platform role on the Access Groups Service and the Operator platform
          *  role on the IAM Identity Service. For more information, see the
@@ -1647,8 +1717,9 @@ declare namespace SecretsManagerV1 {
         id?: string;
         /** Labels that you can use to filter for secrets in your instance.
          *
-         *  Up to 30 labels can be created. Labels can be between 2-30 characters, including spaces. Special characters not
-         *  permitted include the angled bracket, comma, colon, ampersand, and vertical pipe character (|).
+         *  Up to 30 labels can be created. Labels can be in the range 2 - 30 characters, including spaces. Special
+         *  characters that are not permitted include the angled bracket, comma, colon, ampersand, and vertical pipe
+         *  character (|).
          *
          *  To protect your privacy, do not use personal data, such as your name or location, as a label for your secret.
          */
@@ -1692,13 +1763,32 @@ declare namespace SecretsManagerV1 {
          *  For `iam_credentials` secrets, the TTL defines for how long each generated API key remains valid. The value can
          *  be either an integer that specifies the number of seconds, or the string representation of a duration, such as
          *  `120m` or `24h`.
+         *
+         *  Minimum duration is 1 minute. Maximum is 90 days.
          */
         ttl?: any;
-        /** For `iam_credentials` secrets, this field controls whether to use the same service ID and API key for future
-         *  read operations on this secret. If set to `true`, the service reuses the current credentials. If set to `false`,
-         *  a new service ID and API key is generated each time that the secret is read or accessed.
+        /** Determines whether to use the same service ID and API key for future read operations on an
+         *  `iam_credentials` secret.
+         *
+         *  If set to `true`, the service reuses the current credentials. If set to `false`, a new service ID and API key
+         *  are generated each time that the secret is read or accessed.
          */
         reuse_api_key?: boolean;
+        /** Indicates whether an `iam_credentials` secret was created with a static service ID.
+         *
+         *  If the value is `true`, the service ID for the secret was provided by the user at secret creation. If the value
+         *  is `false`, the service ID was generated by Secrets Manager.
+         */
+        service_id_is_static?: boolean;
+        /** The service ID under which the API key is created. The service ID is included in the metadata only if the
+         *  secret was created with a static service ID.
+         */
+        service_id?: string;
+        /** The access groups that define the capabilities of the service ID and API key that are generated for an
+         *  `iam_credentials` secret. The access groups are included in the metadata only if the secret was created with a
+         *  service ID that was generated by Secrets Manager.
+         */
+        access_groups?: string[];
     }
     /** Properties that describe a secret. */
     interface IAMCredentialsSecretResource extends SecretResource {
@@ -1722,8 +1812,8 @@ declare namespace SecretsManagerV1 {
         secret_group_id?: string;
         /** Labels that you can use to filter for secrets in your instance.
          *
-         *  Up to 30 labels can be created. Labels can be between 2-30 characters, including spaces. Special characters not
-         *  permitted include the angled bracket, comma, colon, ampersand, and vertical pipe character (|).
+         *  Up to 30 labels can be created. Labels can be 2 - 30 characters, including spaces. Special characters that are
+         *  not permitted include the angled bracket, comma, colon, ampersand, and vertical pipe character (|).
          *
          *  To protect your privacy, do not use personal data, such as your name or location, as a label for your secret.
          */
@@ -1755,10 +1845,13 @@ declare namespace SecretsManagerV1 {
          *  For `iam_credentials` secrets, the TTL defines for how long each generated API key remains valid. The value can
          *  be either an integer that specifies the number of seconds, or the string representation of a duration, such as
          *  `120m` or `24h`.
+         *
+         *  Minimum duration is 1 minute. Maximum is 90 days.
          */
         ttl?: any;
         /** The access groups that define the capabilities of the service ID and API key that are generated for an
-         *  `iam_credentials` secret.
+         *  `iam_credentials` secret. If you prefer to use an existing service ID that is already assigned the access
+         *  policies that you require, you can omit this parameter and use the `service_id` field instead.
          *
          *  **Tip:** To list the access groups that are available in an account, you can use the [IAM Access Groups
          *  API](https://cloud.ibm.com/apidocs/iam-access-groups#list-access-groups). To find the ID of an access group in
@@ -1772,26 +1865,193 @@ declare namespace SecretsManagerV1 {
          *  you want to continue to use the same API key for future read operations, see the `reuse_api_key` field.
          */
         api_key?: string;
-        /** The service ID under which the API key (see the `api_key` field) is created. This service ID is added to the
-         *  access groups that you assign for this secret.
+        /** The ID of the API key that is generated for this secret. */
+        api_key_id?: string;
+        /** The service ID under which the API key (see the `api_key` field) is created.
+         *
+         *  If you omit this parameter, Secrets Manager generates a new service ID for your secret at its creation and adds
+         *  it to the access groups that you assign.
+         *
+         *  Optionally, you can use this field to provide your own service ID if you prefer to manage its access directly or
+         *  retain the service ID after your secret expires, is rotated, or deleted. If you provide a service ID, do not
+         *  include the `access_groups` parameter.
          */
         service_id?: string;
-        /** Set to `true` to reuse the service ID and API key for this secret.
+        /** Indicates whether an `iam_credentials` secret was created with a static service ID.
+         *
+         *  If `true`, the service ID for the secret was provided by the user at secret creation. If `false`, the service ID
+         *  was generated by Secrets Manager.
+         */
+        service_id_is_static?: boolean;
+        /** Determines whether to use the same service ID and API key for future read operations on an
+         *  `iam_credentials` secret.
          *
-         *  Use this field to control whether to use the same service ID and API key for future read operations on this
-         *  secret. If set to `true`, the service reuses the current credentials. If set to `false`, a new service ID and
-         *  API key is generated each time that the secret is read or accessed.
+         *  If set to `true`, the service reuses the current credentials. If set to `false`, a new service ID and API key
+         *  are generated each time that the secret is read or accessed.
          */
         reuse_api_key?: boolean;
     }
+    /** IAMCredentialsSecretVersion. */
+    interface IAMCredentialsSecretVersion extends SecretVersion {
+        /** The v4 UUID that uniquely identifies the secret. */
+        id?: string;
+        /** The ID of the secret version. */
+        version_id?: string;
+        /** The date that the version of the secret was created. */
+        creation_date?: string;
+        /** The unique identifier for the entity that created the secret version. */
+        created_by?: string;
+        /** The data that is associated with the secret version. The data object contains the following fields:
+         *  `api_key`: The API key that is generated for this secret.
+         *  `api_key_id`: The ID of the API key that is generated for this secret.
+         *  `service_id`: The service ID under which the API key is created.
+         */
+        secret_data?: JsonObject;
+    }
+    /** IAMCredentialsSecretVersionInfo. */
+    interface IAMCredentialsSecretVersionInfo extends SecretVersionInfo {
+        /** The ID of the secret version. */
+        id?: string;
+        /** The date that the version of the secret was created. */
+        creation_date?: string;
+        /** The unique identifier for the entity that created the secret version. */
+        created_by?: string;
+        /** Indicates whether the payload for the secret version is stored and available. */
+        payload_available?: boolean;
+        /** Indicates whether the secret data that is associated with a secret version was retrieved in a call to the
+         *  service API.
+         */
+        downloaded?: boolean;
+    }
     /** Properties that describe a secret version. */
     interface IAMCredentialsSecretVersionMetadata extends SecretVersionMetadata {
-        /** The ID of the secret version. */
+        /** The v4 UUID that uniquely identifies the secret. */
         id?: string;
+        /** The ID of the secret version. */
+        version_id?: string;
         /** The date that the version of the secret was created. */
         creation_date?: string;
         /** The unique identifier for the entity that created the secret version. */
         created_by?: string;
+        /** Indicates whether the payload for the secret version is stored and available. */
+        payload_available?: boolean;
+        /** Indicates whether the secret data that is associated with a secret version was retrieved in a call to the
+         *  service API.
+         */
+        downloaded?: boolean;
+    }
+    /** Metadata properties that describe a key-value secret. */
+    interface KvSecretMetadata extends SecretMetadata {
+        /** The unique ID of the secret. */
+        id?: string;
+        /** Labels that you can use to filter for secrets in your instance.
+         *
+         *  Up to 30 labels can be created. Labels can be in the range 2 - 30 characters, including spaces. Special
+         *  characters that are not permitted include the angled bracket, comma, colon, ampersand, and vertical pipe
+         *  character (|).
+         *
+         *  To protect your privacy, do not use personal data, such as your name or location, as a label for your secret.
+         */
+        labels?: string[];
+        /** A human-readable alias to assign to your secret.
+         *
+         *  To protect your privacy, do not use personal data, such as your name or location, as an alias for your secret.
+         */
+        name: string;
+        /** An extended description of your secret.
+         *
+         *  To protect your privacy, do not use personal data, such as your name or location, as a description for your
+         *  secret.
+         */
+        description?: string;
+        /** The v4 UUID that uniquely identifies the secret group to assign to this secret.
+         *
+         *  If you omit this parameter, your secret is assigned to the `default` secret group.
+         */
+        secret_group_id?: string;
+        /** The secret state based on NIST SP 800-57. States are integers and correspond to the Pre-activation = 0,
+         *  Active = 1,  Suspended = 2, Deactivated = 3, and Destroyed = 5 values.
+         */
+        state?: number;
+        /** A text representation of the secret state. */
+        state_description?: string;
+        /** The secret type. */
+        secret_type?: string;
+        /** The Cloud Resource Name (CRN) that uniquely identifies the resource. */
+        crn?: string;
+        /** The date the secret was created. The date format follows RFC 3339. */
+        creation_date?: string;
+        /** The unique identifier for the entity that created the secret. */
+        created_by?: string;
+        /** Updates when any part of the secret metadata is modified. The date format follows RFC 3339. */
+        last_update_date?: string;
+        /** The number of versions the secret has. */
+        versions_total?: number;
+    }
+    /** Properties that describe a secret. */
+    interface KvSecretResource extends SecretResource {
+        /** The v4 UUID that uniquely identifies the secret. */
+        id?: string;
+        /** A human-readable alias to assign to your secret.
+         *
+         *  To protect your privacy, do not use personal data, such as your name or location, as an alias for your secret.
+         */
+        name: string;
+        /** An extended description of your secret.
+         *
+         *  To protect your privacy, do not use personal data, such as your name or location, as a description for your
+         *  secret.
+         */
+        description?: string;
+        /** The v4 UUID that uniquely identifies the secret group to assign to this secret.
+         *
+         *  If you omit this parameter, your secret is assigned to the `default` secret group.
+         */
+        secret_group_id?: string;
+        /** Labels that you can use to filter for secrets in your instance.
+         *
+         *  Up to 30 labels can be created. Labels can be 2 - 30 characters, including spaces. Special characters that are
+         *  not permitted include the angled bracket, comma, colon, ampersand, and vertical pipe character (|).
+         *
+         *  To protect your privacy, do not use personal data, such as your name or location, as a label for your secret.
+         */
+        labels?: string[];
+        /** The secret state based on NIST SP 800-57. States are integers and correspond to the Pre-activation = 0,
+         *  Active = 1,  Suspended = 2, Deactivated = 3, and Destroyed = 5 values.
+         */
+        state?: number;
+        /** A text representation of the secret state. */
+        state_description?: string;
+        /** The secret type. */
+        secret_type?: string;
+        /** The Cloud Resource Name (CRN) that uniquely identifies your Secrets Manager resource. */
+        crn?: string;
+        /** The date the secret was created. The date format follows RFC 3339. */
+        creation_date?: string;
+        /** The unique identifier for the entity that created the secret. */
+        created_by?: string;
+        /** Updates when the actual secret is modified. The date format follows RFC 3339. */
+        last_update_date?: string;
+        /** The number of versions that are associated with a secret. */
+        versions_total?: number;
+        /** An array that contains metadata for each secret version. For more information on the metadata properties,
+         *  see [Get secret version metadata](#get-secret-version-metadata).
+         */
+        versions?: JsonObject[];
+        /** The date the secret material expires. The date format follows RFC 3339.
+         *
+         *  You can set an expiration date on supported secret types at their creation. If you create a secret without
+         *  specifying an expiration date, the secret does not expire. The `expiration_date` field is supported for the
+         *  following secret types:
+         *
+         *  - `arbitrary`
+         *  - `username_password`.
+         */
+        expiration_date?: string;
+        /** The new secret data to assign to the secret. */
+        payload?: JsonObject;
+        /** The data that is associated with the secret version. The data object contains the field `payload`. */
+        secret_data?: JsonObject;
     }
     /** Configuration for the public certificates engine. */
     interface PublicCertSecretEngineRootConfig extends GetConfigResourcesItem {
@@ -1801,13 +2061,14 @@ declare namespace SecretsManagerV1 {
         dns_providers?: ConfigElementMetadata[];
     }
     /** Metadata properties that describe a public certificate secret. */
-    interface PublicCertificateMetadataSecretResource extends SecretMetadata {
+    interface PublicCertificateSecretMetadata extends SecretMetadata {
         /** The unique ID of the secret. */
         id?: string;
         /** Labels that you can use to filter for secrets in your instance.
          *
-         *  Up to 30 labels can be created. Labels can be between 2-30 characters, including spaces. Special characters not
-         *  permitted include the angled bracket, comma, colon, ampersand, and vertical pipe character (|).
+         *  Up to 30 labels can be created. Labels can be in the range 2 - 30 characters, including spaces. Special
+         *  characters that are not permitted include the angled bracket, comma, colon, ampersand, and vertical pipe
+         *  character (|).
          *
          *  To protect your privacy, do not use personal data, such as your name or location, as a label for your secret.
          */
@@ -1853,8 +2114,8 @@ declare namespace SecretsManagerV1 {
          *  Set to `false` for the certificate file to contain only the issued certificate.
          */
         bundle_certs?: boolean;
-        /** The identifier for the cryptographic algorthim to be used by the issuing certificate authority to sign the
-         *  ceritificate.
+        /** The identifier for the cryptographic algorithm to be used by the issuing certificate authority to sign the
+         *  certificate.
          */
         algorithm?: string;
         /** The identifier for the cryptographic algorithm to be used to generate the public key that is associated with
@@ -1895,8 +2156,8 @@ declare namespace SecretsManagerV1 {
         secret_group_id?: string;
         /** Labels that you can use to filter for secrets in your instance.
          *
-         *  Up to 30 labels can be created. Labels can be between 2-30 characters, including spaces. Special characters not
-         *  permitted include the angled bracket, comma, colon, ampersand, and vertical pipe character (|).
+         *  Up to 30 labels can be created. Labels can be 2 - 30 characters, including spaces. Special characters that are
+         *  not permitted include the angled bracket, comma, colon, ampersand, and vertical pipe character (|).
          *
          *  To protect your privacy, do not use personal data, such as your name or location, as a label for your secret.
          */
@@ -1940,15 +2201,15 @@ declare namespace SecretsManagerV1 {
          *  To view a list of your configured authorities, use the [List configurations API](#get-secret-config-element).
          */
         dns?: string;
-        /** The identifier for the cryptographic algorthim to be used by the issuing certificate authority to sign the
-         *  ceritificate.
+        /** The identifier for the cryptographic algorithm to be used by the issuing certificate authority to sign the
+         *  certificate.
          */
         algorithm?: string;
         /** The identifier for the cryptographic algorithm to be used to generate the public key that is associated with
          *  the certificate.
          *
-         *  The algorithm that you select determines the encryption algorthim (`RSA` or `ECDSA`) and key size to be used to
-         *  generate keys and sign certificates. For longer living certificates it is recommended to use longer keys to
+         *  The algorithm that you select determines the encryption algorithm (`RSA` or `ECDSA`) and key size to be used to
+         *  generate keys and sign certificates. For longer living certificates, it is recommended to use longer keys to
          *  provide more encryption protection.
          */
         key_algorithm?: string;
@@ -1956,12 +2217,29 @@ declare namespace SecretsManagerV1 {
         alt_names?: string[];
         /** The fully qualified domain name or host domain name for the certificate. */
         common_name?: string;
+        /** Indicates whether the issued certificate includes a private key. */
+        private_key_included?: boolean;
+        /** Indicates whether the issued certificate includes an intermediate certificate. */
+        intermediate_included?: boolean;
         rotation?: Rotation;
         /** Issuance information that is associated with your certificate. */
         issuance_info?: IssuanceInfo;
-        /** The data that is associated with the secret. */
+        validity?: CertificateValidity;
+        /** The data that is associated with the secret. The data object contains the following fields:
+         *
+         *  `certificate`: The contents of the certificate.
+         *
+         *  `private_key`: The private key that is associated with the certificate.
+         *
+         *  `intermediate`: The intermediate certificate that is associated with the certificate.
+         */
         secret_data?: JsonObject;
     }
+    /** The request body of a `restore` action. */
+    interface RestoreIAMCredentialsSecretBody extends SecretAction {
+        /** The ID of the target version or the alias `previous`. */
+        version_id: string;
+    }
     /** The request body of a `rotate` action. */
     interface RotateArbitrarySecretBody extends SecretAction {
         /** The new secret data to assign to an `arbitrary` secret. */
@@ -1977,8 +2255,13 @@ declare namespace SecretsManagerV1 {
         intermediate?: string;
     }
     /** The request body of a `rotate` action. */
+    interface RotateKvSecretBody extends SecretAction {
+        /** The new secret data to assign to a key-value secret. */
+        payload: JsonObject;
+    }
+    /** The request body of a `rotate` action. */
     interface RotatePublicCertBody extends SecretAction {
-        /** Determine whether keys should be rotated. */
+        /** Determine whether keys must be rotated. */
         rotate_keys: boolean;
     }
     /** The request body of a `rotate` action. */
@@ -2004,8 +2287,9 @@ declare namespace SecretsManagerV1 {
         id?: string;
         /** Labels that you can use to filter for secrets in your instance.
          *
-         *  Up to 30 labels can be created. Labels can be between 2-30 characters, including spaces. Special characters not
-         *  permitted include the angled bracket, comma, colon, ampersand, and vertical pipe character (|).
+         *  Up to 30 labels can be created. Labels can be in the range 2 - 30 characters, including spaces. Special
+         *  characters that are not permitted include the angled bracket, comma, colon, ampersand, and vertical pipe
+         *  character (|).
          *
          *  To protect your privacy, do not use personal data, such as your name or location, as a label for your secret.
          */
@@ -2077,8 +2361,8 @@ declare namespace SecretsManagerV1 {
         secret_group_id?: string;
         /** Labels that you can use to filter for secrets in your instance.
          *
-         *  Up to 30 labels can be created. Labels can be between 2-30 characters, including spaces. Special characters not
-         *  permitted include the angled bracket, comma, colon, ampersand, and vertical pipe character (|).
+         *  Up to 30 labels can be created. Labels can be 2 - 30 characters, including spaces. Special characters that are
+         *  not permitted include the angled bracket, comma, colon, ampersand, and vertical pipe character (|).
          *
          *  To protect your privacy, do not use personal data, such as your name or location, as a label for your secret.
          */
@@ -2109,6 +2393,10 @@ declare namespace SecretsManagerV1 {
         username?: string;
         /** The password to assign to this secret. */
         password?: string;
+        /** The data that is associated with the secret version. The data object contains the following fields:
+         *  `username`: The username that is associated with the secret version.
+         *  `password`: The password that is associated with the secret version.
+         */
         secret_data?: JsonObject;
         /** The date the secret material expires. The date format follows RFC 3339.
          *
@@ -2127,14 +2415,57 @@ declare namespace SecretsManagerV1 {
          */
         next_rotation_date?: string;
     }
+    /** UsernamePasswordSecretVersion. */
+    interface UsernamePasswordSecretVersion extends SecretVersion {
+        /** The v4 UUID that uniquely identifies the secret. */
+        id?: string;
+        /** The ID of the secret version. */
+        version_id?: string;
+        /** The date that the version of the secret was created. */
+        creation_date?: string;
+        /** The unique identifier for the entity that created the secret version. */
+        created_by?: string;
+        /** Indicates whether the version of the secret was created by automatic rotation. */
+        auto_rotated?: boolean;
+        /** The data that is associated with the secret version. The data object contains the following fields:
+         *  `username`: The username that is associated with the secret version.
+         *  `password`: The password that is associated with the secret version.
+         */
+        secret_data?: JsonObject;
+    }
+    /** UsernamePasswordSecretVersionInfo. */
+    interface UsernamePasswordSecretVersionInfo extends SecretVersionInfo {
+        /** The ID of the secret version. */
+        id?: string;
+        /** The date that the version of the secret was created. */
+        creation_date?: string;
+        /** The unique identifier for the entity that created the secret version. */
+        created_by?: string;
+        /** Indicates whether the payload for the secret version is stored and available. */
+        payload_available?: boolean;
+        /** Indicates whether the secret data that is associated with a secret version was retrieved in a call to the
+         *  service API.
+         */
+        downloaded?: boolean;
+        /** Indicates whether the version of the secret was created by automatic rotation. */
+        auto_rotated?: boolean;
+    }
     /** Properties that describe a secret version. */
     interface UsernamePasswordSecretVersionMetadata extends SecretVersionMetadata {
-        /** The ID of the secret version. */
+        /** The v4 UUID that uniquely identifies the secret. */
         id?: string;
+        /** The ID of the secret version. */
+        version_id?: string;
         /** The date that the version of the secret was created. */
         creation_date?: string;
         /** The unique identifier for the entity that created the secret version. */
         created_by?: string;
+        /** Indicates whether the payload for the secret version is stored and available. */
+        payload_available?: boolean;
+        /** Indicates whether the secret data that is associated with a secret version was retrieved in a call to the
+         *  service API.
+         */
+        downloaded?: boolean;
         /** Indicates whether the version of the secret was created by automatic rotation. */
         auto_rotated?: boolean;
     }