Delete a Plug-in¶

Function¶

This API is used to delete plug-in instances.

URI¶

DELETE /v2/{project_id}/pools/{pool_name}/plugins/{template_name}

**Table 1** Path Parameters¶
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details, see Obtaining a Project ID and Name.
pool_name	Yes	String	Resource pool name.
template_name	Yes	String	Plug-in template name.

Request Parameters¶

None

Response Parameters¶

Status code: 200

**Table 2** Response body parameters¶
Parameter	Type	Description
apiVersion	String	API version. Options: v2
kind	String	Type of the plug-in instance.
metadata	PluginMetadata object	Metadata of the plug-in instance.
spec	PluginSpec object	Plug-in instance details.
status	PluginStatus object	Plug-in instance status.

**Table 3** PluginMetadata¶
Parameter	Type	Description
name	String	Name of the plug-in instance.
creationTimestamp	String	Creation time.

**Table 4** PluginSpec¶
Parameter	Type	Description
template	Template object	Template information of the plug-in instances.

**Table 5** Template¶
Parameter	Type	Description
name	String	Name of the plug-in template to be installed, for example, log-agent.
version	String	Version of the plug-in to be installed or upgraded.
inputs	Map<String,Object>	Plug-in template installation parameters (varying depending on the plug-in). During the plug-in upgrade, you need to specify all the installation parameters. If the parameters are not specified, the default values in the plug-in template are used. The current plug-in installation parameters can be obtained through the API for querying plug-in instances.

**Table 6** PluginStatus¶
Parameter	Type	Description
phase	String	Plug-in instance status. Options: Pending: The plug-in is being installed. Running: All of the plug-in instances are running. This specifies that the plug-in runs properly. Updating: The plug-in is being updated. Abnormal: The plug-in instances are abnormal and the plug-in cannot be used. You can click the status to view the failure cause. Deleting: The plug-in is being deleted.
version	String	Version of the plug-in instances.
reason	String	Details about the plug-in instance installation failure.
values	String	Installation parameters of the plug-in instances. The parameters vary depending on the plug-in.
resources	Array of PluginResources objects	Resources used by the plug-in instances.

**Table 7** PluginResources¶
Parameter	Type	Description
involvedObject	ObjectReference object	Resource objects referenced by the plug-in.
replicas	Integer	Number of replicas of the resource object.
limits	Map<String,String>	Limit on requested resources.
requests	Map<String,String>	Requested resources.

**Table 8** ObjectReference¶
Parameter	Type	Description
kind	String	API type of the resource object, for example, DaemonSet and Deployment.
apiVersion	String	API version of the resource object.
namespace	String	Namespace of the resource object.
name	String	Name of the resource object.
uid	String	Unique ID of the resource object.
resourceVersion	String	Current version of the resource object.

Status code: 400

**Table 9** Response body parameters¶
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.

Example Requests¶

This API is used to delete a plug-in.

DELETE https://{endpoint}/v2/{project_id}/pools/{pool_name}/plugins/{template_name}

{ }

Example Responses¶

Status code: 200

success

{
  "kind" : "Plugin",
  "apiVersion" : "v2",
  "metadata" : {
    "name" : "pool-4cd084d36f8bd3346036-node-local-dns",
    "creationTimestamp" : "2025-03-17T12:29:18Z"
  },
  "spec" : {
    "template" : {
      "name" : "node-local-dns",
      "version" : "1.6.36",
      "inputs" : {
        "custom" : {
          "enable_dnsconfig_admission" : true,
          "nameserver" : "135.0.0.1",
          "ndots" : "8",
          "search" : "1321"
        },
        "flavor" : {
          "description" : "High avaiable",
          "name" : "HA",
          "resources" : [ {
            "limitsCpu" : "250m",
            "limitsMem" : "512Mi",
            "name" : "node-local-dns-admission-controller",
            "replicas" : 2,
            "requestsCpu" : "250m",
            "requestsMem" : "512Mi"
          }, {
            "limitsCpu" : "500m",
            "limitsMem" : "512Mi",
            "name" : "node-local-dns-cache",
            "requestsCpu" : "25m",
            "requestsMem" : "5Mi"
          } ],
          "size" : "large"
        }
      }
    }
  },
  "status" : {
    "phase" : "Running",
    "version" : "1.6.36",
    "reason" : "Install complete"
  }
}

Status code: 400

Bad request

{
  "error_code" : "ModelArts.50004000",
  "error_msg" : "Bad request."
}

Status Codes¶

Status Code	Description
200	success
400	Bad request

Error Codes¶

See Error Codes.

last updated: 2025-08-26 08:17 UTC - commit: 1ba1873d960563c60759f67898a855d9ba3c3502