Reference documentation and code samples for the Secret Manager V1beta2 Client class Rotation.
The rotation time and period for a
Secret. At next_rotation_time,
Secret Manager will send a Pub/Sub notification to the topics configured on
the Secret. Secret.topics
must be set to configure rotation.
Generated from protobuf message google.cloud.secretmanager.v1beta2.Rotation
Optional. Timestamp in UTC at which the Secret is scheduled to rotate. Cannot be set to less than 300s (5 min) in the future and at most 3153600000s (100 years). next_rotation_time MUST be set if rotation_period is set.
Input only. The Duration between rotation notifications. Must be in seconds and at least 3600s (1h) and at most 3153600000s (100 years). If rotation_period is set, next_rotation_time must be set. next_rotation_time will be advanced by this period when the service automatically sends rotation notifications.
getNextRotationTime
Optional. Timestamp in UTC at which the
Secret is scheduled to rotate.
Cannot be set to less than 300s (5 min) in the future and at most
3153600000s (100 years).
next_rotation_time
MUST be set if
rotation_period
is set.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Secret Manager V1beta2 Client - Class Rotation (2.1.1)\n\nVersion latestkeyboard_arrow_down\n\n- [2.1.1 (latest)](/php/docs/reference/cloud-secret-manager/latest/V1beta2.Rotation)\n- [2.1.0](/php/docs/reference/cloud-secret-manager/2.1.0/V1beta2.Rotation)\n- [2.0.2](/php/docs/reference/cloud-secret-manager/2.0.2/V1beta2.Rotation)\n- [1.15.4](/php/docs/reference/cloud-secret-manager/1.15.4/V1beta2.Rotation)\n- [1.13.0](/php/docs/reference/cloud-secret-manager/1.13.0/V1beta2.Rotation)\n- [1.12.3](/php/docs/reference/cloud-secret-manager/1.12.3/V1beta2.Rotation)\n- [1.11.0](/php/docs/reference/cloud-secret-manager/1.11.0/V1beta2.Rotation)\n- [1.10.4](/php/docs/reference/cloud-secret-manager/1.10.4/V1beta2.Rotation)\n- [1.9.7](/php/docs/reference/cloud-secret-manager/1.9.7/V1beta2.Rotation) \n| **Beta**\n|\n|\n| This library is covered by the [Pre-GA Offerings Terms](/terms/service-terms#1)\n| of the Terms of Service. Pre-GA libraries might have limited support,\n| and changes to pre-GA libraries might not be compatible with other pre-GA versions.\n| For more information, see the\n[launch stage descriptions](/products#product-launch-stages). \nReference documentation and code samples for the Secret Manager V1beta2 Client class Rotation.\n\nThe rotation time and period for a\n[Secret](/php/docs/reference/cloud-secret-manager/latest/V1beta2.Secret). At next_rotation_time,\nSecret Manager will send a Pub/Sub notification to the topics configured on\nthe Secret. [Secret.topics](/php/docs/reference/cloud-secret-manager/latest/V1beta2.Secret#_Google_Cloud_SecretManager_V1beta2_Secret__getTopics__)\nmust be set to configure rotation.\n\nGenerated from protobuf message `google.cloud.secretmanager.v1beta2.Rotation`\n\nNamespace\n---------\n\nGoogle \\\\ Cloud \\\\ SecretManager \\\\ V1beta2\n\nMethods\n-------\n\n### __construct\n\nConstructor.\n\n### getNextRotationTime\n\nOptional. Timestamp in UTC at which the\n[Secret](/php/docs/reference/cloud-secret-manager/latest/V1beta2.Secret) is scheduled to rotate.\n\nCannot be set to less than 300s (5 min) in the future and at most\n3153600000s (100 years).\n[next_rotation_time](/php/docs/reference/cloud-secret-manager/latest/V1beta2.Rotation#_Google_Cloud_SecretManager_V1beta2_Rotation__getNextRotationTime__)\nMUST be set if\n[rotation_period](/php/docs/reference/cloud-secret-manager/latest/V1beta2.Rotation#_Google_Cloud_SecretManager_V1beta2_Rotation__getRotationPeriod__)\nis set.\n\n### hasNextRotationTime\n\n### clearNextRotationTime\n\n### setNextRotationTime\n\nOptional. Timestamp in UTC at which the\n[Secret](/php/docs/reference/cloud-secret-manager/latest/V1beta2.Secret) is scheduled to rotate.\n\nCannot be set to less than 300s (5 min) in the future and at most\n3153600000s (100 years).\n[next_rotation_time](/php/docs/reference/cloud-secret-manager/latest/V1beta2.Rotation#_Google_Cloud_SecretManager_V1beta2_Rotation__getNextRotationTime__)\nMUST be set if\n[rotation_period](/php/docs/reference/cloud-secret-manager/latest/V1beta2.Rotation#_Google_Cloud_SecretManager_V1beta2_Rotation__getRotationPeriod__)\nis set.\n\n### getRotationPeriod\n\nInput only. The Duration between rotation notifications. Must be in seconds\nand at least 3600s (1h) and at most 3153600000s (100 years).\n\nIf\n[rotation_period](/php/docs/reference/cloud-secret-manager/latest/V1beta2.Rotation#_Google_Cloud_SecretManager_V1beta2_Rotation__getRotationPeriod__)\nis set,\n[next_rotation_time](/php/docs/reference/cloud-secret-manager/latest/V1beta2.Rotation#_Google_Cloud_SecretManager_V1beta2_Rotation__getNextRotationTime__)\nmust be set.\n[next_rotation_time](/php/docs/reference/cloud-secret-manager/latest/V1beta2.Rotation#_Google_Cloud_SecretManager_V1beta2_Rotation__getNextRotationTime__)\nwill be advanced by this period when the service automatically sends\nrotation notifications.\n\n### hasRotationPeriod\n\n### clearRotationPeriod\n\n### setRotationPeriod\n\nInput only. The Duration between rotation notifications. Must be in seconds\nand at least 3600s (1h) and at most 3153600000s (100 years).\n\nIf\n[rotation_period](/php/docs/reference/cloud-secret-manager/latest/V1beta2.Rotation#_Google_Cloud_SecretManager_V1beta2_Rotation__getRotationPeriod__)\nis set,\n[next_rotation_time](/php/docs/reference/cloud-secret-manager/latest/V1beta2.Rotation#_Google_Cloud_SecretManager_V1beta2_Rotation__getNextRotationTime__)\nmust be set.\n[next_rotation_time](/php/docs/reference/cloud-secret-manager/latest/V1beta2.Rotation#_Google_Cloud_SecretManager_V1beta2_Rotation__getNextRotationTime__)\nwill be advanced by this period when the service automatically sends\nrotation notifications."]]