`mc admin user accesskey edit`

語法

mc admin accesskey edit 命令會修改與指定使用者關聯的存取金鑰的設定。

此命令要求至少變更存取金鑰的一個屬性。否則，此命令會以錯誤訊息結束。

範例

以下命令將新原則和秘密金鑰套用到 myminio 部署上的 myuserserviceaccount 存取金鑰

mc admin accesskey edit                                             \
                   myminio myuserserviceaccount                     \
                   --secret-key "myuserserviceaccountnewsecretkey"  \
                   --policy "/path/to/new/policy.json"

語法

此命令具有以下語法

mc [GLOBALFLAGS] admin accesskey edit                      \
                                 ALIAS                     \
                                 ACCESSKEY                 \
                                 [--description string]    \
                                 [--expiry-duration value] \
                                 [--expiry value]          \
                                 [--name string]           \
                                 [--policy path]           \
                                 [--secret-key string]

方括號 [] 表示選用參數。
同一行的參數是互相依賴的。
使用管道符號 | 分隔的參數是互斥的。

將範例複製到文字編輯器中，並在終端機/命令列中執行命令之前，根據需要進行修改。

參數

ALIAS: 必要
MinIO 部署的 alias。

ACCESSKEY: 必要
要修改的存取金鑰。

--description: 選用
新增或修改存取金鑰的描述。例如，您可以指定存取金鑰存在的原因。

--expiry

選用

設定或修改存取金鑰的到期日。日期必須是未來，您不能設定已過期的到期日。

允許的日期和時間格式

2023-06-24
2023-06-24T10:00
2023-06-24T10:00:00
2023-06-24T10:00:00Z
2023-06-24T10:00:00-07:00

與 --expiry-duration 互斥。

--expiry-duration

選用

存取金鑰保持有效的時間長度。

例如，30d、24h 或類似的格式。若要讓憑證在 30 天後過期，請使用

--expiry-duration 30d

與 --expiry 互斥。

--name: 選用
新增或修改存取金鑰的人工可讀名稱。

--policy

選用

要附加到新存取金鑰的原則文件路徑，最大大小為 2048 個字元。附加的原則不能授予對父使用者原則未明確允許的任何動作或資源的存取權限。

新的原則會覆寫先前附加的任何原則。

--secret-key: 選用
要與新存取金鑰關聯的私密金鑰。覆寫先前的私密金鑰。使用存取金鑰的應用程式必須更新才能使用新的憑證繼續執行操作。

全域旗標

此命令支援任何全域旗標。

範例

變更存取金鑰的私密金鑰

以下命令會修改 myminio 部署上存取金鑰 myuseraccesskey 的私密金鑰。

mc admin accesskey edit myminio/ myuseraccesskey --secret-key 'new-secret-key-change-me'

變更存取金鑰的到期時間

以下命令會變更 myminio 部署上存取金鑰 myuseraccesskey 的到期值。

mc admin accesskey edit myminio/ myuseraccesskey --expiry-duration 24h

如果存取金鑰已經為 --expiry 設定了值，則無法新增 --expiry-duration。

行為

S3 相容性

mc 命令列工具是為了與 AWS S3 API 相容而建置的，並已使用 MinIO 和 AWS S3 針對預期的功能和行為進行測試。

MinIO 對於其他與 S3 相容的服務不提供任何保證，因為它們的 S3 API 實作是未知的，因此不受支援。雖然 mc 命令可能會如文件所述般運作，但任何此類使用都需自行承擔風險。