全部產品
Search
文件中心

Key Management Service:UpdateSecretRotationPolicy - 更新動態憑據的輪轉策略

更新時間:Dec 21, 2025

更新憑據輪轉策略。

介面說明

  • RAM 使用者或 RAM 角色調用該 OpenAPI 需要被授與權限策略詳情,請參見存取控制

  • UpdateSecretRotationPolicy 介面不支援更新通用憑據的輪轉策略。

    說明

    因通用憑據不支援設定自動輪轉,所以本介面不支援。

  • 憑據開啟自動輪轉後,首次自動輪轉的時間為上次輪轉時間加上輪轉周期。如果該時間早於目前時間,將會立即開始首次自動輪轉。

本文將提供一個樣本,更新名稱為RdsSecret/Mysql5.4/MyCred的憑據輪轉策略。具體如下:

  • EnableAutomaticRotation設定為true,表示開啟自動輪轉。

  • RotationInterval設定為30d,表示設定輪轉周期為 30 天。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

SecretName

string

憑據名稱或憑據資源名稱(ARN)。

說明

訪問其他阿里雲帳號下的憑據時,必須輸入憑據 ARN。憑據 ARN 的格式為acs:kms:${region}:${account}:secret/${secret-name}

RdsSecret/Mysql5.4/MyCred

EnableAutomaticRotation

boolean

是否開啟自動輪轉,取值:

  • true:開啟自動輪轉。

  • false(預設值):不開啟自動輪轉。

true

RotationInterval

string

自動輪轉的周期。取值範圍:168 小時(7 天)~8,760 小時(365 天)。

格式為integer\[unit\],其中integer表示時間長度,unit表示時間單位。
unit 取值:d(天)、h(小時)、m(分鐘)、s(秒)。例如:7d 或者 604,800s 均表示 7 天的周期。

說明

當 EnableAutomaticRotation 取值為 true 時,必須設定該參數。反之,將忽略該參數。

30d

關於公用請求參數的詳情,請參見公用參數

返回參數

名稱

類型

描述

樣本值

object

SecretName

string

憑據名稱。

RdsSecret/Mysql5.4/MyCred

RequestId

string

本次調用請求的 ID,是由阿里雲為該請求產生的唯一識別碼,可用於排查和定位問題。

2c124f6f-4210-499f-b88a-69f54004d2d8

樣本

正常返回樣本

JSON格式

{
  "SecretName": "RdsSecret/Mysql5.4/MyCred",
  "RequestId": "2c124f6f-4210-499f-b88a-69f54004d2d8"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情