Deleting a Template

Function

This API is used to delete a template. A template used by jobs can also be deleted.

Authorization

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

• If you are using role/policy-based authorization, see the required permissions in Introduction.
• If you are using identity policy-based authorization, the following identity policy-based permissions are required.

  Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependency
  dli:template:delete	write	template *	-	-	-

URI

• URI format

  DELETE /v1.0/{project_id}/streaming/job-templates/{template_id}

• Parameter description

  Table 1 URI parameters

  Parameter	Mandatory	Type	Description
  project_id	Yes	String	Project ID, which is used for resource isolation. For details about how to obtain a project ID, see Obtaining a Project ID.
  template_id	Yes	String	Template ID.

Request Parameters

None

Response Parameters

• Parameter description

  Table 2 Response parameters

  Parameter	Mandatory	Type	Description
  is_success	No	Boolean	Indicates whether the response is successful. Value true indicates success.
  message	No	String	Message content.
  template	No	Object	Information about the template to be deleted. For details, see Table 3.

  Table 3 template parameters

  Parameter	Mandatory	Type	Description
  template_id	No	Long	Template ID.

Example Request

None

Example Response

{
    "is_success": "true",
    "message": "The template is successfully deleted.",
    "template": {
        "template_id": 2
    }
}

Status Codes

Table 4 describes status codes.

Error Codes

If an error occurs when this API is invoked, the system does not return the result similar to the preceding example, but returns the error code and error information. For details, see Error Codes.