> For the complete documentation index, see [llms.txt](https://docs.goassay.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.goassay.ai/list-your-api/zh/ri-chang-shi-yong/edit-pause-or-resume-a-listing.md).

# 编辑、暂停或恢复上架

更新现有上架项的条款或连接，并停止或恢复流量。

修改客户价格或 Assay 访问 API 的方式时，请使用现有上架项。需要停止新流量时暂停，端点准备好后再恢复。

{% hint style="info" %}
\*\*开始前：\*\*已有已发布的上架项。[上架目录中的工具](/list-your-api/zh/ru-men/list-a-catalogue-tool.md)介绍了连接、身份验证和测试；更新现有连接时使用同样的控件。
{% endhint %}

## 操作步骤

选择需要的变更。它们是同一上架项上的独立任务；暂停前不需要先编辑。

{% tabs %}
{% tab title="价格、承诺或限制" %}
{% stepper %}
{% step %}

### 在 Settings 中打开 Price

打开 **Listings**，选择工具并打开 **Settings**。在 **Price** 下选择 **Free**、**Free + paid** 或 **Paid**。选择付费方式时，修改 **Price per call**。选择 **Free + paid** 时，设置 **Free calls per agent per day**。

**Free calls per day, all agents (optional)** 限制所有智能体合计的每日免费调用次数。它是调用次数，不是金额。留空则使用平台默认值。两项每日额度都在 00:00 UTC 重置。

<figure><img src="https://2968587239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEVw4IWiK1TgVNFeMYjWm%2Fuploads%2Fgit-blob-fad0488677fcbc5f21e3287b1cf12d9ac47867b2%2Fedit-pause-or-resume-a-listing-1.png?alt=media" alt="Settings 的 Price 卡片，已选择 Free + paid，并显示每日免费额度控件"><figcaption><p>为现有上架项设置价格和免费调用额度。</p></figcaption></figure>
{% endstep %}

{% step %}

### 保存并核对变更

选择 **Save**。如果打开确认窗口，保存前阅读价格、免费调用和质押变更。提高付费价格可能需要更多质押。添加质押需要钱包；批准前核对金额。

<figure><img src="https://2968587239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEVw4IWiK1TgVNFeMYjWm%2Fuploads%2Fgit-blob-d1b78f4399527b374cc83789ff10c74142e7bdc4%2Fedit-pause-or-resume-a-listing-2.png?alt=media" alt="Settings 底部栏，已标出 Save"><figcaption><p>保存已核对的设置。</p></figcaption></figure>

修改价格或支付模式后需要发布。出现 **You have saved changes that are not live yet.** 时，选择 **Review and publish**，完成现有上架项的 **Go live** 检查。新价格或支付模式还需要一次新的通过测试；如果 **Go live** 要求测试，请重新运行。[上架目录中的工具](/list-your-api/zh/ru-men/list-a-catalogue-tool.md)介绍了发布要求。

只修改免费额度时，保存即生效，无需发布。已发生的调用保留原价格。

同一 **Settings** 页面还包括：

* **Your promise**：**Failures you promise to stay under** 和 **Time we wait for your API**。[质量与 SLA](/list-your-api/zh/jin-jie/quality-and-sla.md)解释了这两项。
* **Limits (optional)**：此上架项接受的 **Most calls per second** 和 **Most calls per day**。

<figure><img src="https://2968587239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEVw4IWiK1TgVNFeMYjWm%2Fuploads%2Fgit-blob-6ac0b838533c8eb6ce8b61f79bff3bf020b0c4c2%2Fedit-pause-or-resume-a-listing-3.png?alt=media" alt="Your promise 和 Limits 卡片，已标出每秒调用数和每日调用数"><figcaption><p>保存前核对承诺和可选的流量限制。</p></figcaption></figure>

承诺和限制的变更保存即生效。新的 **Time we wait for your API** 需要新的通过测试并发布，与价格变更相同。
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="端点或身份认证" %}
{% stepper %}
{% step %}

### 修改连接

在上架项的 **Settings** 找到 **Connection**，选择 **Change and test again**。按[上架目录中的工具](/list-your-api/zh/ru-men/list-a-catalogue-tool.md)中的端点和测试步骤更新现有连接。保存新地址，通过测试，再核对并发布变更。

替代连接发布前，线上调用继续使用已发布端点。请保持旧端点可用，直到已发给它的调用完成。

<figure><img src="https://2968587239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEVw4IWiK1TgVNFeMYjWm%2Fuploads%2Fgit-blob-a78eac8a41a21f47b1099be27329c287a7b69718%2Fedit-pause-or-resume-a-listing-4.png?alt=media" alt="Connection 卡片，显示已保存的地址，已标出 Change and test again"><figcaption><p>发布前测试替代连接。</p></figcaption></figure>
{% endstep %}

{% step %}

### 匹配 API 接受的身份验证方式

在 **Authentication** 下选择端点会检查的方式。按[上架目录中的工具](/list-your-api/zh/ru-men/list-a-catalogue-tool.md)中的密钥或签名身份验证步骤操作，修改方式后选择 **Save**。

身份验证变更保存即生效。已保存的密钥请求头有自己的 **Save headers** 操作。它们属于此上架项及其地址（协议、主机和端口）；同一地址的其他上架项需要各自的请求头。替换请求头会替换整组。请与 API 端配合修改，让当前调用继续获接受。

迁移到其他地址时，先为新地址保存请求头，再测试。在替代连接发布前，保留线上地址的请求头。单独修改地址不会迁移凭据。

<figure><img src="https://2968587239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEVw4IWiK1TgVNFeMYjWm%2Fuploads%2Fgit-blob-4934c874b143da309b9686646d963febae49a6d9%2Fedit-pause-or-resume-a-listing-5.png?alt=media" alt="身份验证选项，已选择 API key"><figcaption><p>选择端点已能验证的方式。</p></figcaption></figure>
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="暂停或恢复" %}
{% stepper %}
{% step %}

### 暂停新流量

在上架项的 **Overview** 选择 **Pause**。阅读确认内容，再选择 **Pause tool**。

Assay 会立即停止向此上架项发送新调用。同一目录工具的其他合格提供方可以继续为客户服务；如果没有可用提供方，工具可能不可用。已发送的调用会按正常流程继续检查和处理支付。暂停保留之前的调用和收益，本身不会增加罚没或质量标记。

<figure><img src="https://2968587239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEVw4IWiK1TgVNFeMYjWm%2Fuploads%2Fgit-blob-10c8401264402e4f1c57ecd62740c2e772c0355f%2Fedit-pause-or-resume-a-listing-6.png?alt=media" alt="暂停天气工具的确认窗口，说明对新调用和现有收益的影响"><figcaption><p>暂停会停止此上架项的新流量。</p></figcaption></figure>
{% endstep %}

{% step %}

### 端点准备好后恢复

在已暂停上架项的 **Overview** 选择 **Resume**。

<figure><img src="https://2968587239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEVw4IWiK1TgVNFeMYjWm%2Fuploads%2Fgit-blob-295aacdea6e64e535dc2e7dff6794356a6d71c0b%2Fedit-pause-or-resume-a-listing-7.png?alt=media" alt="已暂停 get_weather 的上架页顶部，已标出 Resume 按钮"><figcaption><p>暂停的上架项显示 Paused，并提供 Resume。</p></figcaption></figure>

阅读价格、承诺和质押要求，准备好重新提供服务时选择 **Resume listing**。上架项仍须满足接收流量的要求，包括付费调用所需的足够质押，以及必要的身份验证请求头。

恢复使用最近一次已发布的连接和价格。已保存但未发布的修改仍需发布。暂停期间发布变更会保持暂停；准备好后另行恢复。

<figure><img src="https://2968587239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEVw4IWiK1TgVNFeMYjWm%2Fuploads%2Fgit-blob-2a144b627734763ed8f4f884f3601f2e64846665%2Fedit-pause-or-resume-a-listing-8.png?alt=media" alt="恢复确认窗口，显示上架项价格、承诺、质押要求和 Resume listing 按钮"><figcaption><p>恢复前核对已发布条款。</p></figcaption></figure>
{% endstep %}
{% endstepper %}
{% endtab %}
{% endtabs %}

## 确认是否成功

返回 **Overview** 和 **Settings**，检查预期条款和状态。发布后，已保存变更横幅会消失。暂停的上架项显示 **Paused**；恢复后显示 **Live**，并再次提供 **Pause**。如果质押或其他要求未满足，仅显示 **Live** 也不保证有付费流量。

<figure><img src="https://2968587239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEVw4IWiK1TgVNFeMYjWm%2Fuploads%2Fgit-blob-17aee620344e97063fe2199483e64e81dbd683fe%2Fedit-pause-or-resume-a-listing-9.png?alt=media" alt="已上线 get_weather 的上架页顶部，再次提供 Pause"><figcaption><p>恢复后，上架项重新显示 Live。</p></figcaption></figure>

## 遇到问题时

| 你看到的情况                                            | 处理方式                                          |
| ------------------------------------------------- | --------------------------------------------- |
| **You have saved changes that are not live yet.** | 使用 **Review and publish**。保存新价格或端点还不是最后一步。    |
| 发布需要新测试                                           | 修改价格、支付模式、超时或连接后，重新运行测试。                      |
| 恢复时显示质押不足                                         | 补足质押后再期待付费调用。批准任何钱包操作前核对金额。                   |
| 无法保存 API 密钥身份验证或恢复服务                              | 为已发布地址保存完整的必需请求头。                             |
| **Paused by Assay**                               | 阅读 **Inbox** 了解原因。提供方主动暂停与 Assay 停止服务的恢复步骤不同。 |

## 下一步

* [回应不良结果报告](/list-your-api/zh/ri-chang-shi-yong/answer-a-dispute.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.goassay.ai/list-your-api/zh/ri-chang-shi-yong/edit-pause-or-resume-a-listing.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.