Reference documentation and code samples for the Secret Manager V1 Client class Rotation.
The rotation time and period for aSecret. At next_rotation_time, Secret
Manager will send a Pub/Sub notification to the topics configured on the
Secret.Secret.topicsmust be
set to configure rotation.
Generated from protobuf messagegoogle.cloud.secretmanager.v1.Rotation
Optional. Timestamp in UTC at which theSecretis scheduled to rotate. Cannot be set to less than 300s (5 min) in the future and at most 3153600000s (100 years).next_rotation_timeMUST be set ifrotation_periodis set.
Input only. The Duration between rotation notifications. Must be in seconds and at least 3600s (1h) and at most 3153600000s (100 years). Ifrotation_periodis set,next_rotation_timemust be set.next_rotation_timewill be advanced by this period when the service automatically sends rotation notifications.
getNextRotationTime
Optional. Timestamp in UTC at which theSecretis scheduled to rotate.
Cannot be set to less than 300s (5 min) in the future and at most
3153600000s (100 years).next_rotation_timeMUST be set ifrotation_periodis 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."]]
