Deletes a preset tag.

In this example, the preset tag whose tag key is Environment and tag value is test is deleted.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DeleteTag

The operation that you want to perform. Set the value to DeleteTag.

Key String Yes Environment

The tag key.

If no tag value is associated with a tag key, you can specify the Key parameter without specifying the Value parameter to delete the tag key. Otherwise, specify both the Key and Value parameters to delete a preset tag.

RegionId String Yes cn-hangzhou

The region ID.

For more information about the region ID, see Endpoints.

Value String No test

The tag value.

For more information about common request parameters, see Common parameters.

Response parameters

Parameter Type Example Description
RequestId String 6E27F22C-EDA3-132E-A53F-77DE3BC2343D

The ID of the request.

Examples

Sample requests

https://tag.aliyuncs.com/?Action=DeleteTag
&RegionId=cn-hangzhou
&Key=Environment
&Value=test
&<Common request parameters>

Sample success responses

XML format

<DeleteTagResponse>
      <RequestId>6E27F22C-EDA3-132E-A53F-77DE3BC2343D</RequestId>
</DeleteTagResponse>

JSON format

{
    "RequestId": "6E27F22C-EDA3-132E-A53F-77DE3BC2343D"
}

Error codes

HTTP status code Error code Error message Description
403 WrongEndpoint Only the central endpoint supports the create and delete operation of meta tag. The error message returned because the specified endpoint is invalid. Use the endpoint hub. You can use only the endpoint hub to create or delete a preset tag.
404 MissingParameter.Key The Key must not be empty. The error message returned because the Key parameter is not specified.

For a list of error codes, visit the API Error Center.