Reference documentation and code samples for the Secret Manager V1 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.v1.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 V1 Client - Class Rotation (2.1.1)\n\nVersion latestkeyboard_arrow_down\n\n- [2.1.1 (latest)](/php/docs/reference/cloud-secret-manager/latest/V1.Rotation)\n- [2.1.0](/php/docs/reference/cloud-secret-manager/2.1.0/V1.Rotation)\n- [2.0.2](/php/docs/reference/cloud-secret-manager/2.0.2/V1.Rotation)\n- [1.15.4](/php/docs/reference/cloud-secret-manager/1.15.4/V1.Rotation)\n- [1.13.0](/php/docs/reference/cloud-secret-manager/1.13.0/V1.Rotation)\n- [1.12.3](/php/docs/reference/cloud-secret-manager/1.12.3/V1.Rotation)\n- [1.11.0](/php/docs/reference/cloud-secret-manager/1.11.0/V1.Rotation)\n- [1.10.4](/php/docs/reference/cloud-secret-manager/1.10.4/V1.Rotation)\n- [1.9.7](/php/docs/reference/cloud-secret-manager/1.9.7/V1.Rotation) \nReference documentation and code samples for the Secret Manager V1 Client class Rotation.\n\nThe rotation time and period for a\n[Secret](/php/docs/reference/cloud-secret-manager/latest/V1.Secret). At next_rotation_time, Secret\nManager will send a Pub/Sub notification to the topics configured on the\nSecret. [Secret.topics](/php/docs/reference/cloud-secret-manager/latest/V1.Secret#_Google_Cloud_SecretManager_V1_Secret__getTopics__) must be\nset to configure rotation.\n\nGenerated from protobuf message `google.cloud.secretmanager.v1.Rotation`\n\nNamespace\n---------\n\nGoogle \\\\ Cloud \\\\ SecretManager \\\\ V1\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/V1.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/V1.Rotation#_Google_Cloud_SecretManager_V1_Rotation__getNextRotationTime__)\nMUST be set if\n[rotation_period](/php/docs/reference/cloud-secret-manager/latest/V1.Rotation#_Google_Cloud_SecretManager_V1_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/V1.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/V1.Rotation#_Google_Cloud_SecretManager_V1_Rotation__getNextRotationTime__)\nMUST be set if\n[rotation_period](/php/docs/reference/cloud-secret-manager/latest/V1.Rotation#_Google_Cloud_SecretManager_V1_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/V1.Rotation#_Google_Cloud_SecretManager_V1_Rotation__getRotationPeriod__)\nis set,\n[next_rotation_time](/php/docs/reference/cloud-secret-manager/latest/V1.Rotation#_Google_Cloud_SecretManager_V1_Rotation__getNextRotationTime__)\nmust be set.\n[next_rotation_time](/php/docs/reference/cloud-secret-manager/latest/V1.Rotation#_Google_Cloud_SecretManager_V1_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/V1.Rotation#_Google_Cloud_SecretManager_V1_Rotation__getRotationPeriod__)\nis set,\n[next_rotation_time](/php/docs/reference/cloud-secret-manager/latest/V1.Rotation#_Google_Cloud_SecretManager_V1_Rotation__getNextRotationTime__)\nmust be set.\n[next_rotation_time](/php/docs/reference/cloud-secret-manager/latest/V1.Rotation#_Google_Cloud_SecretManager_V1_Rotation__getNextRotationTime__)\nwill be advanced by this period when the service automatically sends\nrotation notifications."]]