[VAULT] 1.21.x release notes

content/vault/global/partials/important-changes/breaking-changes/client-count-timestamp.mdx

@@ -0,0 +1,29 @@
+### Renamed timestamp fields for client count activity export ((#client-count-export))
+
+| Change       | Affected version | Vault edition
+| ------------ | ---------------- | -------------
+| Breaking     | 1.21.0+          | All
+
+Vault counts a client the first time that client makes an authenticated API
+during the billing period.
+
+Previously, the Activity Export endpoint response included a `timestamp`
+field that reflected the creation time and date for the client token, which
+could precede the start of the billing period, rather than the time and date
+of the first authenticated API call.
+
+To clarify the data returned, the endpoint now returns two timestamp parameters:
+
+- **`client_first_usage_time`** - (new) indicates when the client first made an
+  authenticated API call during the billing period.
+- **`token_creation_time`** - (replaces `timestamp`) indicates the creation
+  timestamp of the token.
+
+
+#### Recommendation
+
+Review your use of the `timestamp` field and:
+
+1. Consider if the context makes `client_first_usage_time` a more appropriate
+   timestamp.
+1. Update any remaining references to `timestamp` to use `token_creation_time`.

content/vault/v1.21.x (rc)/content/docs/updates/deprecation.mdx

@@ -21,10 +21,7 @@ or raise a ticket with your support team.
 
 <a id="announcements" />
 
-## Recent announcements
-
-<Tabs>
-<Tab heading="DEPRECATED">
+## Deprecations ((#deprecations))
 
 <EnterpriseAlert product="vault">
   The Vault Support Team can provide <b>limited</b> help with a deprecated feature.
@@ -34,26 +31,27 @@ or raise a ticket with your support team.
   more information on the product support timeline.
 </EnterpriseAlert>
 
-@include 'deprecation/ruby-client-library.mdx'
 
 @include 'deprecation/snowflake-password-auth.mdx'
 
-</Tab>
-<Tab heading="PENDING REMOVAL">
+
+## Pending removal
 
 @include 'deprecation/vault-agent-api-proxy.mdx'
 
+@include 'deprecation/duplicate-hcl-attributes.mdx'
+
+
+## Removed 
+
+@include 'deprecation/ruby-client-library.mdx'
+
 @include 'deprecation/aws-field-change.mdx'
 
 @include 'deprecation/centrify-auth-method.mdx'
 
-@include 'deprecation/duplicate-hcl-attributes.mdx'
-
 @include 'deprecation/list-allowed-parameters.mdx'
 
-</Tab>
-<Tab heading="REMOVED">
-
 @include 'deprecation/active-directory-secrets-engine.mdx'
 
 @include 'deprecation/duplicative-docker-images.mdx'
@@ -62,8 +60,6 @@ or raise a ticket with your support team.
 
 @include 'deprecation/internal-counters-tokens-api.mdx'
 
-</Tab>
-</Tabs>
 
 <a id="phases" />
 

content/vault/v1.21.x (rc)/content/docs/updates/important-changes.mdx

@@ -4,12 +4,6 @@ page_title: Important changes
 description: >-
   Deprecations, important or breaking changes, and remediation recommendations
   for upgrading Vault.
-
-valid_change_types: >-
-  - Change in support
-  - New behavior (new defaults, new requirements, etc.)
-  - Breaking change --> workaround/recommendation recommended
-  - Known issue --> workaround/recommendation required
 ---
 
 # Important changes
@@ -21,6 +15,8 @@ before upgrading Vault.
 
 ## Breaking changes
 
+@include '../../../global/partials/important-changes/breaking-changes/client-count-timestamp.mdx'
+
 ### Audiences required for Kubernetes authentication roles ((##k8-audience-required))
 
 | Change       | Affected version | Vault edition
@@ -51,6 +47,8 @@ more information.
 
 @include '../../../global/partials/important-changes/breaking-changes/allowed-parameters-list.mdx'
 
+---
+
 ## New behavior
 
 ### Rotation manager schedule strings in UTC ((#rotation-manager-utc))