使用 API 删除配置包

Last published : Oct 06, 2026
您可以使用以下 StyleBook API 删除配置包。
DELETE https://<ADM-endpoint-name>/stylebook/nitro/v2/config/configpacks/<configpack-ID>?mode=async
将显示 HTTP 状态 202 和响应负载。响应负载包含作业 ID,您可以使用该 ID 跟踪删除操作的状态。
响应负载如下:
{
    "job": {
        "job_id": "1841028854"
    }
}
要跟踪删除作业操作,请使用作业轮询 API 和作业 ID(在此示例中,作业 ID 为 1841028854):
GET https://<ADM-endpoint-name>/stylebook/nitro/v2/config/jobs/1841028854
如果响应中的状态字段设置为“completed”,则表示删除作业操作成功,如以下示例所示:
{
    "job": {
        "job_id": "3920886024",
        "status": "completed",
        "progress_info": [
            {
                "is_last": "false",
                "message": "Validated the parameters",
                "status": "success"
            },
            {
                "is_last": "false",
                "message": "Configuration audit completed",
                "status": "success"
            },
            {
                "is_last": "false",
                "message": "Computed configuration objects",
                "status": "success"
            },
            {
                "is_last": "false",
                "message": "Prepared objects for applying configuration on 192.168.153.165",
                "status": "success"
            },
            {
                "is_last": "false",
                "message": "Retrieved existing data for updatable objects on instance 192.168.153.165",
                "status": "success"
            },
            {
                "is_last": "false",
                "message": "Applied configuration on instance 192.168.153.165",
                "status": "success"
            },
            {
                "is_last": "false",
                "message": "Retrieved data for configuration audit on instance 192.168.153.165",
                "status": "success"
            },
            {
                "is_last": "false",
                "message": "Logged out from instance 192.168.153.165",
                "status": "success"
            },
            {
                "is_last": "true",
                "message": "Removed configpack.",
                "status": "completed"
            }
        ]
    }
}
删除操作可能在以下情况下失败:
  • 存在配置的 NetScaler 实例已关闭
  • NetScaler Console 无法访问 NetScaler 实例
  • 配置在 NetScaler 上不再可用
即使无法从 NetScaler 中删除配置,您也可以强制从 NetScaler Console 中删除配置。在这种情况下,需要手动恢复 NetScaler 配置。
要强制从 NetScaler Console 中删除配置,请将查询字符串“force=true”添加到 API:
DELETE https://<ADM-endpoint-name>/stylebook/nitro/v2/config/configpacks/<configpack-ID>?mode=async&force=true。