> ## Documentation Index
> Fetch the complete documentation index at: https://ppio.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 更新 Secret

`ppio.secret.update()` 为已有 Secret 创建一个新的不可变版本，并在值存储完成、策略持久化后使其生效。正在运行的执行会保持启动时选定的版本和主机策略；新创建、恢复和克隆的执行会使用最新的活跃版本。

## 示例

该示例确保 Secret 存在，使用 `ppio.secret.update()` 更新它，启动一个引用已更新 Secret 的沙箱，在沙箱内使用占位符，并在完成后销毁沙箱。

<CodeGroup>
  ```python Python theme={null}
  from ppio_sandbox import PPIO

  ppio = PPIO()

  secret_name = "<your-secret-name>"

  ppio.secret.update(
      name=secret_name,
      value="<your-value>",
      hosts=["api.openai.com"],
      description="Updated Sandbox Secrets example",
  )
  ```

  ```javascript JavaScript & TypeScript theme={null}
  import { PPIO } from 'ppio-sandbox'

  const ppio = new PPIO()

  const secretName = '<your-secret-name>'

  await ppio.secret.update({
    name: secretName,
    value: '<your-value>',
    hosts: ['api.openai.com'],
    description: 'Updated Sandbox Secrets example',
  })
  ```

  ```bash CLI theme={null}
  # 直接更新 Secret
  ppio secret update <secret_name> --from-value <secret_value>

  # 从环境变量读取 value
  ppio secret update <secret_name> --from-env <env_name>

  # 从标准输入输出设置 value
  ppio secret update <secret_name> --from-stdin

  # 以管道的方式设置 value
  echo "value" | ppio secret update <secret_name> --from-stdin
  ```
</CodeGroup>

<Note>
  每次更新都会创建一个新的不可变版本，只有在值和策略持久化之后才会生效。已在运行的执行会继续使用启动时选定的版本；新建、恢复和克隆的执行会采用最新的活跃版本。
</Note>